Import ReqIF Data into an Existing Project
To import ReqIF data into an existing project:
Go to Admin > General > Import > Import ReqIF
In the upcoming File Upload dialog, choose the ReqIF file/archive to import:
In Codebeamer 9.2 and older, ReqIF data can only be imported into an existing project,
If the project was created from a ReqIF file/archive and the specified ReqIF file/archive is a Re-Export from the same source,
Or the project was exported as a ReqIF file/archive and the specified ReqIF file/archive is a return/response based on the original export.
Since Codebeamer 9.3, ReqIF data can always be imported into an existing project, even if:
The project was not created from ReqIF,
The ReqIF file/archive contains data from a yet unknown data source.
The data schema of the selected ReqIF file/archive is shown next, and input data needs to be mapped to target trackers:
If this is an import from a yet unknown ReqIF data source (according to the Conversation- and RepositoryId in the ReqIF Header of the ReqIF file/archive), then a unique name for the new ReqIF data source needs to be provided:
If this is an import of new or updated ReqIF data from an already known data source (according to the Conversation- and RepositoryId in the ReqIF Header of the ReqIF file/archive), information about the Last Import can also be seen from that source and the import History. Also the configuration used for that last import is automatically loaded and shown:
If there are multiple data sources for the same Conversation- and RepositoryId, then the one used for the Last Import is shown and pre-loaded, it can be switched to another one.
This import can also be stored under a New Source name.
It is not necessary, to explicitly load the ReqIF import configuration from a file, because Codebeamer will automatically load the last import configuration used for the selected source.
It is not necessary, to explicitly save the ReqIF import configuration to a file, because Codebeamer will automatically save it to a file called Source.json in the specific ReqIF Import folder in the Project's Documents, where source is the name the user assigned to the ReqIF data source.
When importing a ReqIF file/archive:
That was already imported before (according to the unique Identifier in the ReqIF Header), or
That is older (according to the creation time in the ReqIF Header) than the last imported ReqIF file/archive from the selected Source.
Then, since Codebeamer 9.5 and newer, an appropriate warning dialog is shown:
In general, it is not advised to continue here because the current project contents are most likely going to be overwritten with obsolete data.
Having a good reason (for example, repeat the last import because the mapping of some new specifications or attributes has been forgotten), and deep knowledge and experience, the user may choose to ignore the warnings and continue, however, this is not advised.
This is visualized on the import configuration screen:
and also later in the import history:
In Codebeamer 21.04 and older, ReqIF imports are executed synchronously.
After the import has finished successfully, statistics about the imported, updated or deleted items per target tracker are shown.
For target trackers, that were created by the import, only the number of imported items will be shown, because there can be hundreds or thousands of items, and these are all items currently in the tracker. To see them, click on the tracker link.
For re-imports into tracker, that already existed before the import, see the items imported, updated or deleted, by clicking on the appropriate number:
For example, show the items, that were updated, including the changed field values:
Codebeamer 9.2 and older used an automatically created baseline, to show the differences between the project before and after the import.
Codebeamer 9.3 and newer will no longer create baselines upon ReqIF imports into an existing project.
Was this helpful?