Skip to main content

Create an Azure DevOps integration

This document shows you how to create an integration for Azure DevOps within Katalon TestOps.

To set up the integration, the Account Admin must first connect ADO (Azure DevOps) to TestOps.

Create an integration with Azure DevOps to improve test automation efficiency, centralize test management, and strengthen DevOps workflows.

Prerequisites


Connect to Azure DevOps

To create a connection:

  1. Go to Admin > System > System Integrations. The Integration list appears.
  2. Click + Create Integration.

The System Integrations page in Katalon TestOps with Create Integration highlighted.
  1. Select Azure DevOps from within the ALM and Test management section. This brings you to the Azure DevOps Integration Setup page.

The Azure DevOps integration in Katalon TestOps.
  1. Input your credentials.
  2. Click the Test Connection to check your credentials. If successful, you'll see a confirmation message.

The Azure DevOps integration connecting successfully in Katalon TestOps.
  1. Click Save. A notification confirms you have successfully created the integration successfully. You are brought back to the Integration list where your new integration appears.

Configure an Azure DevOps integration

This section shows you how to customize and configure your Azure DevOps integration.

Prerequisites

  • You must possess the Project Admin role to perform this action. Go to roles or permissions for more information or learn how to assign a Project Admin here.
  • You must have connected Azure DevOps to TestOps as shown above.
  • Ensure you have access to your Azure DevOps project and possess a clear understanding of ADO Objects.

  1. Go to Settings > Integrations. The Integration list appears.

The project integration settings in Katalon TestOps.
  1. Navigate to the ALM & Test Management section.
  2. Click on New configuration to access a particular integration's configuration page. It's represented by a cog icon in the rightmost column of the list.
    • Optional: To edit an existing project, click the Edit (pen) icon, make the necessary changes, and click Proceed.

Step 1: Select the Project and Team

This section allows you to define the ADO project's most basic parameters.

  1. Select the ADO Project to link from the dropdown list. This defines which work items will be synced to Katalon TestOps.

  2. Optional: Select a team to link to enhance collaboration.

  3. Optional: Enter a description to differentiate this specific configuration from others.

Step 2: Additional integration settings

This section allows you to tailor the synchronization between Katalon TestOps and Azure DevOps to fit your workflow, ensuring seamless traceability between test cases, requirements, and bugs.

  1. Tick on Pull Requirements (enable generation of test cases from requirements and links requirements with test cases for traceability) to enable this feature.

  2. Tick on Bug Mapping (Pull bugs from ADO) to enable this feature.

Ticking on either feature will enable/disable the corresponding section in the next steps.


The Azure DevOps integration configuration page in Katalon TestOps.

The Azure DevOps integration configuration page in Katalon TestOps, showing steps 1 and 2.


Step 3: Map Iteration Path to Release and Sprint

This section allows you to choose the iteration path to map to a Release and Sprint in TestOps. Based on your selected project and mapped iteration paths, TestOps will generate release and sprints accordingly.

Here, you can toggle the Full path option--the complete hierarchical path of an item--to ensure that resources and items are clearly and unambiguously identified.


The Azure DevOps integration iteration path in Katalon TestOps.

The Full Path toggle.


  1. Select the Release from the dropdown list and the corresponding iteration path.

  2. Select the Sprint from the dropdown list and choose the corresponding iteration path or choose From ADO - Team Board.

note
  • By default, the Tiers refer to work item hierarchies, where Tier 1 is an Epic, Tier 2 is a Feature, Tier 3 is a User Story, and Tier 4 is a Task. This may vary depending on your project's configuration.

Step 4: Common fields and Values Mapping

This section allows you to map priority for effective issue prioritization and resource allocation, ensuring clear prioritization based on urgency (e.g., High, Medium, Low). Consistent mapping helps maintain workflow efficiency and prevents misalignment that could lead to inefficiencies.

  1. Map ADO Priority levels 1 to 4 to your chosen TestOps Priority levels based on your workflow.

The Azure DevOps integration iteration path in Katalon TestOps.

The configuration page showing steps 3 and 4.


Step 5: Requirement Fields and Values Mapping

This section allows you to select up to three date fields to set the Release Date, with the system using the first available date in your order of selection. You can also set an ADO State's equivalent TestOps Status.

  1. Optional: Select up to three date fields to set the Release Date.

  2. Select the TestOps Status that corresponds to the ADO State.

  3. Select Work Item Types to be synced.

Step 6: Bug Fields and Values Mapping

This section allows you to map the fields and values of bugs to the corresponding fields and values in Katalon TestOps.

  1. Map ADO Severity levels to your chosen TestOps Priority levels based on your workflow.

  2. Map ADO States to your chosen TestOps Status.

  3. Click on Proceed or Save to finalize your configuration.

    • If the status initially shows as Inactive, reload the page to update the status to Active.

The Azure DevOps integration fields and values mapping in Katalon TestOps.

The configuration page showing steps 5 and 6.


Results

A notification appears to confirm that the configuration has been saved successfully. Your connection is successfully established and ready to use.

Was this page helpful?