Starting Point & Preparations
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)Select the project tab
Load the Codebeamer tracker Jama Connect project into the plug-in via the local menu and expand the tracer node by node.
Adding a link
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
Select a tracker item in the Codebeamer Jama Connect grid.
Select Add link in the local menu of the Codebeamer Jama Connect item. This will open the link definition window.
Check if source and target of the link as well as link type are set correctly.
Click generate link
Result: The Codebeamer 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 Codebeamer 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 Codebeamer 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
Hover on the requirement
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
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.
Select Remove.
Removing a link from the list of links in the context view
Hover on the SysML element (= source), for which you want to remove the link.
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 CodebeamerJama Connect. In both cases do the following:
Hover on the Codebeamer Jama Connect item, you want to navigate to.
Open the local menu and select Open in original tool. This will navigate you to CodebeamerJama 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 Codebeamer Jama Connect side, having opened the requirement in Item View you can inspect the list of links of the requirement in the Links 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
Click the + button.
Select a link type.
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.
Click generate link. This will add the link to the list of links.