Default map configuration for Azure DevOps integration with Agile Development 2.0

  • Release version: Australia
  • Updated March 12, 2026
  • 1 minute to read

    • Understand the default field map configuration, of different process types, between Azure DevOps and Agile Development 2.0.

    By looking at the default map configuration for different process types, you can see how work item types in Azure DevOps are mapped in Agile Development. You can also see how fields are mapped between the two applications.

    When you import available epics, stories, and issues from Azure DevOps, this data is stored in tables as defined in the process map configuration.

    Note:

    When you upgrade to version 1.3 of the application, map configuration is generated at the process level per process type and not at the instance level. You must update any custom maps that you previously configured to ensure that the import and export of work items is not impacted.

    Here's how you can view the default map configuration for different process types.

    1. Navigate to Agile Azure DevOps Integration > Azure DevOps Instances.
    2. Open your Azure DevOps instance record.
    3. From the Process Mappings related list, open the record for a process map.

    You can add or update the configuration for field, table, and choice maps between Azure DevOps and Agile Development 2.0. For details, see Customizing your map configuration for Azure DevOps integration.

    The following are the details of the default map configuration for various process types in Azure DevOps.

    Default mapping for Agile process

    Table 1. Default mapping configuration for Agile Process
    Table in Azure DevOps Table in Agile Development 2.0
    User Story Story [rm_story]
    Epic Epic [rm_epic]
    Feature Feature [ sn_safe_feature]

    Default mapping for Basic process

    Table 2. Default mapping configuration for Basic process
    Table in Azure DevOps Table in Agile Development 2.0
    Issue Story [rm_story]
    Epic Epic [rm_epic]

    Default mapping for CMMI process

    Table 3. Default mapping configuration for CMMI process
    Table in Azure DevOps Table in Agile Development 2.0
    Epic Epic [rm_epic]
    Requirement Story [rm_story]

    Default mapping for Scrum process

    Table 4. Default mapping configuration for Scrum process
    Table in Azure DevOps Table in Agile Development 2.0
    Product Backlog Item Story [rm_story]
    Epic Epic [rm_epic]