Task Linking Configuration

This section documents the steps required to configure Task Linking.

To initially configure your OSLC Adapter, complete the following steps:

  1. Start Tasktop Sync.
  2. Edit the OSLC properties file within Tasktop Sync. (You can open this file by right-clicking on OSLC Linking in the Services view and selecting “Properties”.)

Next, start testing your configuration. Start, stop, and restart the web container using the drop-down menu under the web globe icon in the Tasktop Sync toolbar.

Once you are happy with your configuration, you can set the enabled property to true so that Task Linking will start automatically.

Authentication Note: In the unauthenticated mode ( disableAuthentication=true), Task Linking will be open to any traffic and is unauthenticated. It is recommended that you not use this mode in production or on any network that is open to the public. However, it can be useful for testing and initial configuration in a secure network environment.

In the authenticated mode ( disableAuthentication=false), Task Linking will present a login form to users and require that they authenticate using a username and password for one of the configured task repositories on the Tasktop Sync server. It is recommended that you run the service in this mode. The oslcAdapter.authenticationRepositories configuration field specifies which task repositories are used for authentication. If unspecified, Tasktop Sync will attempt to authenticate against all task repositories that are configured in the Tasktop Sync server until one validates.

IBM Rational Team Concert Change Configuration Management (Change and Configuration Management) Configuration

Configure the Task Linking Server Relationship

To add Task Linking as a service that provides links to related tasks, complete the following steps:

Navigate to the Jazz Team Server Administration Home:
Rational Team Concert Server Administration page

Click on Application under Change and Configuration Management to get to the Change and Configuration Management page:
Rational Team Concert Status Summary page

Click on Friends (Outbound) section in the left sidebar. When the Friends page appears, click Add and complete the form using values from your oslc.properties file. These values must match the values in the oslc.properties file exactly.
Rational Team Concert Add Friend page empty

The filled-in form will look something like this:
Rational Team Concert Add Friend page filled in

Click on the Create Friend button, and you will get confirmation that the service has been registered as a Friend:
Rational Team Concert friend created confirmation message

Click on the Next button, and you will get a dialog which should confirm that the friend was created with a provisional 32-character hex key:
Rational Team Concert Authorize Provisional Key page

Click on the Finish button, and you will see the Tasktop OSLC Adapter service show up in the Friends List:
Rational Team Concert friends list

Configure the IBM Rational Team Concert Change and Configuration Management Project Area

For each Project Area where you wish to enable the consumption of remote tasks using Task Linking, complete the following steps:

Navigate to the Project Area Administration Page on the top tab bar, then navigate to a project area:
Rational Team Concert Project Area editor

Navigate to the bottom section, Associations:
Rational Team Concert Project Area associations section

Click on Add... at the right of the Associations header bar:
Rational Team Concert Add Association dialog

Select an Application: “Tasktop OSLC Adapter” or whatever you named your server on the Friends page.

Rational Team Concert select association drop-down

Select the desired Association (e.g. Provides - Related Change Requests) and the desired source Artifact Container (e.g. HPE ALM). The Artifact Container is where your remote task will be sourced from. The available Artifact Containers are the Task Repositories that are configured in Tasktop Sync.

Rational Team Concert Artifact Containers list

Click on OK, then click the Save button.

Linking a IBM Rational Team Concert Change and Configuration Management Task to a Remote Artifact

To link a remote task to an IBM Rational Team Concert Change and Configuration Management task, complete the following steps:

Open a task (create one if you need to).

Navigate to the task’s Links tab and select Related Change Request or another association name from the drop-down menu:

Rational Team Concert work item editor Links section

You might get a dialog which asks about secure content. Make sure that you allow mixed secure and non-secure content to be displayed.

Enter a search term and press Search.

Select a search result you would like to link to.

Task Picker

Press OK.

Save the task.

You can now see a small preview of the task by hovering over the link:

Task preview hover

You can see more detail by clicking the See more link:

Expanded task preview hover

You can click on the hyperlinked task ID in the ID field to open the target task in a new browser.

IBM Rational Team Concert Requirements Management (Rational DOORS Next Gen) Configuration

Configure the Task Linking Server Relationship

To add Task Linking as a service that provides links to related tasks, complete the following steps:

Navigate to the Jazz Team Server Administration Home:
Rational DOORS Next Gen Server Administration Home page

Click on Jazz Team Server - Server Administration under Manage the Servers, and you will get to the Server Administration page:
Rational DOORS Next Gen server administration selection

Click on Friends (Outbound) section in the left sidebar. When the Friends page appears, click Add and complete the form using values from your oslc.properties file. These values much match the values in the oslc.properties file exactly.
Rational DOORS Next Gen friends

The filled-in form will look something like this:
Rational DOORS Next Gen Add Friend dialog

Click on the Finish button, and you will get confirmation that the service has been registered as a Friend.

Click on the Create Friend button, and you will get a dialog which should confirm that the friend was created with a provisional 32-character hex key:

Click on Finish, and you will see the Tasktop Sync service show up in the Friends List:
Rational DOORS Next Gen friends list

Configure the IBM Rational Team Concert Rational DOORS Next Gen Project Area

For each Project Area where you wish to enable the consumption of remote tasks using Task Linking, complete the following steps:

Navigate to the Project Area Administration Page on the top tab bar, then navigate to a project area:
Rational DOORS Next Gen Active Project Areas page

Navigate to the bottom section, Associations:
Associations section

Click on Add... at the right of the Associations header bar:
Rational DOORS Next Gen Add Association dialog

Select an Application: “Tasktop OSLC Adapter” or whatever you named your server on the Friends page.

Select OSLC Adapter

Select the desired Association (e.g. Provides - Related Change Requests), and the desired source Artifact Container (e.g. HPE ALM). The Artifact Container is where your remote task will be sourced from. The available Artifact Containers are the Task Repositories that are configured in Tasktop Sync.

Association selection

Click on OK, then click the Save button.