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

  • Cameo System Modeler 18.0 - 19.0 (or MagicDraw with SysML plug-in) installed correctly on his or her machine with a valid license for use, and

  • Syndeia 3.4 installed as a plugin for Cameo/MagicDraw 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. Open the MagicDraw model DOORS NG Tutorial.mdzip. Find the Speed requirement in the Datamap Connection package, as shown in Figure 1.

    Figure 1  MagicDraw requirement

  2. If not still open from the previous exercise, open Syndeia_DNG_Mapping_Tutorial.mdzip (get it here - https://intercax.atlassian.net/wiki/spaces/SYN34/pages/2407364009), right-click the top-level package, and 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 Summary tab, after adding Data Map connection

  6. Return to MagicDraw to examine the original SysML requirement. As shown in Figure 5, it has an new Id, 2093, 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-NG_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 MagicDraw, 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 Datamap connection and select Compare Source and Target. In the Comparison Result tab, the difference in the text/description between the DOORS NG and MagicDraw 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 MagicDraw; it should have returned to 200 kph. Alternatively, if you select Sync SysML → Target, the requirement Description in DOORS NG should show 300 kph.