...
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.
...
In the Syndeia_JIRA_Mapping_Tutorial project, in the JIRA Activity Structure package, a multi-level activity structure has been created. The model as it appears in the containment browser is shown in Figure 1. In the two activity diagrams in Figure 2, we can see that the top-level activity, UAV Project, is decomposed into three actions typed by the activities Task 1, Task 2 and Task 3. Task 1 is further decomposed into three actions typed by Subtask 1A, Subtask 1B and Subtask 1C.
Figure 1 UAV Project activity
Figure 2 SysML Activity Model
If not already open from the last exercise, launch the Syndeia dashboard. Select a Syndeia Cloud project, if needed.
Go to the Settings tab. Under General, make sure Use mapping is unchecked. Click Apply if a change was made.
In the Syndeia dashboard, Connection Manager tab,
select and expand the JIRA repository in which the new task structure will be created on the right
select the JIRA SysML repository on the left
Set the Connection Type to Reference
Drag the top-level activity UAV Project (in the SysML model shown in the left pane) on to the JIRA project in which the Tasks are to be created.
In the Options window that appears (Figure 3), select Generate issue(s) and create reference connection(s). Click OK.
Figure 3 Connection Manager tab, after dragging UAV Project onto Syndeia Demo Box JIRA Project
The new reference connections are shown in Figure 4. Note that each activity used in UAV Project is now connected to a corresponding JIRA task issue.
Figure 4 Viewing new Reference Connections between SysML Activities and JIRA issues
Close the Syndeia dashboard. From the MagicDraw containment browser, right-click the activity Task 1 and select Syndeia → Open Connected Artifacts. Check the connected target desired and the corresponding JIRA issue opens in the JIRA interface (see Figure 5).
Figure 5 JIRA interface, Task 1 issue
Note at the bottom of Figure 5, this issue is shown as linked to the issue for the higher-level activity UAV Project and the three lower-level activities, Subtask 1A, Subtask 1B and Subtask 1C. While JIRA does not support an "issue hierarchy" exactly like the activity structure in SysML, Syndeia uses the "relates to" issue link to create a corresponding network of connections.
This process just demonstrated creates reference connections from SysML to JIRA for activity, block or requirements structures. A more powerful set of connections can be made if the SysML block structure is composed of blocks with the applied stereotype <<JIRA_Issue>> and the Model Transform connection type is used for the drag and drop action. In this case, the connection created between each block and its corresponding issue are of the same type as in Exercise 8.2, where attributes such as status, assignee, and so forth can be compared and updated between SysML and JIRA. You may try this using the block structure in the package JIRA WBS Structure and a JIRA project of your choice. In this use case, the SysML block structure and connected issues are acting as a Work Breakdown Structure within the SysML model for project management purposes.
Exercises 8.1 through 8.3 use the default SysML-JIRA mapping for Syndeia. Even more flexibility is available through the custom mapping features introduced in Syndeia release 3.2 and extended in 3.3. See exercises 8.4 – 8.7 for examples.
...