Associations
You can associate tracker items with other tracker items, forum topics, documents, source files, commits or external URLs. For example, an association enables you to define relationships between project plan documents and requirements, tasks or bugs. Associations are ad hoc relations between tracker items and any of the following:
• Other Codebeamer X entities (other items or documents)
• External web resources via a URL
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 given below:
1. Click + New Association 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 any of the following options as applicable:
◦ Reverse order: Select to interchange the associated item and the item for which you are creating an association.
◦ 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 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.
◦ Bi-direction: 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 Reverse direction and the Bi-direction options are enabled only if you select the Propagate suspects. 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.
|
◦ 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 direction option. 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.
4. Select an item to associate with the current work item.
You have the following options:
◦ From Recent: You can select an item from the list of items that you have recently worked on.
◦ From Search: You can search for an item in current Codebeamer X instance.
◦ URL: You create an association using an external link.
Parent topic