Syndeia 3.3 (Plugin for Rhapsody)
Tutorial Exercise 5.1
Creating a SysML – DOORS NG Reference Connection

Revision Date: July 5, 2020

Objectives

The new learning objectives of this exercise are to create a reference connection between an existing SysML element in Rhapsody and an existing requirement in DOORS NG (DNG)and use it to open the DOORS NG web interface from the connected requirement in Rhapsody.

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 DOORS NG interface, correctly installed with a valid license for user.

The user can use any DOORS NG repository network connection 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.

Exercise

1. Begin with a SysML project with a requirement structure in Syndeia_DNG_Mapping_Tutorial.rpy, 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 DOORS NG, right-click the DOORS category under Repositories in the Repository Manager tab and select Add… (Figure 2), then enter a name, your own DNG 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. Go to the Syndeia dashboard, Connection Manager tab. On the right side, select the DOORS NG repository and expand to show at least one requirement. In Figure 4, we will use 1517 – UAV Requirement (or any DNG model element accessible in your repository). On the left side, select the SysML model and expand it to show DOORS NG Tutorial::Reference Connection::cUAV.

1. To create a reference connection between cUAV and 1517 – UAV Requirement.
   1. Set Connection Type to Reference in center section
   2. Drag-and-drop cUAV from the left side on top of the 1517 requirement on the right side (or the reverse).

1. To confirm that a connection has been made, go to the Connection Search tab and click Get All. It should appear similar to Figure 5. Click the Columns to Display icon to modify table organization.

1. From the Entire Model View Browser in Rhapsody, right-click the cUAV block and select Syndeia → Open Connected Artifact. The DOORS NG interface should open to the connected requirement in your default web browser, as in Figure 6.

1. Edit the DNG requirement in the web browser and save to create a newer version. In the Connection Search tab of the Syndeia dashboard, right-click the new reference connection and select Compare Source and Target. The Comparison Result tab should be similar to Figure 7. Hover over the Comment field to see that the red color indicates that a newer version of the DOORS requirement now exists.

1. To update the reference connection, right-click on it in the Comparison result tab (or where it is shown in the Connection Search or Connection Browser tabs) and select either Sync Source -> Target or Sync Target -> Source.