Jama is a web-based repository for requirements management and systems engineering. Syndeia 3.1 offers an interface between MagicDraw and Jama. This tutorial offers short exercise demonstrating
- Creating a link to a Jama repository
- Creating reference connections between MagicDraw SysML and Jama elements
- Transforming multi-level requirements models in MagicDraw to Jama
- Transforming multi-level requirements models in Jama to MagicDraw
- Comparing and syncing requirements models between Jama and MagicDraw
To complete the tutorial exercises as shown, the user should start with the MagicDraw SysML 18.4 model Jama_Tutorial.mdzip
Adding a Jama Repository Link
Open the SysML project, Jama_Tutorial.mdzip (or your own) in MagicDraw, right-click the top-level package, and launch the Syndeia dashboard.
To connect to Jama, right-click the Jama category under Repositories in the Repository Manager tab and select Add…, then enter a name, your own Jama URL and credentials, and click OK.
3. Your repository should load and expand to show projects, components, sets, and requirements.
Creating a SysML – Jama Reference Connection
If you want 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.
Creating Jama Requirements from MagicDraw
Select the Connection Manager tab, expand the SysML tree on the LHS, and select your Jama repository from the drop-down menu on the RHS.
Select Model Transform under Connection Type in the central column. Drag and drop the top-level requirement from SysML to a Jama project or component and click ‘Yes’ when prompted.
If dropped onto an existing component, Syndeia creates an auto-named set (called “Architectural Requirements”) and creates the requirements within this set. If dropped onto a project, Syndeia creates a component (called “System Architecture (SysML)”) as well as the "Architectural Requirements" set and requirements.
Expand the Jama hierarchy on the RHS of the dashboard to view the new requirements. Right-click a requirement on the RHS and select Open to view in the Jama web browser.
Creating SysML Requirements from Jama
Go to the Connection Manager. Drag and drop either a set or a requirement from Jama to a SysML package, and click ‘Yes’ when prompted.
Expand and view the new SysML requirements in the SysML tree on the LHS of the Connection Manager and/or the Containment tree in MagicDraw.
Comparing and Syncing Between MagicDraw and Jama
In MagicDraw, modify the Jama_Tutorial model
Change the text of the Regulatory Requirements requirement.
Create a new requirement under Regulatory Requirements, e.g. FCC Regulations.
On the Connection Browser tab of the Syndeia dashboard, expand the SysML model to find the connector under Regulatory Requirements. Right-click the row and select Compare SysML & Target.
The difference table will appear under the Comparison Result tab.
Return to the Connection Browser tab and refresh the SysML hierarchy to display the new child requirement "FCC Regulations". Right-click the connection again and select Sync SysML -> Target
Run another Compare SysML & Target as in Step 2 above and check that the SysML and Jama models for Regulatory Requirements are the same.
Open Regulatory Requirements in the Jama web browser and check the changes there, as well.
While in the Jama web browser, make additional changes to Regulatory Requirements: change the Description and add a new child requirement, "Communications Requirements" in our example.
Re-run Compare SysML & Target on the Regulatory Requirements connector, as in steps 2 and 5.
Return to the Connection Browser tab, right-click the Regulatory Requirements connector again and select Sync Target -> SysML. The resulting SysML model should show the changes. A final Compare SysML & Target should show no differences between Regulatory Requirements in SysML and Jama.
