UiPath Documentation
test-manager
latest
false
UiPath logo, featuring letters U and I in white

Test Manager user guide

Last updated Apr 27, 2026

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.

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

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.



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.

    • 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.



  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.
    • 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.


Working With Azure DevOps Integration

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

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 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.
  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 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.

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.

Following this synchronization, you can automate the test cases through Studio. Subsequently, if you execute your test cases using Orchestrator, 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.

Action

Description

Procedure

Edit

Edit your connection settings.

  1. Log in to the Test Manager as an administrator.
  2. Open your project.
  3. Click the Settings button to open Project Settings.
  4. In the Integration list, click an Azure DevOps connection to expand the panel.
  5. Click Edit to configure the connection.
  6. Click Save to confirm.

Delete

Delete the selected connection and its associated requirements.

  1. Log in to the Test Manager as an administrator.
  2. Open your project.
  3. Click the Settings button to open Project Settings.
  4. In the Integration list, click an Azure DevOps connection to expand the panel.
  5. Click Delete to remove the connection.
  6. Click Ok to confirm.

Related articles

Was this page helpful?

Connect

Need help? Support

Want to learn? UiPath Academy

Have questions? UiPath Forum

Stay updated