Azure DevOps integration
  • 25 Sep 2023
  • 2 Minutes to read
  • Dark
    Light

Azure DevOps integration

  • Dark
    Light

Article Summary

Azure DevOps is a proprietary issue tracking product developed by Microsoft that allows Agile project management and bug tracking. Project management in Agile.Now ecosystem is implemented using the Azure DevOps software with a workflow that supports the process. The Agile.Now Factory process relies on the Azure DevOps software, one of the most widely used agile application development software in the world. Without the project management application, the user will not be able to use the Agile.Now Factory platform.

Setting Up Azure DevOps

To interact with Azure DevOps it is required to have an account with proper permissions to manage projects (view the projects info such as issues, releases, statuses and ability to create components). The steps taken towards this are detailed below:

  • Create the personal Azure DevOps Token using following link: https://dev.azure.com/{domain}/_usersSettings/tokens where {domain} should be changed to your domain.
  • Within Agile.Now, update the Factory Settings: 
    • Set the App to Azure DevOps.
    • Set URL-address to the base URL of the Azure DevOps server. It should have the following format “https://dev.azure.com/{domain}” where {domain} should be changed to your domain. 
    • Set API version of the Azure DevOps API - use value 6.0
    • Set Service access token to the API Token which was generated in the first step.

 

Also there is 'User own token' flag. If it is set a logged in user token is used for all actions performed under issue (change issue status, adding comments etc.) So issue comment is added on behalf of logged in user and different issues have different authors and it is clear to understand who processed the issue in the work flow. If flag is not set the common token from general settings is used for all actions. So all issue actions in spite of who is issue processor are done on behalf of the only person whos personal token is saved in general settings.

To set token value please open user profile panel by clicking on user icon in the right upper corner and press 'Update token' button.


Here you can enter your personal token and save it (you can't see the value of token after saving).

Finally press 'Sync environment' button. Required Agile.Now inherited from base Agile process is created in Azure DevOps as well as related to created process issue statuses list is updated for User Story and Bug issue types.

A webhook is a user-defined callback over HTTP

A webhook is a user-defined callback over HTTP. User can use Agile.Now webhooks to notify application when certain events occur in Project Management tool.

Example: User might want to alert Agile.Now when an issue is updated. Using a webhook to do this means that Agile.Now doesn't have to periodically poll Project Management tool (via the REST APIs) to determine whether changes have occurred.

There should be added 3 different hooks for every project:

  • Work item created
  • Work item updated
  • Work item deleted

Steps


CLICK HERE to go to the Microsoft Azure DevOps documentation about Webhooks.


Was this article helpful?