Skip to main content

Connect an Azure DevOps instance to a project

  • Updated

Who can use this feature?

  • Workspace Users and Workspace Administrators.
  • Available for Accelerate, Enterprise, and customers who joined Level Access before February 20th, 2023.

Connect an Azure DevOps instance to a project to start pushing tasks into Azure DevOps. The platform projects to Azure DevOps relationship supports many to one, meaning that you can connect multiple projects to a single Azure DevOps project.

You need to set up an Azure DevOps connection in your workspace before you can connect it to a project.

On this page:

Connect to an existing platform project

To connect an Azure DevOps instance to an existing platform project:

  1. Go to Projects.
  2. Find the project you want to connect with and select View project.
  3. Select Add issue tracking project.
  4. In the Issue tracking software field, Select Azure DevOps.
  5. Choose the Azure DevOps instance and project you want to connect to.
  6. Select Save.

Connect to a new platform project

To connect an Azure DevOps instance to a new platform project:

  1. Go to Projects.
  2. Select Create project. Read more about creating and editing projects.
  3. Fill out the required fields.
  4. In the Issue tracking software field, Select Azure DevOps.
  5. Choose the Azure DevOps instance and project you want to connect to.
  6. Select Save.

Configure progress mapping

Progress mapping allows you to synchronize the progress of a task and the state of an Azure DevOps work item. When you update the state of a work item in Azure DevOps, the task progress automatically updates in the platform (and vice versa). You can map states for all work item types in your Azure DevOps instance or map the states for Azure DevOps project-specific work item types.

Below, we’ve connected a “Done” state from Azure DevOps to the “Requires review” progress in the platform. When the Azure DevOps work item state is changed to “Done,” the progress of the task will automatically update to “Requires review” in the platform, and vice versa.

Note: Platform tasks with progress “Review in progress” won’t change the linked Azure DevOps work item state.

Image shows the progress mapping page with a list of Azure DevOps statuses in one column and a list of eAP task progress states in the other column.

Configure progress mapping for all issue types

You can configure transition rules for multiple states across all Azure DevOps work item types and projects. 

To connect one or more Azure DevOps states to a task progress update:

  1. Go to Projects.
  2. Find the project you want to map to and select the three-dot action menu.
  3. Select Configure Progress Mapping.
  4. Choose Configure transition rules for all issue types.
  5. Select the Azure DevOps state you want to connect with each platform task progress. Note that each Azure DevOps state can only be connected to one platform task progress.
  6. Select Save.

Configure progress mapping for specific issue types

Our Azure DevOps integration allows you to configure transition rules for states specific to one project and work item type. 

To connect one or more Azure DevOps states to a task progress update:

  1. Go to Projects.
  2. Find the project you want to map to and select the three-dot action menu.
  3. Select Configure Progress Mapping.
  4. Choose Configure transition rules for a specific issue type.
  5. Select the issue type.
  6. Select the Azure DevOps states you want to connect with each platform task progress. Note that each Azure DevOps state can only be connected to one platform task progress.
  7. Select Save.

Configure required fields

If you have required fields other than Summary and Description in your Azure DevOps instance, you’ll need to configure them on the platform first. Once they’re configured, you can push tasks to Azure DevOps.

To configure the required fields:

  1. Go to Projects.
  2. Find the project you want to configure the fields for and select the three-dot action menu.
  3. Select Configure fields. 
  4. Choose the issue type with required fields.
  5. Select Retrieve required fields. Required fields from the Azure DevOps project will load in the Name column. Required fields are marked with an asterisk.
  6. In the Element column, select default options for every required field.
  7. Select Save.

Related to

Related articles