Updated: October 10, 2024

How to Connect an Azure DevOps Project

Azure DevOps is a task management system similar to Jira. Enji works with this task tracker to collect essential information on employee activity and performance. Use this guide to connect an Azure DevOps project to Enji.

Boards

1. Open Enji -> Settings -> Project List and click the project ID.

2. Go to the PM Tools tab and select "+".

3. Complete the fields:

  • PM Site: Choose the required Azure DevOps PM Site from the drop-down list. Add a new PM Site if you do not find a corresponding source in the list.
  • Project Key: Enter the project indicator/key, e.g., COL, PC, TEST (read below how to find the project key).
  • Board Name: Any name. It will be displayed in the PM Tools list.
  • Username: Insert your username from the Azure DevOps account (your email used for system authorization).
  • Token: API Token (details on where to get the token below).
  • Is active: Check the box.
  • Auth-type: leave it empty.

4. Click the Test Connection button to ensure the connection is established with the access data filled in. If OK, click Save.

Finding the Project Key

1. Go to Project Settings.

2. Copy the Name field value - this is the Project Key.

Generating an API token in Azure DevOps

  1. In the top right corner, click on the avatar.
  2. Click on the three dots -> User Settings -> Personal Access Tokens (or Security, if you are on the self-hosted solution).
  3. Click on the New Token button.
  4. Name it, choose Read for Work Items, and set the expiration date to the maximum.
  5. Copy the token and save it.

Parser processes run every 2 hours, parsing data from the Azure DevOps Project into Enji.