Skip to main content

Set up an Azure DevOps integration (source control management)

  • Updated

An integration must be configured and linked to the project to start collecting data for the Technical Axis. However, you only need to add the integration once to connect it to multiple projects, allowing you to evaluate different teams.

 

Available integrations

If you have already added an Azure DevOps integration for the Process Axis (before January 2023), you can simply link it to your project via the Technical Axis to select the projects and repositories to synchronize.

If it is a new integration, follow these steps.

 

To set up an Azure DevOps integration

  1. Select the project for which you want to start collecting data.
    Psst! If you haven't added your project yet, do that first!
  2. Access the Technical Axis, and click on Link an integration.

    EN_-_Axe_processus_et_technique_-_New_integration.png
  3. In the window that opens, click Add an integration.

    EN_-_Choose_integration.png
  4. Select the Azure DevOps option, then click Next.

    EN_-_Axe_Technique_-_Azure_se_lectionne_.png

    1. A window will open. Enter your Azure DevOps login information.
      • The Name of your integration helps you recognize this integration later on. This name will not be displayed anywhere other than the Settings page.
      • The Name of your Azure DevOps organization must be the same as the one specified in Azure DevOps itself.
      • The Personnal Access Token must be generated beforehand directly in the Azure DevOps settings. You can refer to this official Microsoft help article for more information on this topic. Just make sure you allow read access to the «Analytics», «Work items», "Project and Teams" and "Code" options, which are required to synchronize data to Axify.

        To do this:

        • Go to Azure DevOps

        • Go to user settings (silhouette icon in the upper right corner)

        • Select the Personal access tokens option at the bottom of the list

        • Click on + New Token.

          Psst! It is not possible to display an existing PAT. Therefore, if you have private internal documentation where the PAT can be stored, it may be good to keep it as a note there. Also, since the PAT has an expiration date, it is advisable to select the longest period possible (i.e., one year) and schedule a reminder to update it (in your or the team's calendar). At the time of the update, you will simply need to unlink the existing integration, generate a new PAT in Azure DevOps and re-link the integration. Don't worry; the data synchronization is retroactive, meaning that data synchronized in the past is still accessible in Axify.
      • Add the generated PAT in the Personal access token field.

        Once the fields are completed, click on Add Azure DevOps Integration.

        EN_-_Azure_-_Creds.png

That's it! Your Azure DevOps integration is set up and ready to be linked to your project to start collecting data!

Psst! Depending on the volume of data, the synchronization of the Technical Axis can take several minutes or even several hours in the most extreme cases.