IBM Support

How to keep links when restoring a DOORS module archive

Technote (FAQ)


Question

How do you preserve the links for a module that you restore from archive in IBM Rational DOORS?

Cause

When you restore a DOORS module archive, the links are not included by default.

Answer

The recommended procedure to archive data that is linked together is to use DOORS project archive;
this preserves the links and related link-sets so you can restore the information in the database where it resides.

However if you wish to archive just a module and preserve the in-coming and out-going links you can capture the link information before you create the archive, then recreate the links after you restore the archive.

In this example you wish to restore a copy of your Requirements module and preserve the out-going links to your test module and the in-coming links from your design module.





First you capture the link information using the attached DXL scripts.

Use capture_target.dxl for out-going links, or capture_source.DXL in-coming links.


Steps to capture link information:

  1. Open the module exclusive edit

  2. Click Tools > Edit DXL...

  3. Load the script capture_target.dxl



  4. Click Run to capture out-going links.

    This creates an attribute named for each target module


  5. Run the capture_source.dxl to capture in-coming links.

    This creates an attribute named incoming for each source module.

  6. Click File > Save then close the module.

  7. Click File > Archive..

  8. Click File > Restore > Module

  9. Choose the module archive with the captured link information

  10. Click OK, provide the new module name, then Click OK again



  11. Open the restored module to recreate the links

  12. Click Link > Advanced > Link by Attribute...

  13. Click Browse to select the Target module name and Link module for the Out links you wish to create

  14. Select the Attribute for the out-going links you wish to create.
    Leave the Link direction Source to target



  15. Click Apply

    You need to repeat these steps for each set of out-links choosing the appropriate Target module, Link Module and captured Out-link attribute name.

    When you complete recreating your out-links use the same procedure to create in-links; but you need to change the link direction. For this technique the in-links you intend to create must specify the module where the link originates (in this case that module is designated as the target in the link by attribute window) and then you need to set the link direction Target to source.
    This correctly establishes a link from that module that will terminate in the module where you are creating it.

  16. Click Browse to select the module name where you intend to originate the in-bound link and the Link module for the links you wish to create


  17. Select the Attribute for the in-coming links you wish to create.
    Set the Link direction Target to source



  18. Click Apply

    You need to repeat these steps for each set of in-links choosing the appropriate module where the link originate from, the Link Module and captured in-link attribute name

  19. Click File > Save



    Note:
    If you wish you can rename the attribute to shorten the name or add other prefix or suffix.

Disclaimer

All source code and/or binaries attached to this document are referred to here as "the Program". IBM is not providing program services of any kind for the Program. IBM is providing the Program on an "AS IS" basis without warranty of any kind. IBM WILL NOT BE LIABLE FOR ANY ACTUAL, DIRECT, SPECIAL, INCIDENTAL, OR INDIRECT DAMAGES OR FOR ANY ECONOMIC CONSEQUENTIAL DAMAGES (INCLUDING LOST PROFITS OR SAVINGS), EVEN IF IBM, OR ITS RESELLER, HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.


capture_target.dxl

capture_source.dxl

Document information

More support for: Rational DOORS
General Information

Software version: 9.3, 9.3.0.1, 9.3.0.2, 9.3.0.3, 9.3.0.4, 9.3.0.5, 9.3.0.6, 9.3.0.7, 9.4, 9.4.0.1, 9.5, 9.5.0.1

Operating system(s): Windows

Reference #: 1625169

Modified date: 27 April 2013