Azure DevOps Integration

Create links and track issues.

Azure DevOps is a Microsoft product that provides project management, reporting, requirements management, testing and release management capabilities.

Functionality overview

DevOps integration lets you create Work Items from TestMonitor issues. Each Work Item contains the TestMonitor issue name, description, status, impact, category, impact, and assignee. Work Items include attachments, as well.

When TestMonitor sends an issue to DevOps, a link back to TestMonitor is included. That link lets you check issue progress. 

Setup requirements

  • You must have a TestMonitor administrator account.
  • You must have a DevOps account (with permissions to create Work Items).

Installation and configuration

Configuring your DevOps environment

Before you can run the integration, you need at least one organization with a project in DevOps.

Configuring the integration

After you create a DevOps project, start TestMonitor integration. There are two DevOps integration options.

From the TestMonitor dashboard header:

  • In the top right corner of the dashboard, click the project selector next to the bell.

  • Select a project on the drop-down menu.

  • Click the project selector again and then click Project settings.

  • On the project Details page, click Integrations on the left menu.

  • Click the Connect button on the DevOps panel.

From the TestMonitor Settings page:

  • Click the Cog in the header. The Settings page displays.

  • On the left menu, click Projects.

  • Click the project you want to connect to DevOps. 

  • On the project Details page, click Integrations on the left menu.

  • Click the Connect button on the DevOps panel.

integrations-1

When you click the Connect button, you need to accept the request for permissions:
  • Grant full access to work items.
  • Grant the ability to read projects and teams.
After you accept, sign in to DevOps with your email address. If you are already signed in, TestMonitor connects automatically. After you sign in, the DevOps Configure button displays.

configure-devops

Click Configure and then fill in the following fields:
  • Organizations: Select an organization.

  • Project: The name of the DevOps project that you want to connect to.

  • Work Item Type: Select the type that you want to use when creating a DevOps issue (e.g. bug, task, feature or test case).

  • Automatic / manual: Automatic sends every issue to DevOps. Manual allows you to pick issues individually. 

devops-configuration

Click Save. When successful, the DevOps panel refers to your DevOps instance as connected.

Using the integration

If you choose automatic, TestMonitor sends all new issues to DevOps. You can view them in the DevOps Work Items overview. Each work item contains the TestMonitor issue name, description, status, impact, category, impact, assignee, and attachments. 
If you choose manual, you must go to the Details page of an issue and then click Send to DevOps button. The issue is now in the DevOps Work Items overview. 

issue-to-devops

When TestMonitor sends an issue to DevOps, the work item description contains a link to the issue in TestMonitor.

To view the issue in DevOps, go to the Issue Details page in TestMonitor and then select Open in DevOps.

Uninstalling the integration

There are two ways to uninstall DevOps integration.

From the TestMonitor dashboard header:

  • In the top right corner of the dashboard, click the project selector next to the bell.

  • On the drop-down menu, select the project with the integration.

  • Click the project selector again and then click Project settings.

  • On the project Details page, click Integrations on the left menu.

  • Click the Disconnect button on the DevOps panel and then Delete to confirm.

From the TestMonitor Settings page:

  • Click the Cog in the header. The Settings page displays.

  • On the left menu, click Projects.

  • Click the project with the integration you want to disconnect. 

  • On the project Details page, click Integrations on the left menu.

  • Click the Disconnect button on the DevOps panel and then Delete to confirm.

 disconnect-devops


When uninstalling the integration, links between the TestMonitor issues and DevOps work items are removed as well. This cannot be undone.

Frequently asked questions

When I update the DevOps bug status, is the TestMonitor issue status updated as well?

Right now, TestMonitor doesn’t poll DevOps for any changes. 
 

I am unable to connect to my DevOps installation. What should I do?

If you are unable to connect to DevOps please check the following:
  • Did you accept the request to grant full access to work items and the ability to read projects and teams?

  • Did you set up an organization and project in DevOps to connect with?



Can I set up different DevOps instances for each project?

You can use a different DevOps organization or project for each project in TestMonitor.