Import work items and iterations of an Azure DevOps project into Agile Development to track and update the status of your work.

Before you begin

Procedure

  1. Navigate to All > Agile Azure DevOps Integration > Azure DevOps Instances.
  2. Open your Azure DevOps instance record.
  3. From the Azure DevOps Projects related list, open a project record.
  4. Enable import and export of work items by selecting the Enable Workitems Import and Enable Workitems Export options.
  5. Enable synchronization of sprint data by selecting the Sync Sprints option.
  6. Click Import Work Items.
  7. Select a date and time range.
  8. Click Submit.
    Note: The bulk import action doesn’t import the Description and Acceptance criteria fields. However, if there’s an update on these records in Azure DevOps after the import is done, these fields are synced in Agile through webhook events.

    Details of your import requests are available in the Azure DevOps Import Requests related list.

    You can view all the imported work items and sprints in the Agile Development application.

    • The relationship between the stories and epics stays as it is in Azure DevOps.
    • The mapping of states of an iteration in Azure DevOps to sprints in Agile Development is as follows:
      State in Azure DevOps State in Agile Development 2.0
      Past Completed
      Future Draft
      Current Current
    • Sprints are not created in Agile Development 2.0 for the following conditions:
      • If the date fields of the iteration in Azure DevOps are empty.
      • If the iteration has a child iteration associated to it.
      • If the sprints have overlapping dates.
    • If two or more teams share a backlog iteration in Azure DevOps, a separate sprint record for each team is created in Agile Development 2.0.

What to do next

Schedule jobs to import projects, teams, areas, and work items from Azure DevOps

.