The Traceability Window

Using the Traceability window you can quickly see how elements are connected and how they influence each other. You can:

  • Locate related elements in the Project Browser
  • View the properties of related elements
  • Open the diagrams in which related elements are used
  • Add related elements to the current diagram
  • View the source code for related elements
  • Change the display using the window toolbar options

When an element is selected, it immediately becomes the top point in the Traceability window. When a diagram is selected, all elements in the diagram are listed in the Traceability window, so you can use any of them as a starting point.

Access View | Traceability (Ctrl+Shift+4)

Tools | Specification Manager: | Open Relationship Matrix | Traceability

Traceability window toolbar options



See also

Locate Element

Click on this icon to make the selected element the focus of the Traceability window and to show all relationships and elements with which the selected element forms a relationship chain.

Click on the diagram to list all elements in the diagram.

Related Element Properties

Click on this icon to display the element 'Properties' dialog for the currently-selected element in the Traceability window.

Find Element Usage

Click on this icon to display the 'Element Usage' dialog, listing all diagrams in which the currently-selected element is used.

(Shortcut keys: Ctrl+U)

Show Element Use

(Relationship selector)

Click on the drop-down arrow and select the checkbox against each relationship type to include in the trace shown in the window:

  • Generalizations
  • Aggregations
  • Nesting
  • Realizations
  • Dependencies
  • Transitions

Other (unspecified) links such as:

  • Associations
  • Use Cases
  • Delegates
  • Assemblies
  • Deployments
  • Information Flows
  • Manifests
  • Classifiers - where an element is used as the classifier of another element
  • Embedded Element Re-uses - where a Port or Part is also represented in another part of the model
  • Transformations - where an element is created by running a Transformation from another element
  • Custom References that have been added between elements
  • Tagged Value References - showing elements that are the targets of Tagged Value references
  • Qualified Names - element names including the names of owning objects

Set Up Cross References Inherited and Redefined Ports Model Transformation Generalization Transition Dependency Configure Diagram Display Aggregation Realization Classifiers and Instances Nesting


Click on this icon to display this Help topic.


  • To make it easier and faster to find the elements you are interested in, restrict the relationship types shown to the smallest set of relevant types
  • As an alternative view, or to include the traceability information in documentation, you can develop a Traceability diagram using the Traceability window
  • The Traceability window does not currently recognize extended relationship types defined by Technologies such as BPMN or Archimate; relationships defined by a Profile or Technology are identified using their base UML type, so, for example, Archimate 'Realization' and 'UsedBy' relationships are each reported as UML 'Dependency' relationships

Learn more