Map a field of your preference for a Jira project.

Before you begin

About this task

If you have a custom field for a Jira project that you want to map with a field in Agile Development 2.0, you can create custom field map configuration that would apply only to this Jira project.

If you have a custom field that is applicable to all Jira projects of a specific project type, see Apply custom map configuration to multiple Jira projects.The following field types are supported for custom field map configuration:
  • Number
  • Select
  • Text
  • Date
  • Identity
  • Date time
  • Reference
  • List

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 map configuration.
  4. From the Table Maps related list, open the Sprint, Epic, or Story record to add a new field map configuration for that record.
  5. From the Field Maps related list, click New.
  6. On the form, fill in the fields.
    Table 1. Field Map form
    FieldDescription
    Internal Field Field name in Agile Development 2.0.
    Table Map Table map in Agile Development 2.0, in which this field is created.

    This field is auto-populated based on the table map record you select.
    Internal Table Table in Agile Development 2.0.

    This field is auto-populated based on the table map record you select.
    External Field Field ID in Jira.
    External Field Name Display name of the field in Jira.

    Ensure that this field is added to the Jira project screen.
  7. Click Update.

What to do next

  1. Validate your field 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 field map configuration. If the Valid column of your configuration shows:
    • true, validation of your map configuration is successful.
    • false, validation of your map configuration failed. Ensure that you enter the correct values for all fields and validate again.
      Important: If your custom map configuration is invalid or if the custom field configured is not added to the default screen scheme of the issue, the export action does not work.

Configuring a reference field in Jira

Understand how to configure a reference field while creating a new field map configuration.

When you select a reference field for the Internal Field field, you must select a value for the Lookup Column Name field. The value from the Lookup Column Name field is used during the import and export of work items between Jira DevOps and Agile Development 2.0.

During import, the integration application searches for the record in the reference table using the Lookup Column Name field. If the record is not found, the value in the work item will be empty in Agile Development 2.0.


Lookup column name field