Syndeia 3.3 (Plugin for MagicDraw)
Tutorial Exercise 8.1
Creating a SysML – JIRA Reference Connection
| 47 Perimeter Ctr E, Suite 410 |
...
Objectives
The new learning objectives of this exercise are to create reference connections between SysML elements and JIRA issues.
...
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.3 installed as a plugin for Cameo/MagicDraw with a valid license for use
Syndeia JIRA interface, correctly installed with a valid license for user.
We will use the provided MagicDraw project Syndeia_JIRA_Mapping_Tutorial.mdzip. The user can use any JIRA repository they have available with the ability to create and edit issues within a JIRA project. It is generally advisable to carry out these exercises in a non-production repository, a "sandbox", set up for training and practice purposes.
For this demonstration, we have use three sample issues labeled as SDB-1845, SDB-1846 and SDB-1847 within our Syndeia Demo Box project, but you may use any existing issues in your JIRA repository, instead.
Exercise
...
Open the SysML project Syndeia_JIRA_Mapping_Tutorial.mdzip, right-click the top-level package, and launch the Syndeia dashboard (Figure 1). Select a Syndeia Cloud project, if needed.
Anchor _Ref481833169 _Ref481833169
Figure 1 Launching Syndeia dashboard
To connect to JIRA, right-click the JIRA category under Repositories in the Repository Manager tab and select Add… (Figure 2), then enter a name, your own Jama URL and credentials, and click OK (Figure 3).
Anchor _Ref481833397 _Ref481833397 
Figure 2 Adding a JIRA network connection
Anchor _Ref481833414 _Ref481833414 
Figure 3 Entering JIRA repository info
Your repository should load and expand to show projects and issues, as in Figure 4.
Anchor _Ref481833841 _Ref481833841 
Figure 4 Viewing JIRA repository contents in Repository Manager tab
To create a reference connection between a SysML element and a JIRA issue, go to the Connection Manager tab on the Syndeia dashboard, as in Figure 5.
Figure 5 Syndeia Dashboard, Connection Manager tab
Load and expand the SysML model in the left pane to show the JIRA Test Block.
Select Reference under Connection Type in the middle pane.
Load the JIRA repository and expand the Issues folder in the right pane to show the issues to be connected.
Drag and drop JIRA Test Block from the left pane on top of an issue in the right pane to connect them. Repeat to connect additional issues.
...
...
To see the reference connections that have been created, go to the Connection Search tab on the Syndeia dashboard and click the Get All button (see Figure 6).
...
...
Figure 6 Syndeia Dashboard, Connection Search tab
The reference connections can be used in a number of ways by Syndeia. Close the Syndeia dashboard. To open a JIRA issue directly from MagicDraw, right-click on JIRA Test Block in the containment browser and select Syndeia → Open Connected Artifacts. Because there are three connected issues, a small window with three check boxes appears. Check one of the JIRA issues will be opened in the default web browser (see Figure 7). Note: your JIRA interface may appear different depending on your configuration settings.
...
...
Figure 7
...
JIRA web interface
Alternatively, the reference connections may be used to display a summary of all the connected issues. Right-click on JIRA Test Block in the containment browser and select Syndeia → Summarize Connected Artifacts. A window similar to Figure 8 should appear.
...
...
Figure 8 JIRA Connected Issues Summary