Objectives

The new learning objectives of this exercise are to create a network connection to a Jama repository and reference connections between existing SysML elements in Rhapsody and existing elements in Jama.

Preparation

This exercise assumes the student has

• IBM Rational Rhapsody 8.2 installed correctly on his or her machine with a valid license for use, and

• Syndeia 3.3 installed as a plugin for Rhapsody with a valid license for use

• Syndeia Jama interface, correctly installed with a valid license for user.

The user can use any Jama repository they have available. It is generally advisable to carry out these exercises in a non-production repository, a "sandbox", set up for training and practice purposes. Caution: Rhapsody has, by default, restrictions on the naming of SysML elements, which can create problems when Syndeia tries to create Rhapsody model elements that violate these restriction, e.g. beginning a SysML block name with a number. We recommend modifying any Rhapsody models you create to relax these restrictions. Modify the properties of the top-level package of the model under General::Model::NamesRegExp with the following string and save.

^(([a-zA-Z0-9_][a-zA-Z0-9_ ():-]*)|(operator.+))$

Exercise

1. Begin with a SysML project with a requirement structure in Syndeia_Jama_Mapping_Tutorial.rpy (or your own), right-click the top-level package, and launch the Syndeia dashboard (Figure 1). Create or select the Syndeia Cloud project in which to store the inter-model connections.

   

   Figure 1 Launching Syndeia dashboard

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

   

   Figure 2 Adding a Jama network connection
   

   

   Figure 3 Entering Jama repository info
   

3. Your repository should load and expand to show projects, components, sets, and requirements, as in Figure 4.

   

   Figure 4 Viewing Jama repository contents in Repository Manager tab

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 (Figure 5). These connections will show in the Connection Browser and Connection Search tabs and in the Syndeia graph analysis visualizations.

   

   Figure 5 Creating a Reference Connection