Create a custom workflow state map of your preference for a Jira project.

Before you begin

About this task

Map a custom workflow state from Jira to Agile Development 2.0.

You can map a workflow state in Jira to multiple workflow states in Agile Development 2.0. In such cases, the state in Agile Development 2.0 for an issue type depends on the choice order value that you provide for this state configuration.

For example, the In Progress state in Jira is mapped to multiple states such as Work in progress, Ready for testing, and Testing in Agile Development 2.0 using a choice order of 10, 20, and 30.

So, when an In Progress issue from Jira is imported, the State field in Agile Development 2.0 is set to Work in progress as it has the lowest choice order value.

You can also map multiple workflow states in Jira to a single workflow state in Agile Development 2.0.

Procedure

  1. Navigate to All > Agile Jira Integration > Jira Instances.
  2. Open your Jira instance record.
  3. From the Jira Projects related list, open a Jira project for which you want to customize the choice map configuration.
  4. Open the workflow state map for this project.
    1. From the Table Maps related list, click Story.
    2. From the Field Maps related list, click Status.
  5. From the Choice Maps related list, click New.
  6. On the form, fill in the fields.
    Table 1. Choice Map form
    Field Description
    Internal Choice Value of the workflow state in Agile Development 2.0. This value is an integer.
    External Choice ID of the workflow transition in Jira.
    Note: In case there is no transition, insert the ID of the workflow state.
    External Choice Name Display name of the workflow transition in Jira.
    Note: In case there is no transition, insert the display name of the workflow state.
  7. Click Update.

What to do next

  1. Validate your choice map configuration by clicking Validate and fix mapping from your project form.
  2. From the Table maps related list of your project, navigate to your new choice map configuration. If the Valid column for your configuration shows:
    • true, validation of your map configuration is successful.
    • false, validation of your map configuration failed. Ensure that you enter correct values for all fields and validate again.