Skip to main content

Azure DevOps Connector

This connector connects ALVAO Service Desk and Azure DevOps. For example, a user submits a ticket to ALVAO Service Desk to modify the ERP system. After the ticket is approved and a detailed specification of the modification is developed, or immediately after the ticket is created, a work item is automatically created in Azure DevOps to implement the modification. After the modification is executed and the work item in Azure DevOps goes to defined status, the original ticket in Alvao goes to a defined status, e.g. "Synchronization to DevOps".

See an example process:

devops-connector

Technical requirements​

SaaS​

  • ALVAO ITSM or Service Desk subscription

On-premise installations​

  • ALVAO Service Desk
  • User authentication using Microsoft Entra ID
  • Alvao REST API accessible from internet

Installation​

Administrator rights are required for the installation.

  1. Download the AzureDevOpsConnector.zip package.
  2. In the Administration - Service Desk - Services tree, select the folder where you want to import the sample service to connect to Azure DevOps, and use the Import command to load the AzureDevOpsConnectorServiceEnu.xml file, which is included in the AzureDevOpsConnector.zip file.
  3. In Administration - Applications, use the Import command to load the AzureDevOpsConnectorApp.xml file.

Azure DevOps Personal Access Token​

  1. In Azure DevOps, create a Personal Access Token (PAT) with Work Items - Read & Write permissions.
  2. Go to the Administration - Settings - Advanced page. Use the New setting command to create the DevOpsIntegrationToken0 setting. Enter the PAT token from Azure DevOps as the setting value.
tip

You can use multiple access tokens if, for example, you need to integrate Azure DevOps from different organizations into Alvao. Create a new setting and increment the number at the end of the setting name. Then use this number in the AccessToken item in the service setting below.

Setting up Azure DevOps​

  1. In Azure DevOps in a given project, use Project Settings - Service hooks - Create subscription.
  2. Select Web Hooks as the service type and press Next.
  3. Under Trigger on this type of event, select Work item updated.
  4. In Field, select the State option. Press the Next button.
  5. In the URL entry, enter the URL of the AlvaoRestApi application, followed by the path "/Connectors/DevOpsCallback", e.g.: https://contoso.alvao.com/AlvaoRestApi/Connectors/DevOpsCallback
  6. Select None under Messages to send.
  7. In Detailed messages to send, also select None and press Finish.

Setting up service in Alvao​

  1. In Administration - Service Desk - Services, select the service you want to connect to Azure DevOps and use Edit - Properties.

  2. In the Other section, find the External Application - Connector Settings custom field and edit the value.

    The default value:

{
"ConnectorType": "AzureDevOps",
"URL": "https://dev.azure.com/Alvao/Alvaoproject",
"AccessToken": "0",
"AttributeMap":
{
"System.Title": "[$TicketTitle$]",
"System.Description": "[$LatestImportantMessage$]",
"System.WorkItemType": "Task" 
},
"BeginState": "Synchronization to DevOps",
"EndState": "Return from DevOps",
"WorkItemEndState": "Closed"
}

Legend:

  • ConnectorType - enter the text AzureDevOps.

  • URL - enter the URL of the Azure DevOps project in the form https://dev.azure.com/\{organization}/\{project}

    Example: https://dev.azure.com/Alvao/Alvaoproject

  • AccessToken - enter the Personal Access Token (PAT) setting number that you used in advanced settings (typically 0).

  • AttributeMap - specify the list of Azure DevOps work item fields and their values. You can use the same variables in the values, as for the status change notification template to requesters.

  • BeginState - specify the name of the ticket status in Alvao in which the ticket will be transferred to Azure DevOps.

    Example: Synchronization to DevOps

  • EndState - specify the name of the ticket status to which the ticket should transition when the corresponding work item is closed in Azure DevOps.

    Example: Return from DevOps

  • WorkItemEndState – specify the name of the status in Azure DevOps in which should the ticket change its status in Alvao.

    Example: Closed