Relink Source Module
Start Menu Path: Module Menu / Configuration Mgt / Relink Source Module
Function: 'Relink Source Module' allow you, from a linked source module, to relink a new target module, for a chosen linkset in a new Link Module.
This feature, can be very useful when your branching operation is done separately between two linked modules, without respecting the best practice (top-level module first follow by bottom-level module).
Note: Relinking script, will create a new link set. The original foreign link (created when source had been branched) is not deleted. So user can delete it after using the Relinking Source Module).
How to delete the original link to foreign project after relinking?
Please use the built in Delete Links (Open source module in exclusive edit mode, top menu : Link / Delete / Delete Links ...).
By default the link combo is selected withthe 'Selection to Selection' choice : That will only delete links between the selected objects in the modules
So to get a full deletion, set Link combo to the 'Display set to display set' choice, and make sure both modules do not have a filter on.
Relinking a Source Module
'Relink Source Module' is started from the linked source module open in exclusive edit mode.
After starting the 'Relink Source Module' the following GUI is presented to the user:
- Choose one linkset of ... - The 'Choose one linkset of [module path]' lists display a list of all linksets available for this source module.
the user have to select one specific linkset to relink.
- Browse New Target Module Button - Using the 'Browse New Target Module' button, the user can browse through the DOORS Database, to select the New Target Module.
After selecting the New Target Module, the path of this one is displayed in front of the browse button.
- Browse New Link Module Button - Using the 'Browse New Link Module' button, the user can browse through the DOORS Database, to select the New Link Module.
After selecting the New Link Module, the path of this one is displayed in front of the browse button.
- Relink Source Module Button - When pressing the 'Relink Source Module' button, changes selected (new target module and new link module) will be save in a new linkset, inside the module source.
Note: This button is enabled (clickable) if the user has already selected : a linkset in the list displayed and a New Target Module and a New Link Module.
Use Case example:
When branching operations are done separately between two linked modules, i.e. during incremental branching.
Best practice: top-down iteration
=> As the link target is in the target branch, then the link will be replicated in the target branch.
Otherwise: bottom-up iteration
- 1/ first branching: the bottom-level module(s) will be branched first.
=> As the link target is not yet in the target branch, then BranchManager will recreate the link to the original link target only (if the option “Recreate links to foreign objects” is checked).
(See Link handling during branching and Branch Modules.)
- 2/ second branching: Branch the top-level module that are in-linked to the bottom-level module(s).
=> The link target is always the original one.
In this case you can use the ‘Relinking Source Module’ to redirect the link from foreign target module, to the branched target module.