Azure DevOps (ADO) Integration: Streamline Bug Tracking

These instructions detail how to integrate Ratl with Azure DevOps for efficient bug tracking. Automatically raise bugs with detailed test failure information, including logs and reports, directly from Ratl into your ADO project for seamless issue management.

Creating a Personal Access Token (PAT) in Azure DevOps (ADO)

Personal Access Tokens (PATs) are a secure way to authenticate to Azure DevOps (ADO) when accessing resources through APIs, tools, or other clients. This guide outlines the steps required to create a PAT in Azure DevOps.

Prerequisites

• An active Azure DevOps organization.

• Sufficient permissions to manage personal tokens.

• A valid Microsoft account linked to Azure DevOps.

Steps to Create a PAT

1. Sign in to Azure DevOps

• Navigate to https://dev.azure.com.

• Sign in using your Microsoft credentials.

2. Access User Settings

• Click on your profile picture or initials in the upper-right corner.

• Select Personal Access Tokens from the dropdown.

3. Generate a New Token

• On the Personal Access Tokens page, click on + New Token.

• Fill in the following details:

  • Name: A descriptive name for the token (e.g., "API Access Token").

  • Organization: Choose the organization the token will be associated with.

  • Expiration: Set the token's expiration date (default is 30 days, but you can select up to 1 year).

  • Scopes: Choose the appropriate level of access for the token.

  • Full Access: Grants complete access to all resources.

  • Custom Defined: Select specific areas such as Build, Work Items, or Repos.

• Click Create.

4. Save the Token

• After the token is generated, copy it immediately and store it securely (e.g., in a password manager).

Important: You will not be able to view the token again after closing the page.

5. Add the PAT Token In RATL Integrations

• Navigate to the ADO Integration section in RATL.

• Fill in all required information, including:

  • Organization: Enter the name of your Azure DevOps organization.

  • Workspace: Specify the workspace to integrate.

  • Token: Paste the newly generated PAT token.

  • User Email: Provide the associated user email.

• Click on Apply changes and select the project you want to add.

Raising Bugs in Azure DevOps

Note - Using the scenario for Functional Test

1. Open the suite listing page and select the suite for which you want to raise an issue.

2. Ensure that the bug is raised for test cases that have failed.

3. Locate the test case with a Failed status and click the ellipse (three dots) icon.

4. Select Report ADO from the dropdown menu. A dialog box will appear with the project and bug description pre-filled.

5. Click Submit. A toast message will confirm submission, displaying the work item ID. The Azure DevOps icon will become active in the test case list, allowing direct access to the bug by clicking the icon.