Why can I not create a link from a DOORS object to a RTC or RQM artifact?

Authors: IntegrationsTroubleshootingTeam
Build basis: CLM 4.x, DOORS 9.3 and later

This page covers the basics and the pitfalls when trying to create an Open Services for Lifecycle Collaboration (OSLC) link from IBM Rational DOORS to Rational Quality Manager (RQM) or Rational Team Concert (RTC). This configuration uses backlinks which means when you create a link in DOORS, it writes to the artifact in RTC or RQM. The same happens if you create a link in RTC or RQM, that must write to DOORS. As the link information is stored in both tools, write access to both tools is required.

Initial assessment

Symptoms

• A link from RTC or RQM is not created. The effect is, when looking at a Work Item or a Test Case, the related DOORS requirement is not seen and no hover over is possible.
• A backlink from DOORS to RTC or RQM is not created. In this case, the link is there in RTC or RQM and the users in those tools can see the related requirement. However, the users in DOORS have no knowledge that the link exists. For example, they may not see the DOORS requirement is linked to a RTC Work Item or RQM Test Case.

Impact / Scope/Timing

This may impact all users. Or it may be specific to a user or data set.

Recommended data gathering and subsequent analysis steps

Note if there is any error given.

Check to see if the link is created in either tool.

Check if the link can be created from another object in DOORS.

Check if the link can be created to another artifact in RQM or RTC.

See if it works in the other direction - from RQM/RTC to DOORS.

See if it works from DOORS Web Access in Microsoft Internet Explorer.

As a last step, Fiddler can be useful to capture the http calls. Fiddler can be used from DOORS version 9.5.0.1 onwards.

To configure Fiddler, set two system environment variables:

proxy=8888@127.0.0.1

proxy_type=HTTP

If RQM or RTC are running in https mode, under Tools-Fiddler Options set it to Decrypt HTTPS Traffic. Then look for the GET/POST/PUT requests and any errors or anomalies.

Possible causes and solutions

Defects

There are some defects, particularly in early versions. See:

Using Rational Team Concert integration crashes Rational DOORS when Japanese Microsoft Office IME is used

CRCRW5065I error creating a link from Rational DOORS Web Access to Rational Team Concert

Data

If the issue is specific to a DOORS object or RQM/RTC artifact, check for characters in the title or description that might break it. For example, square brackets are known to break linking from DOORS to RQM in DOORS 9.5.0.1 and earlier.

Permissions

Check the user has write access to the object in DOORS and the artifact in RQM/RTC. In DOORS, the user must be able create an external link. In RQM/RTC, the user must be able create a link of the type selected (for example: implemented by; validated by). Permissions issues could also be temporary due to to locking. See:

Creating a collaboration link from Rational DOORS to Rational Team Concert results in "The object could not be created" error

Internet Explorer

Ensure the DOORS Client can find the Jazz server in Microsoft Internet Explorer. The DOORS client only runs on Windows, therefore Internet Explorer is always installed. DOORS is hardcoded to use Internet Explorer DLLs to load content from OSLC providers. As a result, Internet Explorer must work. If, for example, you wish to link DOORS and IBM Rational Team Concert (RTC), it must be possible to login to RTC from Internet Explorer. This is irrespective of whether Internet Explorer is the user's default or preferred browser. For DOORS to work with RTC, Internet Explorer must be able find RTC because if it cannot, neither can DOORS. It is also important to take note of any security messages and don't allow IE to block anything.

Creating link to Rational DOORS in RTC results in "Navigation to the webpage was cancelled" error

Related topics: Deployment web home, Deployment web home

External links:

• Integrate Rational Quality Manager with Rational DOORS using Open Services Lifecycle Collaboration
• Configure DOORS and Rational Team Concert for globally distributed workers
• Configuring Rational DOORS and Rational Team Concert to integrate with one another
• Integrating the Requirements Management application and Rational DOORS
• How to increase the Rational DOORS Web Access logging levels
• How to enable logging for DWA Interoperation server
• Fiddler
• IBM

Additional contributors: MaeveOReilly

Questions and comments:

Warning: Can't find topic Deployment.WhyCanINotCreateALinkFromADOORSObjectToARTCOrRQMArtifactComments