Azure DevOps

Azure DevOps Integration with Autom Mate

Introduction

This document provides a comprehensive guide for integrating Azure DevOps with Autom Mate. It covers credential setup, details about available actions, and step-by-step instructions for leveraging Autom Mate to streamline work item management and project operations.


What is Azure DevOps?

Azure DevOps is a cloud-based DevOps service offered by Microsoft that provides a set of tools for planning, developing, testing, and delivering software. It supports agile project management, CI/CD pipelines, and collaboration for development teams, helping them ship high-quality software efficiently.


Autom Mate Integration with Azure DevOps

The integration between Autom Mate and Azure DevOps enables users to automate project and work item management tasks. Autom Mate provides predefined actions that interact seamlessly with Azure DevOps APIs, allowing users to create, retrieve, and manage work items and projects.


Credentials

To connect Autom Mate to Azure DevOps, credentials must be added to the Autom Mate Vault. The integration uses OAuth 2.0 authentication.

OAuth 2.0 Authentication

  • Purpose: OAuth 2.0 is a secure authentication method that allows access to Azure DevOps resources on behalf of the user.

  • Steps to Add Credential:

    1. Navigate to the Vault and click Add New Credential.

    2. Fill in the required fields:

      • Connector Name: Enter a friendly and globally recognizable name for the connector.

      • Authentication Type: Select oauth20.

      • Client ID: Retrieve your Client ID from the Azure Portal's application registration page. Learn More.

      • Client Secret: Retrieve your Client Secret from the Azure Portal's application registration page. Learn More.

      • Tenant ID: Specify the directory tenant in GUID or friendly name format. This determines the Azure Active Directory tenant that permissions are requested from.

    3. Save the credential to complete the setup.


How to Use Actions

Create Work Item

Description and Purpose

The Create Work Item action allows users to create a new work item within a specified project. Additional fields can be configured through the data manager but may not be compatible with all work item types.

Usage Stepper

1

Add Azure DevOps credentials to Autom Mate’s Vault.

2

Select the Create Work Item action.

3

Provide the required fields: Project ID, Work Item Type, and Title.

4

Configure optional fields using the data manager if necessary.

5

Execute the action to create the work item.

Inputs

  • Project ID (Required): Specify the ID of the project where the work item will be created.

  • Work Item Type (Required): Specify the type of the work item (e.g., Bug, Task).

  • Title (Required): Enter the title of the work item.

  • Optional Fields: Configure additional fields in the data manager as needed.


Get Project Details

Description and Purpose

The Get Project Details action retrieves detailed information about a specific project in Azure DevOps. Users can specify or select a Project ID from a dropdown menu, which lists up to 100 projects.

Usage Stepper

1

Add Azure DevOps credentials to Autom Mate’s Vault.

2

Select the Get Project Details action.

3

Provide the required field: Project ID (specify or select from the dropdown menu).

4

Configure optional fields using the data manager if necessary.

5

Execute the action to retrieve the project details.

Inputs

  • Project ID (Required): Specify or select a Project ID. A maximum of 100 projects will be listed in the dropdown menu.

  • Optional Fields: Configure additional fields in the data manager as needed.


List Projects

Description and Purpose

The List Projects action retrieves a list of all projects in the organization. Users can configure optional fields using the data manager for additional customization.

Usage Stepper

1

Add Azure DevOps credentials to Autom Mate’s Vault.

2

Select the List Projects action.

3

Configure optional fields using the data manager if necessary.

4

Execute the action to retrieve the list of projects

Inputs

  • Optional Fields: Configure additional fields in the data manager as needed.


Get Work Item

Description and Purpose

The Get Work Item action retrieves the details of a specific work item by ID. Users can configure optional fields using the data manager for additional customization.

Usage Stepper

1

Add Azure DevOps credentials to Autom Mate’s Vault.

2

Select the Get Work Item action.

3

Provide the required fields: Project ID and Work Item ID.

4

Configure optional fields using the data manager if necessary.

5

Execute the action to retrieve the work item details.

Inputs

  • Project ID (Required): Specify the ID of the project that contains the work item.

  • Work Item ID (Required): Specify the ID of the work item.

  • Optional Fields: Configure additional fields in the data manager as needed.


List Work Items

Description and Purpose

The List Work Items action retrieves details of multiple work items based on their IDs. Users can configure optional fields using the data manager for additional customization.

Usage Stepper

1

Add Azure DevOps credentials to Autom Mate’s Vault.

2

Select the List Work Items action.

3

Provide the required fields: Project ID and Work Item ID(s).

4

Configure optional fields using the data manager if necessary.

5

Execute the action to retrieve details of the specified work items.

Inputs

  • Project ID (Required): Specify the ID of the project that contains the work items.

  • Work Item ID(s) (Required): Specify the ID(s) of the work items.

  • Optional Fields: Configure additional fields in the data manager as needed.

Last updated