Managing Associations
Introduction
Associations are specific relations between tracker items and any of the following:
• Other Codebeamer entities such as other items or documents.
• External web resources via a URL.
In contrast to references, associations do not have a defined value set or severity.
Adding Associations
New item associations can be created in any item status.
 |
Adding associations requires the Item - Edit Associations permission.
|
To add an association to a work item, follow the steps below:
1. Click Add Association hyperlink available on the Associations tab of a work item:
2. Select an association type from the Association Type list.
The association type defines the relationship between the work item and the association. The following association types are available in the list:
◦ depends on
◦ is superordinate to
◦ is subordinate to
◦ is related to
◦ is derived from
◦ violates
◦ excludes
◦ invalidates
◦ was copied from
|
|
There can only be one association with the same association type between two entities.
|
3. Select a baseline in the Baseline field.
There are two options to select from:
◦ --: It means that the association will always point to the latest version available, irrespective of the time of creation of the association.
◦ Current HEAD: It means that the association will always point to the current HEAD version, that is, the latest version at the time of creation of the association.
4. Select any of the following options as applicable:
◦ Propagate suspects: If this option is selected, the association is marked as Suspected in case the associated item is modified. You can then decide whether the change in the associated item applies to your work item, and you can easily apply the changes in the associated item to the work item if necessary.
◦ Reverse direction: If this option is selected, the association is marked as Suspected in case the original work item that contains the association is modified.
|
|
This option belongs to the Propagate suspects feature, and you can only select this option if the Propagate suspects checkbox is selected.
|
◦ Bi-directional: If this option is selected, the association is marked as Suspected in case either the original work item or the associated item is modified.
|
|
This option belongs to the Propagate suspects feature, and you can only select this option if the Propagate suspects checkbox is selected. Also, you cannot select both Reverse direction and Bi-directional at the same time. If the checkbox for one of these options is selected, the other option is automatically cleared.
|
5. Select an item to associate with the current work item using the following options:
◦ From History: You can select an item from the list of items that you have recently worked with.
◦ From Search: You can search for an item in the system.
◦ URL: You create an association to an external link.
Editing Associations
Existing associations can be edited to modify its settings without changing the associated tracker items.
|
|
Editing existing associations requires either the Item - Edit Any or Item - Edit as Owner permission.
|
To edit an association,
1. Click the Associations tab of the tracker item where the association is defined.
2. Locate the association to modify.
3. Click the more 
context menu next to the View Comments link for the association.
context menu next to the View Comments link for the association.4. Click Edit.
In the Editing association dialog, the Association Type, Baselines, Propagate suspects options, and the Add comment fields can be modified.
5. Click Save to finalize the changes.
Deleting Associations
Existing associations can be deleted if the relationship between the associated tracker items is no longer required.
|
|
Deleting existing associations requires either the Item - Edit Any or Item - Edit as Owner permission.
|
To delete an association,
1. Click the Associations tab of the tracker item where the association is defined.
2. Locate the association to delete.
3. Click the more context menu next to the View Comments link for the association.
context menu next to the View Comments link for the association.4. Click Delete...
5. Click Yes on the confirmation dialog.