Managing Requirements Traceability

Test cases often need to be linked to documents in external systems. A common use-case is to link a test case to its requirement specifications. We will now take two examples that will help you understand how to do this in Tuskr.

Jira

The first example is Jira. Let's say you have requirements created as user stories in a Jira project.

If the Jira subdomain of your company is and the project's key is , the URLs for these stories (issues in Jira) will be like https://abc.atlassian.net/browse/MPX-20 or https://abc.atlassian.net/browse/MPX-35. If we generalize, the URLs are in the format: https://abc.atlassian.net/browse/{issue-key}.

To associate these Jira issues to a test case in Tuskr:

  1. Edit the project and set the field to: https://abc.atlassian.net/browse/{id}. This field will be used to generate the links to Jira in test cases. .
  2. Next edit the test case and in the field type enter MPX-20 and MPX-35. .
  3. Click on the link. The test case panel will open and under the section, you should see MPX-20, MPX-35. Clicking on these will links will take you to their respective Jira pages.
Making references user-friendly

IDs can sometimes be difficult to relate to. A user-friendly text would be more useful. You can do this in Tuskr.

Instead of MPX-20 and MPX-35, you can enter a short description for each one in the format . Enter Home=MPX-20 and Search=MPX-35 in the field for TC-1. We have assumed that MPX-20 and MPX-35 refer to requirements of the home and search pages respectively.

Now, when you click on the link, the test case panel will open and under the section, you will see Home, Search instead.

Note that the description cannot have the symbol.

Confluence

The second example is Confluence. Let's say you have documents in Confluence and you want to tie them to test cases in Tuskr.

If the Confluence domain of your company is , the URLs for your pages will be like https://abc.atlassian.net/wiki/x/jRb139 or https://abc.atlassian.net/wiki/x/p013rt. If we generalize, a page url will be of the form: https://abc.atlassian.net/wiki/x/{page-id}.

To find the page URL, go to the page in your Confluence installation and then click ••• ▸ Advanced ▸ Page Information. Check the field in the resulting page.

To associate these Confluence pages to a test case TC-1 in Tuskr:

  1. Edit the project and set the field to: https://abc.atlassian.net/wiki/{id}. .
  2. Next edit the test case and in the field type enter Home=jRb139 and Search=p013rt. . Note that we have used the character to separate the text and page id.
  3. Click on the link. The test case panel will open and under the section, you will see Home, Search. Clicking on these will links will take you to their respective Confluence pages.