Skip to main content

Jama Connect Interchange Help

Import a ReqIF file to Jama Connect

Import items, relationships, and other objects from a ReqIF file to Jama Connect.

At present, ReqIF files from the following tools are formally supported for import:

  • Jama Connect

  • IBM® DOORS

  • IBM® DOORS Next

To import a ReqIF file:

  1. On the Conversations page, select an existing conversation to use for the import, or create a new conversation. For more information, see Create a new ReqIF conversation.

  2. Select the Import tab:

    1. In the Upload File section, select Upload and select the .reqIF or .reqIFZ file from your computer for upload.

    2. In the Select Import Location section, choose Select Location and select the Jama Connect location to upload the ReqIF file data.

    Data mapping fields are automatically generated on the lower half of the page. This process can take a few minutes to complete, depending on the size and complexity of the ReqIF file.

  3. On the Item Types/Modules subtab:

    JCI_item_types-modules_subtab.png

    1. Set the ON/OFF toggle to ON for each specification that you want to import.

      • Each row represents a specification present in the file.

      • For ReqIF files exported from Jama Connect, these specifications correspond to sets containing one or more items.

      • For ReqIF files exported from DOORS and DOORS Next, these specifications correspond to modules containing one or more objects.

      • When these specifications are imported into Jama Connect, each specification is imported as an individual set in the Jama Connect Explorer Tree.

    2. In the left drop-down list for each row that you enabled, select the Jama Connect item type to assign to the set and items being imported.

    3. Select Next.

  4. On the Fields/Attributes subtab, map the fields corresponding to the sets and items that will be imported for each specification. If the file contains multiple specifications, use the left navigation menu to access the mapping page for each specification and repeat this step for each specification.

    JCI_ReqIF_fields_tab.png

    1. In the Container/Set Attributes section, set the ON/OFF toggle to ON for each attribute (field value) that you want to populate when creating sets in Jama Connect.

      Typically, only a few fields, such as Name and Description, are required in this section.

    2. In the Object Attributes section, map each spec object type within the specification to a folder, text item, orr requirement in Jama Connect, and select General Mappings.

      Additional field mappings are generated for each spec-object-type to Item type mapping combination. For more information about mapping spec-object-types, see Importing mixed specifications.

      JCI_ReqIF_select_item_type.png

    3. Set the ON/OFF toggle to ON for each attribute (field value) that you want to import.

    4. In the left drop-down list for each row that you enable, select the Jama Connect field to write the values to.

      Name and Description fields are mapped automatically but can be modified if needed.

      Important

      When you map single-select and/or multi-select fields, you must also map the corresponding picklist values, which are nested under the field mapping row.

      Map all required fields for the Jama Connect item type; otherwise, the items can't be created, and error messages are generated in the logs. The left drop-down list indicates which fields are required.

    5. Select the Map to additional field link if you want to map the same value from the ReqIF file to multiple fields on the Jama Connect item.

      Note

      If you try to map multiple fields in the ReqIF file to the same Jama Connect field, only one mapping is honored; all others are ignored.

  5. Select Save.

  6. On the Relationships subtab:

    1. Set the ON/OFF toggle to ON for each spec relation type in the ReqIF file that contains relationships you want to import to Jama Connect.

    2. In the left drop-down list for each row you enabled, select the Jama Connect relationship type to use for these relationships.

      • Make sure that Jama Connect relationship rules are configured to allow the relationship types and relationship directions that you are attempting to import.

      • To reverse the upstream/downstream direction from the default direction listed in the ReqIF file, select the Reverse checkbox for that row. By default, “Source” items in the ReqIF file are imported as “Upstream” items and “Target” items in the ReqIF file are imported as “Downstream” items.

  7. Select Initiate Import to import the file.

  8. Select the Logs tab to check the status of the import.

In this section: