Managing Traceability

Owned by Christoph Bergner
Last updated: Apr 10, 2023
3 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 Jama Connect project into the plug-in via the local menu and expand the tracer node by node.

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 Jama Connect grid.

  3. Select Add link in the local menu of the Jama Connect 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 Jama Connect 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

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 Jama Connect 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 Jama Connect 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.

Inspecting the delegated UI of a linked Jama Connect 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

  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 Jama Connect

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

  1. Hover on the Jama Connect item, you want to navigate to.

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

Inspecting the delegated UI of a linked Cameo item in Jama Connect

On the Jama Connect 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 Jama Connect 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.