# Azure DevOps

> Integrate Azure DevOps to Test Manager to support your test management efforts, agile planning, or defect tracking. Through this integration, you can synchronize your work items to Test Manager.

Integrate Azure DevOps to Test Manager to support your test management efforts, agile planning, or defect tracking. Through this integration, you can synchronize your work items to Test Manager.

To connect your Test Manager instance to an Azure DevOps project:

1. Create a Project in Azure DevOps
2. Configure an Azure DevOps Connection

## Prerequisites

* Azure DevOps account
* [Assign permissions to integrate with service hooks](https://docs.microsoft.com/en-us/azure/devops/service-hooks/overview?view=azure-devops#q-what-permissions-do-i-need-to-set-up-a-subscription)
* Test Manager administrator account
* [UiPath® Test Manager Azure DevOps Extension](https://marketplace.visualstudio.com/items?itemName=uipath.tmh-connector)
* [Azure Test Plans](https://azure.microsoft.com/en-us/products/devops/test-plans/) - to sync test items with your Test Manager. Make sure to validate the integration scenario thoroughly. Consider the following limitations:
   * Assertions cannot be synchronized.
   * Test Executions cannot be set to status **Completed**, since they get locked in Azure DevOps, for results to be synchronized in parallel.
   * The scope of projects in Test Manager and Azure DevOps is substantially different and, therefore, requires detailed planning of object routing.

## Create a Project in Azure DevOps

1. Log in to Azure DevOps.
2. Click **Create new project** and configure your project settings:
   * **Project name**: Enter a name for your project.
   * **Description**: Add a description to help you easily identify the use of each project.
   * **Version control**: Choose your version control.
   * **Work item process**: Select **Agile** from the dropdown as your default process to support your Agile planning methods, including development and test activities.
3. Click **Create**.

Your project is added to your collection.

   ![docs image](https://dev-assets.cms.uipath.com/assets/images/test-manager/test-manager-docs-image-125618-c16eb64d-0e6e33e5.webp)

## Configure an Azure DevOps Connection

**Prerequisites**: To save the UiPath® Test Manager extension on Azure DevOps, you must be an Azure **Administrator** user.
1. Log in to Test Manager as an administrator.
2. Open your project.
3. Navigate to **Project Settings** > **Integration**.
4. Click **New Connection** and select **Azure DevOps** from the dropdown.
5. Configure the following connection settings:
   * **Name**: Enter a name for your Azure DevOps connection.
   * **Description** (Optional): Add a description for reference.
   * **Server URL**: Add the Azure Dev Ops server URL. For example: `https://company-name-serverRegion.cloudapp.azure.com`.
   * **Personal Access Token**: Create a PAT and paste it into this field to authorize Test Manager to perform actions.
     :::warning
     When you create the Azure DevOps connection, the PAT needs to have full access to Azure DevOps services. To do this, select **Full access** under **Scopes**, when you create or edit a PAT. After the connection is finished, you can reduce the PAT scopes to : **Test Management** - `Read & Write`, and **Work Items** - `Read & Write`. For more information, see [Use personal access tokens](https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate?view=azure-devops&tabs=Windows).
     :::
   * **Defect Type**: Enter an object type used for bug reporting in Azure DevOps. Otherwise, leave empty if you do not want to use defect integration.

Enter a defect type based on what object type you have selected for your newly created Azure DevOps project. For example: `Bug` or `Issue`.
   * **Project Name**: Enter your Azure DevOps project name.

   ![docs image](https://dev-assets.cms.uipath.com/assets/images/test-manager/test-manager-docs-image-126414-52c9b34e-5c8fa29a.webp)
6. Click the connection to expand the panel and copy the **API Key** for later use.
7. Open your project in Azure Dev Ops and go to **Project settings**.
8. Under **Extensions**, go to **UiPath® Test Manager**.
9. Configure the following extension settings:
   * **Requirement Types**: Select the types of objects you want to assign a test to. These will show up as requirements in Test Manager. For more information, see [Requirements](https://docs.uipath.com/test-manager/automation-cloud/latest/user-guide/requirements).
   * **Server URL**: Add the Test Manager URL. The URL should have the following format: https://cloud.uipath.com/{organizationName}/{tenantName}/testmanager_.
   * **API**: Paste the API key.
   * **Manage Tests with Azure DevOps**: Select this option to manage your tests through Azure DevOps. Otherwise, leave this option off, to manage your tests through Test Manager.
10. Click **Save**.

    ![docs image](https://dev-assets.cms.uipath.com/assets/images/test-manager/test-manager-docs-image-126380-9a1f9564-3bd1126a.webp)

Working With Azure DevOps Integration

To take a look at how the integration works, consider the following examples:

* [Synchronizing Work Items](https://docs.uipath.com/test-manager/automation-cloud/latest/user-guide/connecting-an-azure-devops-project#azure-devops)
* [Managing Tests via Azure DevOps](https://docs.uipath.com/test-manager/automation-cloud/latest/user-guide/connecting-an-azure-devops-project#azure-devops)

## Synchronizing Work Items

You can create work items (e.g. Epic) in Azure DevOps and synchronize them with Test Manager. The work items will show up on the **Requirements** page.

1. Log in to Azure DevOps and open your project.
2. Click the ![docs image](https://dev-assets.cms.uipath.com/assets/images/test-manager/test-manager-docs-image-blue-add-c1535f86-90f0a81e.png) plus button and select a **New work item** from the dropdown.
3. Configure your work item and then click **Save & Close**. For more information, see [Add and update a work item](https://docs.microsoft.com/en-us/azure/devops/boards/backlogs/add-work-items?view=azure-devops&tabs=browser).
4. Log in to Test Manager and go to **Requirements** to view the synchronized work item. To refresh the page, click the **Requirements** breadcrumb element.
   :::note
   To synchronize work items created before the integration, open an individual item, click the ![docs image](https://dev-assets.cms.uipath.com/assets/images/test-manager/test-manager-docs-image-actions-icon-fd15ea98-d13395fe.png) **Actions** button, and select **Push to Test Manager** from the dropdown.
   :::

## Managing Tests Via Azure DevOps

You can use Test Cloud for test automation and Azure DevOps for test management. To use both solutions together, first you need to select **Manage Tests with Azure DevOps** in the integration configuration. For more information, see [Configure an Azure DevOps Connection](https://docs.uipath.com/test-manager/automation-cloud/latest/user-guide/connecting-an-azure-devops-project#configure-an-azure-devops-connection).

Now, you can manage the tests by pushing test cases from Azure DevOps to Test Manager. In other words, any Azure work item of type Test Case is going to be pushed to Test Manager. Make sure to add test cases to your Azure test plans, as this is where the results are going to be pushed to. For more information, see [Create test plans and test suites](https://docs.microsoft.com/en-us/azure/devops/test/create-a-test-plan?view=azure-devops).

Following this synchronization, you can automate the test cases through Studio. Subsequently, if you [execute your test cases using Orchestrator](https://docs.uipath.com/orchestrator/automation-cloud/latest/user-guide/test-executions), the results are pushed to your Azure test plans.

Managing Azure DevOps Connections

The following table lists the actions that you can take to manage your Azure DevOps connections.

 <colgroup>
  <col/>
  <col/>
  <col/>
 </colgroup>
 
  
     Action  
     Description  
     Procedure  
  
 
 
  
    Edit 
     Edit your connection settings.  
   
      
         Log in to the Test Manager as an administrator. 
         Open your project. 
         Click the Settings button to open Project Settings. 
         In the Integration list, click an Azure DevOps connection to expand the panel. 
         Click Edit to configure the connection. 
         Click Save to confirm. 
      

  
  
    Delete 
     Delete the selected connection and its associated requirements.  
   
      
         Log in to the Test Manager as an administrator. 
         Open your project. 
         Click the Settings button to open Project Settings. 
         In the Integration list, click an Azure DevOps connection to expand the panel. 
         Click Delete to remove the connection. 
         Click Ok to confirm. 
      

  
 

Related articles

[Defect synchronization](https://docs.uipath.com/test-manager/automation-cloud/latest/user-guide/defect-synchronization#defect-synchronization)