Mapping link types to URIs for external applications

You can map link types to Uniform Resource Identifiers (URI) to create a consistent OSLC representation for links across all modules that are available for integration with external applications, such as Rational Engineering Lifecycle Management, Rational Insight, and applications that are integrated with IBM® Rational® DOORS® by using OSLC.

About this task

Link types that are used in multiple modules have unique identifiers in those modules, even if the links have the same name in each module. As a result, external applications might treat a link type with multiple unique identifiers as different types. For example, in Rational Insight, this treatment prevents consistent reporting of links across modules.

You can map a link module to a single URI to provide a consistent representation for link types that have the same name but that are in different modules. This mapping enables external applications to recognize and report on equivalent links across modules.

To report on links between objects in two different modules, both modules must be included in the working set.

Procedure

  1. In theIBM Rational DOORS client, click File > Mappings. The Attribute and Linking Mapping window opens.
  2. At the Links page, click Add.
  3. In the Database Explorer pane, expand projects and folders, select a link module, and click Add.
  4. When your list of link modules is complete, click OK.
  5. At the Mapped Link Types list, do one of the following actions:
    • Select a link module and click Edit. Enter a URI in the Update URI window and click OK.
    • Click Suggest to assign suggested URIs to the following entries:
      • Link modules that do not have a mapped URI
      • Selected link modules
      • All link modules
      To assign suggested URIs to link modules, you must first enter a default namespace on the General tab of the Attribute and Link Mapping window. You can edit suggested URIs after they are entered.
  6. Click OK or Apply to save the mapping.

What to do next

If you create or edit URI mappings and you are ready to make the mappings available to the external applications, you must publish your updates on the General tab of the Attribute and Link Mapping window. This can require a full reload of data in external applications, such as Rational Insight, so you should aggregate and apply multiple mapping changes with careful use of the Publish button.

On the General tab, you can also specify a default link type URI that is assigned to all link types that are not mapped on the Links tab.


Feedback