Exercise 5.2 - SysML to DOORS NG.

Objectives

The new learning objectives of this exercise are to create a DOORS NG requirement from a SysML requirement using a Data Map connection. This exercise uses the default SysML-DOORS NG mapping. Custom mappings are demonstrated in Exercises 5.6 and above.

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 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. If not still open from the previous exercise, open the Rhapsody model Syndeia_DNG_Mapping_Tutorial.rpy (Get it here - SysML Models, Profiles and Mappings.). Find the 2093_Speed requirement in the Datamap Connection package, as shown in Figure 1.

    Figure 1  Rhapsody requirement

  2. Launch the Syndeia dashboard. In the Mappings tab, check that Use mapping is unchecked (Figure 2). Custom mappings will be demonstrated in Exercises 5.5 and above.

    Figure 2  Syndeia dashboard, Connection Manager tab, before Data Map connection

  3. In the Connection Manager tab, open the SysML model on the left side and find the Speed requirement. On the right side, choose a project in which to create a new DOORS requirement. In Figure 3, we use the Unmanned Aerial Vehicle project.

    Figure 3  Syndeia dashboard, Connection Manager tab, before Data Map connection

  4. To create a DOORS requirement via a Data Map connection,

    1. Set Connection Type to Data Map in center section

    2. Drag-and-drop Speed from the left side on top of the Unmanned Aerial Vehicle project on the right.

    3. Click Yes to confirm.

  5. To confirm that a connection has been made, go to the Connection Search tab and click Get All. It should appear similar to Figure 4.

    Figure 4  Syndeia dashboard, Connection Search tab, after adding Data Map connection

  6. Return to Rhapsody to examine the original SysML requirement. As shown in Figure 5, it has an new Id, 2066, assigned by Syndeia to be the same as the requirement ID created by DOORS NG for its new requirement. The element has also been assigned a new stereotype, <<DOORS_Requirement>> to reflect its Data Map connection to a DOORS NG requirement. These same effects would be seen (in the SysML requirement) if a DOORS requirement had been dragged into the SysML model.

    Figure 5  SysML requirement after Data Map connection

  7. In Rhapsody, change the value of the maximum speed to 300 in the Text field of the requirement.

  8. In the Syndeia dashboard, Connection Browser or Connection Search tab, right-click on the new Data Map connection and select Compare Source and Target. In the Comparison Result tab, the difference in the text/description between the DOORS NG and Rhapsody requirements should be highlighted in red.

    Figure 6  Syndeia dashboard, Connection Summary tab, after adding Data Map connection

  9. In the Syndeia dashboard, Connection Browser or Connection Search tab, right-click on the connection and select Sync Target → SysML. Check the requirement text in Rhapsody; it should have returned to 200 kph. Alternatively, if you select Sync SysML → Target, the requirement Description in DOORS NG should show 300 kph.