Associations
Associations are ad hoc relations between tracker items and any of the following:
• Other Codebeamer entities (other items or documents)
• External web resources
In contrast to references, associations do not have a defined value set, severity, or permissions.
All users who have access to a tracker item can create new item associations (in any item status). 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.
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 (which 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 checked.
|
◦ 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 checked. Also, you cannot select both Reverse direction and Bi-directional at the same time. If the checkbox for one of these options is checked, the other option is automatically deselected.
|
◦ Propagate Unresolved Item Dependencies: if this option is selected, the item's UID (Unresolved Item Dependencies) badge becomes active in case the item has unresolved (not resolved or closed) associations which are configured to use this setting.
|
|
This option cannot be used together with the Reverse directionoption. If this option is selected, the Reverse direction option is made inactive. Also, if the Propagate Unresolved Item Dependencies option is selected, it is not possible to specify a baseline or version for the reference.
The Propagate suspects option can only be used for associations between work items, dashboards, documents, and wiki pages. The Bi-directional option can only be applied between work items.
|
The Propagate Unresolved Item Dependencies option can only be applied between work items, except for test runs, reviews, and SCM related items.
|
|
The Propagate Unresolved Item Dependencies feature is being deprecated Codebeamer version 3.0.0.0 onward.
|
5. Select an item to associate with the current work item.
You have 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.