Configuring ReqIF mappings

The ReqIF feature is still under development. Changes may be made without prior notice.

Pre-requisites

As a Jira administrator,

  1. Enable ReqIF for your instance. See https://easesolutions.atlassian.net/wiki/spaces/REQ4J/pages/2279243793.

  2. In case of restricted access, to create a ReqIF field mapping, the user must have “ReqIF Field Mapping“ permissions. See https://easesolutions.atlassian.net/wiki/spaces/REQ4J/pages/40599564.

Mapping Configuration

The ReqIF interface must be configured for export and import of your Jira issues using the standardized ReqIF file format. The process follows the ReqIF standard 1.2.

  1. Select Requirements > ReqIF Field Mapping from the main navigation bar

  2. Select Create Mapping or edit existing mapping

  3. Mapping Name (mandatory): presented to the user when exporting or importing requirements. Specify idea, content and background to allow correct selection.

  4. Project (optimal): Mapping is only offered for given project. Some fields (e.g. issue type) can only be mapped later on when a certain project is selected. The mapping is valid for all projects if nothing is specified.

  5. Issue Specification Type (optional): Depend on export target/import source, specifies the mapping name for the type of a specification object.

  6. Folder Specification Type (optional): Depend on export target/import source, specifies the mapping name for the type of a specification (structural elements, folder).

  7. Folder Name (optional): Map the R4J folder item to a defined specification element.

  8. Folder Description (optional): Map the description of a R4J folder item to a defined specification element.

  9. Select Add Mapping for the Jira issues fields to be considered in the export/import. Recommended elements:

    1. Summary (the Jira headline of an issue)

    2. Description

    3. Issue Type

    4. Status

    5. Linked Issues (the linking to other issues)

  10. For enumerated fields (e.g. Issue Type), the mapping of the enumeration could be done.

The mapping created can be used for https://easesolutions.atlassian.net/wiki/spaces/REQ4J/pages/457441292.

Unsupported fields

  • FORM_TOKEN

  • COMMENT

  • THUMBNAIL

  • LAST_VIEWED

  • WORKRATIO

  • SUBTASKS

  • SECURITY

  • TIMETRACKING

  • RESOLUTION_DATE

  • WORKLOG

  • TIME_SPENT (Export Only)

  • AGGREGATE_TIME_SPENT

  • AGGREGATE_TIME_ESTIMATE

  • AGGREGATE_TIME_ORIGINAL_ESTIMATE

  • AGGREGATE_PROGRESS

  • PROGRESS

  • VOTES

  • VOTERS

  • WATCHES

  • WATCHERS

  • Custom fields with type Cascading Select List

Known limitation

  • Issue Key is always included in the export

  • Projects cannot be created via ReqIF

  • Pages are not supported for ReqIF import and export

  • Custom field search is name-based (if custom fields with the same name exist, issues may occur)

  • Multiple steps status transition is not supported

    • Example: For Workflow Open > In Progress > Done 

    • When exporting issue in "Open" state then re-importing issue as "Done", "In Progress" is skipped in the process.

    • The "Open" state is retained and status is not updated because multiple steps status transition is not yet supported.

References