UiPath Documentation
test-manager
latest
false

Test Manager user guide

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

  • Azure DevOps account
  • Assign permissions to integrate with service hooks
  • Test Manager administrator account
  • UiPath® Test Manager Azure DevOps Extension
  • Azure 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

Create an Azure DevOps project with the Agile work item process to support agile planning and provide a target for work item synchronization with Test Manager.

  1. Log in to Azure DevOps.
  2. Select 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. Select Create.

Your project is added to your collection.

Configure an Azure DevOps Connection

Set up the connection between Test Manager and an Azure DevOps project by configuring the integration settings in both Test Manager and the UiPath® Azure DevOps Extension.

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.

Select 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. Select 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.
  1. Select 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. Select the plus icon plus button and select a New work item from the dropdown.
  3. Configure your work item and then select 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, select the Requirements breadcrumb element.
    Note:

    To synchronize work items created before the integration, open an individual item, select the Actions icon 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.

Manage Azure DevOps connections

Edit an Azure DevOps connection

Edit your connection settings.

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

Delete an Azure DevOps connection

Delete the selected connection and its associated requirements.

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

Related articles

Result

The Azure DevOps project is connected to Test Manager. Work items are synchronized as requirements, and defects created in Test Manager are synchronized back to Azure DevOps.

Was this page helpful?

Connect

Need help? Support

Want to learn? UiPath Academy

Have questions? UiPath Forum

Stay updated