Skip to main content

Connect an Azure DevOps instance to a project

  • Updated

Who can use this feature?

  • Organization administrators, workspace administrators, and workspace users.
  • Available for all packages.

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/tasks.
  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/tasks.
  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/tasks.
  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/tasks.
  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 fields

Note: Only Enterprise customers can configure optional 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. Enterprise customers can configure optional fields that the platform supports. For example, Severity. The optional fields vary depending on the configuration of your Azure DevOps project and issue type. Note that the platform doesn't support all Azure DevOps fields. For example, JSON items.

To configure fields:

  1. Go to Projects/tasks.
  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 all fields. Any required or optional fields from the Azure DevOps project will load. Required fields are marked with an asterisk and optional fields are not.
  6. In the Element column, select default options for each field you want to configure.
  7. Select Save.

Related to

Related articles

Comments

0 comments

Article is closed for comments.