Importing artifacts from ReqIF files to a requirements project or component
You can import the data in a Requirements Interchange Format (ReqIF) file from your file system to a requirements project or component.
Before you begin
Before you import a ReqIF (.reqif or .reqifz) file, ensure that the file that you are importing is encoded in UTF-8.
To import a ReqIF file, you must have write access and the Import ReqIF permission.
About this task
When you import a ReqIF file (.reqif or .reqifz), you use a wizard in which you select the ReqIF file to upload and import. After you upload the file, you can either import the ReqIF data or close the wizard and import the ReqIF data at another time. After the import process is complete, a report is displayed that shows a list of the imported data. You can go to imported artifacts in the project or component by using the links that are generated in the report.
You can use the standard import option, where you can select the ReqIF file to import and follow the instructions. For more information, see Using the standard import option.
- Textual artifacts
- Graphical artifacts
- Diagram artifacts
- Attribute definitions
- Data types
- Folders and folder hierarchies
- Links
- Link types
- Tags
- Modules
- Artifact types
- Collections
- View column information, which is imported during the first import only.
- Data types
- Attributes
- Artifact types
- Modules
- Artifacts
- Folders
- Links
- View column information
For more information about ReqIF usage scenarios, see ReqIF Usage Scenarios.
- If a resource was previously imported into a different stream or change set in a component or
project, the import completes the following actions:
- Creates a version of the resource in the stream or change set at the import location.
- Updates the resource if it is already available at the import location.
- If a resource was not previously imported into any of the streams or change sets in a component or project, the import creates the resource at its import location.
- If a resource was previously imported into the stream or change set in a component or project, the import updates the resource if it was changed.
- View filtering information
- Comments
- Reviews
- Audit histories
You can import ReqIF files in XML format or a compressed file format. If a ReqIF file references external attachment files or embedded OLE files, which occur in some exports from IBM Engineering Requirements Management DOORS , the ReqIF file, and the referenced external files must be in one compressed file to ensure that the correct associations are created in the requirements project or component. When you import a ReqIF file that contains embedded OLE objects from DOORS , the OLE objects are created as file resources in the requirements project or component.
When you import a ReqIF package, existing artifact types are updated and the attributes are retained: they are not removed.
For example, you have an existing artifact that is named Artifact Type A
, with attributes
A and B. You import a package that contains Artifact Type A
, with attributes A and C, the
updated artifact is Artifact Type A
, with attributes A, B, and C.
If the package includes only portions of a module, when the package is imported, new artifacts are added to the existing module structure. Artifacts that are not included in the package but exist in the module structure are never deleted.
If child artifacts are moved to new parent artifacts as described in the imported package, the previous parent is also included in the package. If the previous parent is not included in the package, the child artifact is not moved. The following example shows that how a child artifact can move during the import process:
Existing package | Package being imported | Resulting structure (moved artifacts are in bold) |
---|---|---|
Parent artifact 1
Parent artifact 2
Parent artifact 3
|
Parent artifact 1
Parent artifact 2 |
Parent artifact 1
Parent artifact 2 Parent artifact 3
|
- Artifact to artifact
- Artifact to module
- Artifact to collection
- Module to module
- Module to collection
- Collection to collection
Packages from IBM Engineering Requirements Management DOORS Next contain a link when either endpoint is exported. Packages from DOORS contain a link only when both endpoints are exported.
You can also import data by using ReqIF from DOORS to DOORS Next. You can create a ReqIF definition in DOORS and export the definition to a ReqIF package. You can then import the ReqIF package in DOORS Next to get the required data. For more information about exchanging requirements data that uses ReqIF, see Exchanging requirements with other databases and Migrating DOORS project data to DOORS Next.
- ForeignID
- ForeignCreatedOn
- ForeignCreatedBy
For more information about the ReqIF format specification, see Requirements Interchange Format.
When you export ReqIF data from DOORS to DOORS Next, you must map system attributes to URIs in DOORS . For more information, see System attributes and Mapping attributes to URIs for external applications.