Managing Traceability in Cameo Systems Modeler

Owned by Christoph Bergner
Last updated: Jul 02, 2023
4 min read

Starting Point & Preparations

  1. Make sure the the Smartfacts plug-in is loaded and visible
    Sometimes Cameo does not show plug-ins, even if they are loaded and docked into the UI. In this case, open Window > Reset Windows Configuration in Cameo (Ctrl + Shift + W)

  2. Select the project tab

  3. Load the Codebeamer project into the requirements grid via the local menu of the Codebeamer project reference in the Smartfacts project tree.

  4. Select a tracker from the drop-down to load the first level of tracker items into the plug-in via the local menu and expand the tracker node by node.
    Alternatively, you can also use the Show Hierarchy command in the local menu of the requirements grid to show the full requirements document.

Adding a link

  1. Open a diagram and select a Cameo item you want to link. You may also select a Cameo element in the model tree or you may select the frame of the diagram if you want to link the whole diagram

  2. Select a tracker item in the Codebeamer grid.

  3. Select Add link in the local menu of the Codebeamer item. This will open the link definition window.

  4. Check if source and target of the link as well as link type are set correctly.

  5. Click Generate Link

  6. Result: The Codebeamer item has gotten a vertical grey bar, which indicates that the item has OSLC links. If you hover on the grey bar, you will see which elements have been linked to this item.

Inspecting the links in context of the current diagram: The context view (links tab)

Switch to the links tab and examine the list of links. Each link shows the source (SysML element) marked with an S and the target (requirement) marked with a T. On both, source and target, you can apply various commands via the local menu.

Commands of the Source Element (SysML element)

  • Remove: This command removes the link.

  • Open in Project Tree: This command switches to the project tree and expands the SysML model in the model tree of the SysML element.

  • Find in Project: This command searches for the element or diagram in the original model and expands the Cameo model tree at the right node.

  • Open in Smartfacts: This command navigates to Smartfacts and opens the published diagram or model element.

Commands of the Target Element (Requirement)

  • Open in original tool: This command navigates to Codebeamer with the right project loaded, with the right tracker loaded and the right requirement selected.

  • Open in local viewer: This command opens a window and loads the delegated UI of the Codebeamer requirement in Cameo. All attributes are listed in the delegated UI.

  • Expand requirements tree: This command switches to the requirements grid tab, loads the right tracker into the grid and expands the corresponding node in the hierarchy.

Commands of the local menu of the Links tab

  • Show graph: This command shows a graph of all linked elements and requirements.

  • Show only linked elements: This command shows the same graph as before. The graph is reduced to model elements of the diagram that are linked.

  • Stereotypes: This menu items allows to filter the list of links in the links tab and in the graph by selected stereotypes.

  • Link Types: This menu items allows to filter the list of links in the links tab and in the graph by selected link types.

Inspecting the delegated UI of a linked Codebeamer Item in the links tab

  1. Hover on the requirement

  2. Open the local menu and select Open in Local Viewer. This will open a window and load the delegated UI of the requirement.

Removing a link from an item in the grid

  1. Hover on the vertical grey bar of the requirement in the grid. Open the local menu of the SysML diagram or element for which you want to remove the link.

  2. Select Remove.

Removing a link from the list of links in the context view (links tab)

  1. Hover on the SysML element (= source), for which you want to remove the link.

  2. Open the local menu for that element and select Remove.

Navigating from Cameo to Codebeamer

You can navigate to the requirements grid (grid tab) or from the list of links (links tab) to Codebeamer. In both cases do the following:

  1. Hover on the Codebeamer item, you want to navigate to.

  2. Open the local menu and select Open in original tool. This will navigate you to Codebeamer, into the right project, into the right tracker with the right requirement selected.

Inspecting the delegated UI of a linked Cameo item in Codebeamer

On the Codebeamer side, having opened the requirement in Item View you can inspect the list of links of the requirement in the Links tab.

If you switch to Document View, you see the list of links of the selected requirement under the Smartfacts plug-in tab.

Hover on the title of the link to open the delegated UI of the SysML diagram or model element.

Adding a link on the Codebeamer side

  1. Click the + button.

  2. Select a link type.

  3. Make sure that the right OSLC artifact container is selected. This will load the delegated search & select UI. You can search, navigate, pick from the list of favorites or recently opened artifacts.

  4. Click generate link. This will add the link to the list of links.