Skip to main content

Graph view

See an item and its traces as a diagram: expand along traces, filter trace types, spot missing, suspect and invalid traces, and open items from their nodes.

Written by Matthew Maclaine

Graph view draws items as boxes and traces as lines between them, so you can follow a requirement to what verifies it, what it derives from and what is still missing, without reading the trace list item by item. It is one of the three views of the items page; see View modes for the others.

Open any item and click View as graph in the page header. The graph is available on the items page only; baselines, reviews and test runs offer document and table views.

The graph view with a few expanded nodes

Reading the graph

The graph starts with just the item you opened. Each node shows the item's short ID, its title, its type icon and, when a variant is active, its variant membership dot. Hover the short ID to preview the item.

Traces run left to right: items that trace to the item appear on its left, items it traces to appear on its right. Lines with an arrowhead are directional traces, including parent and child; dashed lines without an arrowhead are undirected traces such as is related to. Hover a line to see the trace type; click it to keep the label showing.

Lines colored for a problem carry a label with the reason when clicked: Suspect for a trace whose other end changed since, Invalid trace for one that breaks a traceability rule. See Traceability for what these states mean.

Expanding and collapsing

A node with traces you have not expanded yet shows a + handle on the side where they are: left for incoming, right for outgoing. Click it to add the traced items to the graph. The handle turns into a to collapse them again. Items reached through more than one expanded node stay visible until every route to them is collapsed. The item you opened is always shown.

The graph lays itself out again after each change, keeping the node you last used in place so the picture does not jump.

Filtering traces

Use Filter traces at the top right to choose which trace types to draw. Pick one or more types, or ALL to reset. Hidden trace types also stop counting for the expand handles, so a node whose only traces are filtered out shows no handle.

Missing traces

By default the graph also draws the traces your traceability rules expect but that do not exist. They appear as a faded node labeled with the required item type and a placeholder ID such as TEST-xxxx, joined by a colored line. Hover the node for **Missing trace to ** and click **Add?** to open the **Add missing trace** screen in the sidebar, where you can pick a suggested item or create a new one that is traced immediately.

To hide them, click the gear next to Filter traces and switch Missing traces off under Show.

A missing trace node with its tooltip

Selecting and opening items

  • Click a node to select it and open the item details sidebar for that item. The node gets a highlighted border and a small sidebar icon while it is the one shown there. From the sidebar you can edit attributes, manage traces and use the ... menu of item actions.

  • Double-click a node to make that item the center of the graph, the same as opening it from the tree. Its parent is not selected automatically.

  • Drag a node to move it. Drag the background to pan, and use the mouse wheel to zoom.

The buttons at the bottom left zoom in, zoom out and fit the whole graph to the window. The graph shifts sideways when the sidebar opens so the selected node stays visible.

Exporting

The view settings gear in the page header offers Export to .docx, .xlsx or .reqif for the open item and its children. The export contains the items, not a picture of the graph. See Exporting items.

Did this answer your question?