The object of this tutorial is to create reference connections between a SysML element and one or more existing JIRA issues. We will use the provided MagicDraw project JIRA Tutorial.mdzip. We also assume that the student has access to a JIRA repository and has the ability to create and edit issues within a JIRA project. For this demonstration, we have created three sample issues labeled as SDB-17, SDB-18 and SDB-19 within our Syndeia Demo Box project, but you may use any existing issues in your JIRA repository, instead.
Open the JIRA Tutorial project in MagicDraw. Right-click the JIRA Tutorial package and select Syndeia → Dashboard.
In the Repository Manager tab, create a link to the JIRA repository if one has not already been set up. Right-click on JIRA and select Add…. In the JIRA window that pops up, give the repository and identifying name and add url, user name and password for the repository to which you have access. Click OK.
If the connection is successful, the Syndeia dashboard should look similar to Figure 177.
Figure 177 Syndeia Dashboard, 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 178.
Expand the SysML model in the left pane to show the JIRA Test Block.
Select Reference under Connection Type in the middle pane.
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.
Figure 178 Syndeia Dashboard, Connection Manager tab
To see the reference connections that have been created, go to the Connection Summary tab on the Syndeia dashboard and click the Refresh button (see Figure 179)
Figure 179 Syndeia Dashboard, Connection Summary 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 and the JIRA issues will be opened in the default web browser (see Figure 180). Note: your JIRA interface may appear different depending on your configuration settings.
Figure 180 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 181 should appear.
Figure 181 JIRA Connected Issues Summary