Customize your table map configuration

  • Release version: Xanadu
  • Updated August 1, 2024
  • 1 minute to read
  • Map a Agile Development 2.0 table of your preference for a Jira project.

    Before you begin

    About this task

    Create a custom table map of your preference for your Jira project and configure its fields.

    If you have a custom table that is applicable to all Jira projects of a specific project type, see Apply custom map configuration to multiple Jira projects.

    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 of the Jira project, click New.
    5. On the form, fill in the fields.
      Table 1. Table Map form
      Field Description
      Internal Table Table name in Agile Development 2.0.
      Map configuration Map configuration for this project.

      This field is auto-populated based on the project.

      External Table Table ID in Jira.
      External Table Name Display name of the table in Jira.
    6. Save the table configuration.
    7. From the Field Maps related list of your table map record, create new field maps for the following fields:
      Field in Jira Field in Agile Development 2.0
      Summary of the issue Short description
      Description of the issue Description

      For information on how to configure field mapping for a table, see Customize your field map configuration. You can also create other field maps for your new table configuration.

    What to do next

    1. Validate your new table map configuration by clicking Validate and fix mapping from your project form.
    2. In the Table maps related list of your project, 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 correct values for all the fields and validate again.
    3. Create a business rule to support export of this new table map configuration to Jira. See Create a business rule to apply a custom Agile Development 2.0 table map configuration.
    4. If you want to support import and export of attachments for this new table map, see Allow import and export of attachments on a custom Agile Development 2.0 table.
    5. If you want to enable display of fields that reference Jira identifiers in your custom table map, see Populate Jira project identifier reference fields for Agile Development 2.0 custom table.