Creating a SysML – Jama Reference Connection

1. Begin with a SysML project with a requirement structure in Jama_Tutorial.mdzip (or your own), right-click the top-level package, and launch the Syndeia dashboard.
   
   

   
   

2. To connect to Jama, right-click the Jama category under Repositories in the Repository Manager tab and select Add…, then enter a name, your own Jama URL and credentials, and click OK.
   
   
   

   
   

   
   

   
   

3. Your repository should load and expand to show projects, components, sets, and requirements.
   
   
   
   
4. To connect ANY SysML element to ANY Jama element (without exchanging data), select Reference for Connection Type and drag the element on one side onto the element on the other you wish to connect. These connections will show in the Connection Browser and Connection Summary tabs and in the Syndeia visualizations.
   
   

SysML to Jama Requirement Transform

1. Open the Jama_Tutorial model and launch Syndeia from the Jama Connections folder, if not already open from the previous exercise. Go to the Connection Manager tab on the Syndeia dashboard, expand the SysML tree on the LHS, and select your Jama repository from the drop-down menu on the RHS.
   
   
   

   
   

2. With Model Transform Connection Type selected, drag and drop the top-level requirement (System Requirement Spec) from SysML to a Jama project or component and click ‘Yes’ when prompted  (we use empty Jama_Tutorial component).
   
   
   
   

3. If dropped onto a Jama project, Syndeia creates an auto-named set (called “Architectural Requirements”) and a component to contain the set (called “System Architecture (SysML)”) and then creates requirements inside the set. If dropped directly onto an existing component, Syndeia creates an auto-named set (called “Architectural Requirements”) and then creates requirements inside the set. Expand the new component/set to view the new requirements.
   
   

   Figure 3 Syndeia dashboard showing new Jama requirements, set and component on RHS
   
   

4. Right-click > Open to view the new requirements directly in the Jama interface.
   
   
   
   Figure 4 Jama web interface showing one of the new requirements
   
   

5. Go to the Connection Browser tab in Syndeia and right-click > Refresh, then right-click > Expand All to view the model transform connections that were created between SysML and Jama.
   
   

Jama to SysML Requirement Transform

1. Open the Jama_Tutorial model and launch Syndeia from the Jama Connections folder, if not already open from the previous exercise. Go to the Connection Manager tab on the Syndeia dashboard, expand the SysML tree on the LHS, and select your Jama repository from the drop-down menu on the RHS.
   
   

   
   

2. With Model Transform Connection Type selected, drag and drop either a set or a requirement from Jama to a SysML package, and click ‘Yes’ when prompted (Figure 2). We are using the same requirement structure (System Requirement Spec) created in the previous exercise, but any similar structure could be used.
   
   
   
   
3. Expand and view new SysML requirements both in the Connection Manager’s SysML tree as well as in the Containment tree.
   
   
   
   

Jama - SysML Compare & Sync

1. This exercise assumes the user has completed either Exercise 7.2 or 7.3 and created a set of linked requirements between the SysML model Jama_Tutorial.mdzip and their Jama repository. In this example, we used the conditions after Exercise 7.2.
2. In the Connection Browser tab on the Syndeia dashboard, select the Regulatory Requirements connection created in either exercise. Right-click and compare across that connection before any changes have been made to see that all is in sync.
   
   
   
   
3. The Comparison Result tab will open and the results should appear.
   
   
   
   

4. Modify the Regulatory Requirements text field in Rhapsody and add a sub-requirement, FCC Regulations.
   
   
   
   

5. Compare across the same connection as in Step 2 and display the comparison results.
   
   
   
   
6. Return to the Connection Browser, click Refresh to show the new child requirement, right-click the Regulatory Requirements connection and select Sync SysML -> Target.
   
   
   
7. Repeat the comparison as in Step 2 and check that the Comparison Result shows all green.
   
   
   
   
8. Check the same requirement in Jama through its web interface to see the modified requirement text and sub-requirement.
   
   
   
   
9. While in the Jama interface, modify the requirement text again and add one more sub-requirement called Communications Requirement.
   
   
   
   
10. Repeat the comparison as in Step 5 to see the changes.
    
    
    
    
11. In the Connection Browser, right-click the Regulatory Requirements connection and select Sync Target → SysML.
    
    
12. View the new requirement and updated text in the Rhapsody mode.