Skip to main content

Linking Test Cases to Work Items and Test Folders

Link a Test Case version to a Jira work item or Test Folder, then start an execution against the selected requirement.

Link a Test Case to the Jira work item or Test Folder it will test, then start an execution against that requirement. This keeps the Test Case and its execution results connected to the work you are validating.

Before you begin

  • Open the Test Case you want to link and check the selected Version. Vansah links that Test Case version.

  • Make sure you can access the Test Case and destination Jira space.

  • You need permission to link or unlink Test Cases. Execution also requires the relevant Vansah execution permission.

  • To create a Jira work item during linking, you also need Jira permission to create that work item.

Link an existing Jira work item

  1. Open the Test Case and select Main.

  2. Expand Linked Work items.

  3. Use the space selector beside the search field if you need to search another Jira space.

  4. In Search Work items, enter the work item key or search text, then select the matching work item.

  5. Confirm that the key appears in the linked work item list.

Searching for an existing Jira work item to link to a Test Case

Create and link a Jira work item

  1. Under Linked Work items, select the plus button labeled Create and link a Work Item.

  2. Complete Jira’s create form, including the required fields.

  3. Create the work item, then confirm its key appears in the Test Case’s linked work item list.

Create and link a Work Item button beside the linked work item search

Link a Test Folder

  1. Open the Test Case’s Main tab.

  2. Find Linked Test Folders and click the plus button labeled Link Test Folder.

  3. Select the Jira space if needed, then choose the existing Test Folder or folders.

  4. Click Apply.

  5. Expand Linked Test Folders to confirm the saved links.

The links use the Test Case version selected when you apply the change.

Execute the linked Test Case

Linking associates the Test Case with the requirement. Start an execution separately to record results.

  1. Click the play icon beside the Test Case key.

  2. Choose the linked Jira work item or Test Folder as the execution target.

  3. Select Execute, then choose New Test Run to record a separate execution. Where Quick Test is enabled, you can select an available result instead.

  4. Complete any required Environment, Version, or Sprint values in Run Setup.

  5. Perform the test and record the step results, actual outcomes, and evidence.

You can also open the linked work item or folder and execute the case from its Test Cases list.

Check the result

Open Test Runs for the Test Case and confirm the execution is associated with the intended work item or folder. A Test Case can be reused across requirements, so check the context when comparing outcomes.

See Understanding and Viewing Test Runs for help finding an execution.

If linking or execution is unavailable

  • Check the selected Test Case version, destination Jira space, and your access permissions.

  • If a work item is missing from search, check its key and the selected Jira space.

  • Confirm that the Test Case is linked to the target and is not blocked.

  • If the folder selection has not appeared, confirm that you clicked Apply and that the save completed.

Related guides

Did this answer your question?