Azure DevOps

Extend your issue management in TestMonitor by integrating with Azure DevOps to quickly create work items.

When you use TestMonitor for your test management, you might want to assign issues to your team members in Azure DevOps as work items. The issues in TestMonitor include useful information that can help with resolving them. Instead of manually copying all this information from TestMonitor to DevOps, you can easily send it using an integration. 

By starting with TestMonitor, you’re able to take advantage of all of the information links and reports available in the system and then use the integration to support issue management. You’ll easily be able to trace back the link between TestMonitor issues and DevOps work items to track their progress. You can decide to send all or just a selection of issues to DevOps based on your team's needs.

Before you begin

To set up the integration with Azure DevOps, you will need an admin account for TestMonitor and a DevOps account that has permissions to create work items. You will also need to have at least one organization with a project in DevOps to send issues from TestMonitor. 

Configuring the DevOps Integration

Go to the Project Settings of the project you wish to set up an integration with.

Once you have opened the project settings page:

1. Head over to the Integrations section and click the Connect button for DevOps. You will need to approve the following permission requests:
   1. Grant full access to work items.
   2. Grant the ability to read projects and teams.
2. Log in to DevOps (or if you are already logged in TestMonitor connects automatically).
   1. Fill in your DevOps email address and password.
   2. Once authenticated, you'll be redirected back to TestMonitor.
3. Choose Configure in the DevOps panel.
4. Select an Organization.
5. Select the Project for which you wish to create TestMonitor issues as work items in DevOps.
6. Optionally, select a Team Project that should be used for your work items.
7. Select the Work Item Type that you want to use when creating a DevOps issue (e.g. bug, task, feature, or test case).
8. Decide whether you want issues to be sent automatically or manually.
   1. Automatically: Each time an issue is created in your project it will automatically be sent to your DevOps project as a work item.
   2. Manually: Every time you create an issue in your project, you will decide if it should be transferred to DevOps as a work item. After creation, the issue detail page will show a button allowing you to send it. 
9. Select Connect to complete the integration. When successful, the DevOps panel refers to your DevOps instance as connected.

Using the Integration

If you chose for issues to be sent to DevOps automatically during setup, no extra actions are required. Once you create an issue in TestMonitor, a work item will be created in DevOps with no other work on your part. 

If you chose the manual integration at setup, you will need to go to the issue detail page of each issue you want to create a work item in DevOps for. The issue detail page will show a Send to DevOps button at the top right. 

The following issue fields and data from TestMonitor will be sent to DevOps for each issue whether manually or automatically sent:

• Name
• Description
• Status
• Priority
• Category
• Assignee
• Attachments

When TestMonitor sends an issue to DevOps, the Issue Details page in TestMonitor will have a button to Open in DevOps. This allows you to open the issue as a work item in DevOps. In the same manner, when you view a work item description in DevOps, there is a link to the issue in TestMonitor. This makes it easy for you to switch between the two systems for any additional information you may need.

Disconnect the DevOps Integration

If the integration is no longer required or your project comes to an end you can easily disconnect the integration. 

To disconnect the integration:

1. Go to the Project Settings of the project you want to disconnect the integration from. 
2. Navigate to the Integrations section and click the Disconnect button for DevOps.
3. Click Disconnect to confirm.