Skip to main content

Jama Connect Interchange User Guide

Map test runs and test cases

Map your Excel template to test runs and test cases in the selected project.

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

    map_items_1.png
  2. Select the Field Mappings tab.

    map_items_2.png
  3. Select Add new field mapping group.

    map_items_3.png
  4. On the page that opens, select Test Plan, then select Next.

    test_plan_1.png
  5. In the Name field, enter a descriptive name for the field mapping group.

  6. In the drop-down list, select the test item type you want to map, then select Create.

    test_plan_2.png

    The field mapping group is created.

  7. Using the drop-down lists, map the fields and cells to one another. Add a separate row for each field/cell combination, as shown in this example.

    test_plan_3.png

    These fields are available in each row:

    • Select Field — Select the field in Jama Connect that is being mapped to Excel.

    • Directionality — Select whether data is written from Jama Connect to Excel (→) or from Excel to Jama Connect (←).

    • Select Sheet — Select the sheet in the Excel template where the cell is located.

    • Input Cell — Enter the cell location in the Excel template. For example, G5.

    Typically, output fields are read-only in Jama Connect to prevent users from updating them manually. If you mark a field as read-only in Jama Connect, you must also select Allow API Overwrite in the field settings to allow the integration service to write the updated Excel value to the item.

    test_plan_4.png
  8. Select Save Changes.

  9. Map test cases to your test runs:

    1. Select Add new associated mapping group.

      test_plan_5.png
    2. Select the type of test case to map, then select Create.

      test_plan_6.png
    3. Add additional field mapping rows for the test case items.

      test_plan_7.png
    4. Select Save Changes.