RQM Linked Files column NOT displaying SCM file links
Link SCM-controlled files to other CLM artifacts for traceability
Linking test artifacts with Rational Team Concert files
Before you begin
- Configuration management must be enabled.
- Install Rational Team Concert client.
About this task
To create links from Rational Quality Manager Test Artifacts and files under Rational Team Concert source control, you need to select a global configuration context for the operation. The selected global configuration context must contain configurations with source and target artifacts.
Procedure
- In the Rational Team Concert client, open the Package Explorer view, select the file that you want to associate with your test artifact; right-click, then click Team > Add Related Artifacts.
- In the Select Relationship window, select the artifact from the list of supported relationships- Test Case, Test Script or Test Case Result, and click OK.
-
In the Artifact Link window, select the target artifacts and click OK. After you create a link, check in the file.
Note: This task can not be done through the Web client. Though you can view the links on the Web client.
- In the Rational Quality Manager application, you can view the new links under Linked Files. If you click the link, it will take you to the Rational Team Concert Web client to view the file. The Linked Files field is also available in the Test Script, Test Case Result, and Test Suite Result table views. You can see the linked files for each artifact resource in the tables. The file link is also visible in the Related Files section in the artifact editor's right sidebar.
Results
One answer
The link will only be visible in RQM if that link (which is stored in RTC) exists in the RTC stream that contributes to the current global configuration for your RQM web view.
So after you have created the link and checked it in to the RTC workspace, you will need to deliver the RTC change set that contains this new link to the RTC stream that participates in the global configuration.
Comments
I'm still having a problem the web browser is still not displaying the Linked Files
-
In the Package Explorer view, select a file; right-click, then click Team > Open Related Artifacts.
Note: In the Rational Team Concert Client for Microsoft Visual Studio IDE, in the Sandbox Explorer or Solution Explorer window, select a file; right-click, then click Open Related Artifacts…. In the Rational Team Concert Shell, in the Windows Explorer window, select a file; right-click, then click Rational Team Concert > Open Related Artifacts….
- In the Open Related Artifacts window, select the global configuration context.
- Select the artifact and click Open. The details of the related artifact are displayed in a web browser view.
-
To view other links that are associated with the target file, including incoming links from the original artifact, click the Links tab of the target file.
Note: Different types of artifacts can display different views and each application can have different ways to find related links.
<o:p> </o:p>
To confirm, you have delivered the change sets containing the added links to the RTC stream that is contributing to the global configuration you have selected when you created the links? Without doing that, those links are not yet part of the global configuration and therefore would not be visible in RQM. If you have delivered these change sets to that stream, then I suggest working with Support, because the function is working as documented for me.
Ok I found my mistake with not seeing the links in the Web Browser for RQM artifacts. I had the wrong Global Configuration selected.
Yes, the Related Files section should be displayed in the Test Case Results page, if there are any related files. So if you see the files in the linked files column, but do not see it in the Related Files section, that is a bug. I did some testing, and I actually saw the opposite problem ... it showed too many files in the Related Files section of some of the test case results. In particular, I had one file that linked to three test case results, and another file that only linked to one of those test case results. The Linked Files column information was correct, but the Related Files section of all three of those test cases showed both files as being linked, when actually only one of those files linked to both test cases. I've filed a defect for that.