Skip to main content

Jama Connect Interchange Help

Configure field mapping groups

After you create a Jira integration, add field mapping groups, then configure routes that determine where each mapping applies.

To configure field mappings for Jira:

  1. On the Integrations page, select the link for the integration you just created.

  2. Select the Field Mappings tab.

  3. For each field mapping group you want to add, select Add field mappings group.

    Important

    Use a unique Jama Connect item type and Jira issue type pair for each field mapping group. A type can’t be assigned to more than one group within an integration.

  4. In the page that opens, complete the fields, then select Create.

    • Name — Enter a descriptive name for the field mapping group.

    • Jama item type — Select the Jama Connect item type to pair with the Jira issue type. You can only select item types that are shared by all Jama Connect projects in the integration. Configure Jama Connect projects and locations in routes.

    • Jira issue type — Select the Jira issue type to pair with the Jama Connect item type.

      The page closes and the new field mapping group is created.

  5. Using the drop-down lists, map the Jama Connect and Jira fields to each other. Begin with a few fields first (for example, Name and Description), then test the integration before adding more fields.

    Important

    A field appears in the Jira drop-down list only if you configure it to be displayed on both the “Create issue” and “Edit issue” screens for the Jira issue type. This requirement applies only to company-managed Jira projects.

    You must map all required fields in the target system. For example, if Jira requires that the Summary field must be filled out to create the item, make sure that you map the Summary field. Required fields are labeled with (required) in the field mapping picklist.

  6. Select Save.