Configuring an integration provider for Rational Team Concert™

By adding the Rational® Team Concert server as an integration provider, you can automatically import work items into IBM® UrbanCode Release change items.

About this task

Importing a large number of work items from Rational Team Concert can take a significant amount of time. When IBM UrbanCode Release polls Rational Team Concert to import work items, only items that have been modified are imported. For this reason, the first time the import process runs, it can take a long time if there are a large number of work items to import. Subsequent import processes can take significantly less time. By default, a maximum of 1,000 work items are returned by a Rational Team Concert query.

Procedure

  1. In IBM UrbanCode Release, click Integrations > Add New. The New Integration Provider window opens.
  2. Type a name for the integration provider in the Name field.
  3. In the Integration list, select RTC.
  4. In the Frequency list, select a frequency. The frequency determines how often Rational Team Concert is polled for changes to import. Also, you can manually update changes at any time.
  5. In RTC Provider URL, type the root URL of the Rational Team Concert server. For example, http://jazz_server.example.com:port_number/ccm/. The default port number is 9443.
  6. In the Consumer Key and Consumer Secret fields, type a consumer key and secret. You set up consumer keys on the Rational Team Concert server. To learn more about configuring OAuth in Rational Team Concert, see Configuring OAuth consumers. The functional user ID that you set up in Rational Team Concert must have access to the project area that you want to access. If the functional user ID in Rational Team Concert does not have access to the project area, an error message is displayed when you attempt to connect.
  7. Click Connect. If the connection attempt is successful, the status icon is displayed in green and a list of project areas is displayed.
  8. Map the values from Rational Team Concert to values in IBM UrbanCode Release. Each work item that is retrieved from Rational Team Concert is associated with a release and an application in IBM UrbanCode Release based on the mappings.
    Note: If you edit an integration provider, note that when you open the integration provider page, the Planned For and Filed Against columns are set to Unassigned. To see an existing mapping, select the appropriate Planned For or Filed Against value.
    1. Under Mapping, select a Rational Team Concert project area from the list, and then select a query. To learn more about queries in Rational Team Concert, see Finding work items in the web client.
    2. Under Releases Mapping, select a release in IBM UrbanCode Release and select a Rational Team Concert Planned For value to map to the release.
    3. Under Applications, select an application in IBM UrbanCode Release and select a Rational Team Concert Filed Against value to map to the application.
    4. Under Statuses, for each status in the selected Rational Team Concert project area, select a corresponding status in IBM UrbanCode Release.

Results

The Rational Team Concert server is polled based on the frequency value. The results of the query are stored as change items in IBM UrbanCode Release. You can see items that are imported from Rational Team Concert on the Releases page and Changes page in IBM UrbanCode Release.

Feedback