projectdoc Toolbox

Describes how the system calculates the URI to an information system based on its identifier.

The system identifier is checked at three locations

 

Typically do not change the system identifier provided by the macro (if one is specified). Keep the default value of '${system-id}' as long as you do not need to reference multiple server of the same type in one space. Then set the space property to reference the specific server accordingly. This makes it easier to create new links to artifacts since the system identifier need not to be changed.

The search for the system connection information is conducted as follows. Use the URI discovered first to connect to the server.

  1. Check for a space property url-${system-id}
  2. Check for a space property ${system-id}
    Only available with projectdoc Toolbox version 1.11 and up!
  3. Check for a space property shortcut-id-${system-id}.
    Lookup the connection information from the shortcut links with the value retrieved from the space property.
  4. Check the shortcut links for a value ${system-id}.
  5. Check application navigator for a value ${system-id}.

If no value is specified at any of the locations above, the macro renders an error message like this:

In this example for a system macro the referenced, but undefined system, is called test-repo.