# Getting Started

## URL Linking Support

For information about how to create a base URL please refer to the jcl_cre_url userexit in the Userexit documentation.

URLs can be used to launch the Java client and display a specific Agile object. The URL points to a pre-defined privelege because the access rights for a specific record have to be checked before the data can be displayed.

Privileges are defined for the following masks (default):

- Items
- Documents (All Documents mask)
- Projects
- Work Orders
- Work Items (for linking from within Workflow emails)

### Create the URL

The URL linking support has to be added to the respective mask to be able to create the URL of this mask.

The URL can be created:

- From the main mask via the context menu
- By pressing Ctrl+u on the keyboard.

### Opent the URL

When opening the URL, a message is displayed from which the client can be launched in different ways:

- If the client is not running yet, a new client will be started and the URL parameter will be executed.
- If the client is running already, and does match the client name from the URL parameters, the URL will be directly executed on the running application.
- If the client is running already, but does not match the given client name from the URL, the user will be asked whether to start a new client and execute the URL, or execute the URL directly on the running client.