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
- You must possess the Account Admin or System Admin role to perform this action. Go to Roles or Permissions for more information or learn how to assign an Account Admin here.
Connect to Azure DevOps
To create a connection:
- Go to Admin > System > System Integrations. The Integration list appears.
- Click + Create Integration.

- Select Azure DevOps from within the ALM and Test management section. This brings you to the Azure DevOps Integration Setup page.

- Input your credentials.
- Click the Test Connection to check your credentials. If successful, you'll see a confirmation message.

- 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.
- Go to Settings > Integrations. The Integration list appears.

- Navigate to the ALM & Test Management section.
- 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.
Select the ADO Project to link from the dropdown list. This defines which work items will be synced to Katalon TestOps.
Optional: Select a team to link to enhance collaboration.
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.
Tick on Pull Requirements (enable generation of test cases from requirements and links requirements with test cases for traceability) to enable this feature.
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, 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 Full Path toggle.
Select the Release from the dropdown list and the corresponding iteration path.
Select the Sprint from the dropdown list and choose the corresponding iteration path or choose From ADO - Team Board.
- 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.
- Map ADO Priority levels 1 to 4 to your chosen TestOps Priority levels based on your workflow.

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.
Optional: Select up to three date fields to set the Release Date.
Select the TestOps Status that corresponds to the ADO State.
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.
Map ADO Severity levels to your chosen TestOps Priority levels based on your workflow.
Map ADO States to your chosen TestOps Status.
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 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.