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: 

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 => 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.) => 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.