Objectives
The new learning objectives of this exercise are to compare connected requirements models in Jama and Cameo/MagicDraw (via custom mappings) and to synchronize changes that have arisen. These changes will be demonstrated by both adding and removing Jama requirements, comparing those changes in Syndeia client, and syncing both to Jama connect and SysML.
...
Part 1: Sync SysML to Jama
Transform requirements from Jama to SysML using custom mappings
Add requirement in SysML, compare result, and sync to Jama
Delete requirement in SysML, compare result, and sync to Jama
Part 2: Sync Jama to SysML
Add requirement in Jama, compare result, and sync to SysML
Delete requirement in Jama, compare result, and sync to SysML
Preparation
This exercise assumes the student has:
Cameo System Modeler 19.0 (or MagicDraw with SysML plug-in) or later installed correctly on his or her machine with a valid license for use.
Syndeia 3.6 or later installed as a plugin for Cameo/MagicDraw with a valid license for use.
Jama repository (server) that can be connected over the network from the Syndeia Repository Manager.
...
A mappings file, syndeia34Tutorial.mappings (get it here -SysML Models, Profiles and Mappings), which contains the specific starting mappings used in this and the following exercises. To install this,
Close MagicDraw, if it is open
Rename the existing syndeia.mappings file in the .syndeia folder to something like syndeiaOld.mappings
Copy syndeia34Tutorial.mappings into the .syndeia folder
Rename syndeiaTutorial.mappings as syndeia.mappings
When you have completed the mapping tutorial exercises, you may want to reverse this process to restore the original mappings file.
A mappings profile,Syndeia_Mapping_Tutorials_Profile.mdzip (get it here -SysML Models, Profiles and Mappings), which is loaded automatically with the SysML project Syndeia_Jama_Mapping_Tutorial.mdzip and can be used with other projects.
Exercise
Part 1 - Add/delete requirement in SysML and sync to Jama
This exercise assumes the user has access to the SysML model Syndeia_Jama_Mapping_Tutorial.mdzip (get it here -SysML Models, Profiles and Mappings) and their Jama repository.
Go to the Settings tab (Figure 1) and check the Use mapping element under the General heading, if not already checked. Click Apply.
...
The first task is to drag a hierarchy of Jama requirements into Cameo to create an equivalent requirements structure using the custom mapping shown above. An example Jama structure ‘Product Spec’ is shown below in Figure 3.
...
Go to the Connection Manager tab on the Syndeia dashboard, expand the SysML tree on the LHS, and select your Jama repository from the drop-down menu on the RHS as shown in Figure 4.
With Model Transform Connection Type selected, drag the Product Spec Jama requirement onto the empty Cameo Package ‘From Jama’.
Select the mapping spec ‘Requirement - Requirement (attributes)’ and click OK.
...
We can view the new Cameo SysML requirements created by expanding the left side of the Connection Manager generated by Syndeia in Cameo’s containment tree, as shown in Figure 5.
...
In the Connection Browser tab on the Syndeia dashboard, select the Product Spec connection created. Right-click and compare across that connection before any changes have been made to see verify that all is in sync (Figure 6).
...
Modify the ‘Product_Spec' text field in Cameo /MagicDraw and add a sub-requirement, 'Feature_1_Safety’, as shown in Figure 8.
...
View the same requirement in Jama through its web interface to see the modified requirement text and sub-requirement (Figure 12).
...
Now, return to Cameo /Magicdraw and in the containment tree delete a child requirement underneath Product_Spec as shown in Figure 13.
...
After Syndeia is finished syncing, check that the Requirement no longer shows in Jama Connect as shown in Figure 16.
...
Part 2 - Add/delete requirement in Jama and sync to SysML
In Jama, modify the text of ‘Product_Spec’ and add a new Requirement (Feature_1_Maintenance) underneath it as shown in Figure 17.
...
From the Connection Browser tab, right click the connection and select ‘Sync Target to Source’ as shown in Figure 19.
...
Return to Cameo /Magicdraw and verify that the new changes have been made in the containment tree and properties shown in Figure 20.
...
Check in Cameo that the Requirement ‘Feature_1_Environmental’ has been moved to the Parent Package level in the Containment Tree as shown in Figure 24.
...
...
This specific feature will be extended in future Syndeia releases with a setting to allow the user to either delete the requirement or move it to the parent level in SysML
...
not delete it. The latter use case is for scenarios where the given requirement may have relations from/to other elements and the user may decide to not delete it, or refactor the model and then delete. Currently, Syndeia moves the requirements to the parent package and does not delete it during sync when using custom mappings specifically to address this scenario. For any questions, please reach us on our helpdesk.
Compare the connection from Syndeia one last time to check that everything is showing green.
...