Syndeia 3.3 (Plugin for Rhapsody)
Tutorial Exercise 7.1
Creating a SysML – Jama Reference Connection

Revision Date: July 8, 2020

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

• Anchor
  _Hlk44840893 _Hlk44840893

  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.

   Image Added

   Anchor _Ref481833169 _Ref481833169 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).

   Image Added	Image Added
   Anchor _Ref481833397 _Ref481833397 Figure 2 Adding a Jama network connection	Anchor _Ref481833414 _Ref481833414 Figure 3 Entering Jama repository info

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

   Project Component Set Requirement Image Added

   Anchor _Ref481833841 _Ref481833841 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.

   Image Added

   Anchor _Ref481834093 _Ref481834093 Figure 5 Creating a Reference Connection