Azure DevOps Work Items

Azure DevOps Work Items is the work-management integration between Azure DevOps and Allure TestOps. It covers:

• browsing and linking Azure DevOps work items from TestOps;
• configuring issue mapping so test metadata becomes work-item links in TestOps automatically;
• linking work items to test cases, launches, and defects.

If you need CI pipeline execution rather than work-item linking, see Azure DevOps CI.

Before you begin

• The Azure DevOps organization URL, for example https://dev.azure.com/your-organization.
• Access to create a personal access token in Azure DevOps.
• The Azure DevOps project whose work items TestOps should see.
• Permission to add global integrations in TestOps and to enable them in the target project.

1. Add the global Azure DevOps integration

An instance administrator should:

1. Open Administration → Integrations in TestOps.
2. Click + Add integration.
3. Select Azure DevOps Server.
4. Enter a stable name for the integration and the Azure DevOps organization URL, for example https://dev.azure.com/your-organization.
5. Click Add integration.

2. Create the Azure DevOps personal access token

1. In Azure DevOps, click the User settings icon and select Personal access tokens.

2. Click New Token.

3. Fill in the fields:

   • Name — a recognizable name, for example Token for Allure TestOps.
   • Organization — the Azure DevOps organization that contains the project.
   • Expiration — how long the token should stay valid.
   • Scopes — select Custom defined, then click Show all scopes at the bottom.

4. Under the scopes list, enable:

   • Work Items → Read, write, & manage

5. Click Create and copy the generated token. Save it in a secure location.

3. Enable the integration in the project

1. In TestOps, open the target project and go to Settings → Integrations.
2. Find the Azure DevOps integration and click Add integration.
3. Enter the Azure DevOps sign-in email and the token from step 2.
4. Click Test connection. If the credentials are correct, a "Connection established" message appears.
5. Click Add integration.

4. Configure issue mapping for automatic links

If your tests already emit issue labels through an Allure adapter, configure an issue mapping so TestOps can turn those labels into real work-item links automatically.

1. Open the TestOps project.

2. Go to Settings → Issues.

3. Click + Create.

4. Fill in the fields:

   • Key — the short identifier your tests use in metadata.
   • Issue tracker — the Azure DevOps integration you enabled for the project.

5. Save the issue mapping.

5. Add issue links

Once the integration is set up, you can link test cases and launches to Azure DevOps work items manually.

To link a test case:

1. Go to Test cases and open the test case.
2. Click the pencil icon next to Issue links.
3. Click + Add.
4. Under Issue tracker, select your Azure DevOps integration.
5. Under Key, enter part of the work item title and select it from the list.
6. Click Submit.

To link a launch:

1. Go to Launches.
2. Click ⋯ next to the launch and select Edit.
3. In the Issues section, click + Add.
4. Under Issue tracker, select your Azure DevOps integration.
5. Under Key, enter part of the work item title and select it from the list.
6. Click Submit.

Verify the integration

1. Open a test case in TestOps and add a work item link.
2. Confirm that the issue picker can search the expected Azure DevOps project.
3. Open a launch and add or edit a work item link there as well.
4. If your team uses defect export, create or link a defect to confirm that the Azure DevOps work item workflow is available in that view too.

Troubleshooting

The issue picker does not show the work items you need

Check these points:

• The project integration uses valid credentials (email and token).
• The token includes the Work Items → Read, write, & manage scope.
• The Azure DevOps account behind the token can access the target project.

The integration works for CI but not for work items

The CI token was created without the Work Items scope. Add that scope to the existing token or create a separate token with Work Items → Read, write, & manage and update the project integration.

Related pages

• Azure DevOps CI for pipeline upload and triggered runs.
• Links, issues, and relations for how issue links appear in TestOps.
• Defects for defect-to-issue workflows.