Justinmind

SUPPORT

Learn how to prototype web and mobile apps

Justinmind’s integration with Atlassian Jira

Justinmind Enterprise is integrated with Atlassian Jira, allowing Justinmind Enterprise users to import and export their Jira issues to and from Justinmind.

Important:

  • This is only available to Justinmind Enterprise users
  • Jira issues are referred to as requirements when imported into Justinmind
  • Justinmind requirements are referred as issues when exported to Jira

Configuring the integration of a prototype with a Jira project

The first thing you’ll need to do is to configure the Jira plug-in for Justinmind. With your Justinmind prototype open, go to ‘Plug-ins’ in the top menu. Select ‘JIRA’ and then ‘Configure’.

justinmind-for-jira-configure-plugin-1

You’ll need to fill in the following information. Note that you must fill in all fields to be able to import Jira issues into Justinmind and export Justinmind requirements to Jira issues.

justinmind-for-jira-plugin-configuration-1

  • Username
  • Password
  • URL of your Jira dashboard (for example https://accountname.atlassian.net. – there’s no need to add anything after the domain name)
  • Project Key – this is the abbreviated name of the Jira project can be found here. In our example, our Project Name is ‘Banking App Design’, and our project key is ‘BAN’.
  • JQL – in our example our JQL is ‘Project = BAN’. Find more info on constructing a JQL here.

If you want your requirements to take on the Jira column settings, tick the ‘Use JIRA requirements configuration’ option. Untick this option if you want to use Justinmind’s column settings.

When you’ve filled in the information, click OK.

Justinmind for Jira add-on: Improve the integration experience (recommended)

We strongly recommend you install the Justinmind for Jira add-on if you want the 360º experience of the integration.

When in Jira, if you want to view the prototype associated with a Jira issue, you’ll need the Justinmind for Jira add-on.  Note that only administrators will be able to install the add-on.

justinmind-for-jira-install-add-on-2

To install the Justinmind add-on log in to your Atlassian Jira account. From the Settings drop down, select ‘Add-ons’ under ‘Jira Administration’.

You will be taken to the Atlassian Marketplace for Jira. Search for ‘Justinmind’ and install the Justinmind for Jira add-on.

justinmind-for-jira-manage-add-on-1

You can manage your Justinmind add-on for Jira in the Add-ons tab of the Jira Administration menu.

Importing Jira issues into Justinmind

To import your Jira issues into Justinmind, return to Justinmind. In the Requirements module, go to ‘Plug-ins’ from the top menu. Click on the option ‘Import Requirements’. If importing has been successful, you’ll see your Jira issues appear in the Requirements module.

justinmind-for-jira-import-requirements-1

By default, the two Jira-Justinmind synced columns are Name & Description. There is also a URL, which when clicked on, will take you back to the corresponding Jira issue, within Jira. This URL is available both in the Requirements and User Interface modules.

Updating modified Jira issues in Justinmind

Note that if you edit a Jira issue in Jira, you can view modifications in Justinmind by returning to the Plug-ins menu option and clicking ‘Import Requirements’ again.

Linking Jira issues to your prototype’s UI elements

Once you’ve imported your Jira issues into Justinmind, you can link the issues (as Justinmind requirements) to elements in the user interface. To do so, navigate to the User Interface module.

Select the element that you wish to link to a Justinmind requirement. Below the canvas, select the Requirements palette (hint: the default view will be the Comments palette, with the Requirements palette next to it on the right). Select the ‘Show all’ option. Then, simply drag the requirement from the list and drop it on top of the element in the canvas.

How to view a Jira issue from a requirement of your prototype

Click ‘Simulate’ in the top right-hand corner of the screen to view your prototype. On the right, you’ll find the Requirements panel (below to the Screens panel).

justinmind-for-jira-view-prototype-1

Click on the linked requirement and you’ll find an option to ‘View component’ on the left. Click to see the linked element highlighted in green.

How to view a Jira issue related with the requirement

In the Simulation window, click on a linked requirement. Select ‘View in JIRA’.

Exporting Justinmind requirements to Jira issues

To view your Justinmind requirements in Jira, you will need to export the requirements back to Jira.

justinmind-for-jira-export-requirements-1

To export requirements follow this steps:

  1. Make sure the latest version of your prototype has been shared online in order to have access to your prototype from the Jira project.
  2. Navigate to the Requirements module and then select ‘Plug-ins’ from the top menu. Select ‘JIRA’ and then ‘Export Requirements’. This action will sync your Justinmind requirements with the associated Jira issue in Jira. You will see all your exported Justinmind requirements in your Jira project.

Note: if you haven’t yet installed the Justinmind for Jira add-on, the following dialog will appear the first time you export your requirements:

justinmind-for-jira-add-on-popup-1

To access the Jira issue associated with your prototype, simply click on the Integration tool URL of the requirement to be taken to the corresponding Jira issue.

justinmind-for-jira-URL-jira-project-1

Accessing the prototype from a Jira issue

You can see a section below ‘Attachments’ labelled ‘Justinmind’. To view a prototype associated with a Jira issue, select the ‘View Online’ button. Additionally, you can open the prototype with the Justinmind prototyping tool, click ‘Download’ to download the .vp prototype.

justinmind-for-jira-view-online-1

 

Next tutorial > Exporting Sketch artboards to Justinmind