Importing migration package files

You can import requirements from an IBM® Engineering Requirements Management DOORS® (DOORS) migration package file into IBM Engineering Requirements Management DOORS Next (DOORS Next). The migration package file must be in your file system.

Importing data from a migration package file is a one-way, non-destructive migration method for moving requirements from DOORS into DOORS Next. Historical data is not migrated; however, the import process creates URIs in DOORS Next that link back to the corresponding records in DOORS. These links provide access to history, baselines, and other non-migrated data. During the import process, the wizard searches for existing compatible types to use. If an existing type cannot be found, a new type is created.

Migration options for incoming packages:

  • On entering the artifact type, for Attribute for imported modules, all attribute values are imported successfully, regardless if the attributes are mapped to the types before migration.
  • On entering the artifact type, for Attribute for imported artifacts and Attribute for imported modules, the attribute values are imported successfully only if the attributes are mapped to the types before migration.
  • On not entering any artifact type for Attribute for imported artifacts, all attribute values are imported successfully, regardless if the attributes are mapped to the types before migration.
To import data from a migration file:
  1. Click Artifacts > Import Artifacts.
  2. In the import wizard, click Import requirements from a migration package.
  3. Browse for and select the migration option and file to import, and then complete the steps in the wizard. The migration options are:
    • Attribute for imported artifacts
    • Attribute for imported modules
    The migration package file must have a .migiz file extension.

After the import process is complete, a migration report is generated. You can access the report at any time from the project properties Migration page. For information about how to create a migration package, see Migrating data to DOORS Next.

You can also watch an overview video and a detailed video about migrating requirements from DOORS into DOORS Next.


video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki