The SystemWeaver Jira integration is a plugin that offers a solid integration between your SystemWeaver database and your Jira tool making it easy to switch between the two applications with just one click. In this article, we'll describe how to use the SystemWeaver Jira extension view.

Prerequisites

  • An installation of the SystemWeaver swExplorer client, version R28 or later
  • The SystemWeaver SWExtension.Jira2.dll client extension is located in the Client's swExplorerExtensions directory
  • The SystemWeaver Jira integration has been installed, activated and configured by an Architect/IT Admin
  • The SystemWeaver swExplorerLauncher application is registered on user's machine (required for redirects from Jira to SystemWeaver)
  • You are logged in to Jira via SystemWeaver

Viewing all Linked Jira Issues

When you load the Jira view for an item type for which it is configured, you will be taken directly to the Current Issues tab. This tab will provide a list of all Jira issues linked to the selected item for the Jira instances that you are currently logged in to. The following issue information is retrieved from Jira and displayed:

  • Jira (The name of the Jira instance)
  • Project
  • Id
  • Type
  • Priority
  • Status
  • Assignee
  • Reporter
  • Created


Current Issues for Selected Item


You can sort the issues by clicking on the column headers and can rearrange the columns. However, all sorting and column order changes apply only to your current session and are not saved. 

In the above example, the user is logged in to two Jira instances - Jira1 and Jira2. And the selected requirement item "No drag" has Jira issues from both instances linked to it. Note that if the user was only logged in to Jira1, they would only see the issues from Jira1. The issues from Jira2 would be hidden from view. 


Tip: If your organization has more than one instance of Jira configured for use with the extension, be sure you are logged in to all instances if you wish to make sure that you are seeing all of the linked issues.

Redirect to Issue in Jira

By double-clicking on an issue in the Current Issues list, you are quickly redirected to the full record display of the issue in Jira.



Note: If you are not currently logged in to your Jira application, you will be prompted to log in.

Viewing All Linked SystemWeaver Items in Jira

To view the linked SystemWeaver items for a particular issue in Jira, click on the SystemWeaver tab in the Activity section. A list of all linked items will display along with information such as name, and, e.g., version, status, etc. (With R33 or later, the type of item information provided is, to some degree, configurable by a system administrator.) In the below example, the "Low speed emergency braking" issue has four linked items in SystemWeaver. 



Don't see a SystemWeaver tab? Contact your system administrator to confirm configuration.

Redirect to Item in SystemWeaver

Redirecting from an issue in Jira to a linked item in SystemWeaver is simple.  There are two options depending on whether you wish to view the item in a specific context or not. 


Open in New tab

To simply open the linked item in a new tab in SystemWeaver, click on the hyperlinked Name on the SystemWeaver tab in Jira. You will be redirected to the item in SystemWeaver. 


Open in Context

If you are already logged in to SystemWeaver and working in a structure and would like to view the item in the context of the structure, you can right-click on the Name hyperlink in Jira and copy the URL for the item to your clipboard. 



Then, you can do Ctrl+G in the structure to find the item there. 


Note: If you are not currently logged in to your SystemWeaver server, you will be prompted to log in.

Working with Jira Issues in SystemWeaver

The Jira extension view enables you to search for, open, create and link items to Jira issues, and update an issue's Epic link directly from SystemWeaver. This is done from the Jira tab in the view. The information in the top section of the tab is retrieved directly from Jira. The Items section in the bottom half of the tab displays a list of the items that are currently linked to the issue Id displayed in the top half. 


Tip: When you are working from this tab, it is helpful to treat it as if you are working directly in the Jira application. The focus of the tab is the Jira issue and not the SystemWeaver item. For example, although the user has the "Break for obstacle" requirement selected in the tree shown below, it is unrelated/not linked to the "ADLV3-127" issue that is in focus/selected on the Jira tab. The "ADLV3-127" issue has only one item linked to it ("Maintain cruise speed") and it is not the selected item in the tree.


To work with Jira issues in SystemWeaver, you must first select a Jira instance in the Current Jira drop-down field on the Jira tab. (Operations are only conducted against one instance of Jira.)


Searching for an Issue

To search for an issue in the selected Current Jira instance, enter a Jira Issue ID in the Select Jira Issue text box and click Select Issue. The issue information will load as shown in the above example. 


Your search is across the entire Jira instance and is not restricted by which item you have selected in the tree.


Opening an Issue

After searching for an issue, you then have the option to open the issue in the Jira application. To do this, click Open Issue. Again, you must first have the issue "loaded" to the Jira tab like "AD-LV3" shown below. You will be redirected to the full record display of the issue in the Jira application.


Creating an Issue

The Jira extension view enables you to create Jira issues from directly within SystemWeaver.  While searching and opening issues via the view is unrelated to which item you have selected in the tree, the Create Issue option will create an issue and link it to the selected item 

  1. Select the item for which you want to create an issue. 
  2. On the Jira tab, click Create Issue
  3. In the pop-up dialog, enter an Issue Name. By default, it will pre-populate with the name of the selected item in the tree, but it can be modified.
  4. Choose a Jira Project and Issue type.

    Note: Only projects configured for use with SystemWeaver will be available for selection if you are running version R33 or later. With earlier versions, if you have issues selecting a project, contact your system administrator.

  5. If the Floating option is available and you want the issue to also float forward and be linked to new versions of the selected item that may get created, check the Floating box to turn floating on for this issue.

    Floating Option (available with release R33 and later)
    Floating means that a Jira issue will be linked to the selected version of a SystemWeaver item and will also float forward to later versions. Depending on the Jira integration configuration being used, users may be able to choose to create a floating relationship or not in the provided UI for creating Jira issues via SystemWeaver. If floating is not available in your installation, the option will be grayed out.
  6. Click Create Issue. A Creating issue progress bar indicates that your request is being processed. The newly created issue will load to the Jira tab as highlighted below.


Creating a Sub-task

It is also possible to create sub-tasks in Jira using SystemWeaver. 

  1. Select the item in the structure tree that you want the sub-task to be linked to. 
  2. Select the Jira issue (as described above under Searching for an Issue) which the new issue will be a sub-task of. 
  3. Click Create Sub-task

  4. In the Create sub-task dialog, enter the Sub-task name, select the Project, and type of sub-task and click Create sub-task


The new sub-task issue will be created in Jira as a sub-task to the selected Jira issue, and simultaneously be linked to the selected item in SystemWeaver. 



Note: Sub-tasks cannot be created for sub-tasks as shown in the below example. The option will be grayed out.


Changing the Floating Option

You can change the Floating setting on a Jira issue at any time. 

  1. Select the Jira issue so that it is loaded to the Jira tab.
  2. Make your change to the Floating setting.
  3. Click Update Issue.


Linking an Issue to SystemWeaver Items

When creating a new Jira issue, you are simultaneously linking it to the selected item in the tree. The view also enables you to link an existing Jira issue to one or more items. 

  1. Search for the Jira issue so that it is loaded to the view as ADLV3-146 in the above example. 
  2. Next, select the SystemWeaver item that you want to link the issue to. When you do this, the item will appear in yellow in the Items section of the view. In the below example, ADLV3-146 is loaded to the view (it already has one item linked to it called "Brake for obstacle-straight") and the "Emergency braking" item has been selected in the tree:
  3. Additional items can also be selected in the same way. 
  4. When you are ready to perform the link of the items to the issue, click Update Issue to the far right. The items staged for linking are now linked to the issue in Jira. You will receive a confirmation that the issue was updated.

By selecting a Jira Issue and clicking Update Epic link, an Epic link can be changed or added

  1. Select the Jira Issue for which you want to add or change the Epic link. In the below example, Jira issue ADLV3-35, a Story issue, is selected.
  2. Click Update Epic link.
  3. In the dialog, enter the ID of the Epic which should be linked to the selected Issue.
  4. Click Update Epic link to confirm the action.


    The Epic can now be found in the Epic Link property of the issue on the Jira tab.



To clear an Epic Link, follow the same steps described above, but clear the ID in the Update Epic link dialog and click Update Epic link.


Removing Items from a Jira Issue

At any time, you can remove one or more SystemWeaver items from a selected Jira issue. 

To do this, right-click on the item(s) and select Remove from list, and then click Update Issue.


Multi-select is supported by clicking while holding down the Shift key (for selecting adjacent items) or Ctrl key (for selecting non-adjacent items).


Note: It is currently not possible to delete issues in Jira using the SystemWeaver extension view.

Watch a Demo