IBM Support

How to add requirement links to existing Test Cases

How To


Some Rational Quality Manager (RQM) users have built custom tools to automate creation of Test Artifacts. The content presented here is to help create references to requirement artifacts in Rational DOORS Next Generation (RDNG) while the Test Artifacts are being created using such automated tools.

If you are creating test cases with the details using REST API in RQM, you may come across a necessity to reference a requirement artifact while creating or updating. This can be achieved with the use of OSLC APIs as they are used for cross-application linking unlike the REST API, which is specific for the application.


Here are the manual steps you could follow to add the requirements link to the test artifact:

1. Get the OSLC link to the project by performing a GET on
For example: https://<HOST>:<PORT>/qm/oslc_qm/catalog (https://<HOST>:<PORT>/qm/oslc_qm/catalog)
2. Add /resources/ to the OSLC link of the project obtained in step (1)
For example: https://<HOST>:<PORT>/qm/oslc_qm/contexts/_-cHYcHL3EemS37WyeOZZ7w/resources/ (https://%3CHOST%3E:%3CPORT%3E/qm/oslc_qm/contexts/_-cHYcHL3EemS37WyeOZZ7w/resources/
3. Perform a GET on the link created in step (2) to get the OSLC link to the test case
4. Perform GET on the OSLC link of the Test Case obtained in step (3)
5. Add <oslc_qm:validatesRequirement rdf:resource="OSLC link to the RM artifact" /> in <oslc_qm:TestCase>....</oslc_qm:TestCase> block
6. Perform a PUT operation on the OSLC link of Test Case obtained in step (3) with the content edited in step (5).

You can use the preceding procedure and perform a POST with the XML data using OSLC API to automate the steps in your custom tool.

Additional Information

a. We recommend testing the procedure in a sandbox/testing environment before implementing on production.
b. The preceding operation is data intensive and hence could potentially bring the instance down. Hence, it would be good to test the steps in batches of say 20 - 50, instead of doing in large numbers depending on the load on the application and the database.

Document Location


[{"Business Unit":{"code":"BU055","label":"Cognitive Applications"},"Product":{"code":"SSR27Q","label":"Rational Quality Manager"},"Component":"","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"6.0.6;6.0.5","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Document Information

Modified date:
31 October 2019