Integration with Atlassian JIRA: importing and exporting JIRA issues in Justinmind Enterprise
In this new Support category, we’ll be showing you how to integrate your favorite software development tools with Justinmind. As we announced in our new release post, Justinmind Enterprise is now integrated with Atlassian JIRA and you can import and export your JIRA issues to and from Justinmind prototyping tool. Read on to find out how you can easily sync your JIRA with Justinmind!
Please note that this integration is exclusively available to Justinmind Enterprise customers. For more information on becoming an Enterprise user, see here.
Importing Requirements: Pulling issues from JIRA into your Justinmind prototype
The first thing you’ll need to do is to configure the JIRA plug-in for Justinmind Enterprise. In a web or mobile prototype, go to the Plug-ins toolbar in the top menu and then JIRA and select ‘Configuration’.
You’ll need to fill in the following:
- Username (of the JIRA user)
- Password (of the JIRA user)
- URL (of your JIRA dashboard)
- Project Key (the abbreviated name of the JIRA project, in our example below ‘EP’ is the project key of our project ‘Example Project’)
- JQL (more info on this here)
Next, click on the option ‘Import Requirements’ from the same menu. If the importing has been successful, you’ll see your JIRA issues appear in the Requirements tab. The two JIRA: Justinmind synced columns are name & description. There is also a link to the JIRA issue, which when clicked on will take you back to the corresponding JIRA task, within JIRA.
Note that if you edit any of the JIRA issues in JIRA, you can see the modifications in Justinmind by returning to the Plug-ins > JIRA menu option and clicking on the ‘Import Requirements’ option again. The updated issues will appear.
Tip: if you wish for your requirements to take on the JIRA column settings, keep the “use JIRA requirements configuration” option ticked. Untick if you prefer to use the Justinmind column settings.
Linking JIRA issues to UI elements in your Justinmind prototype
Once you’ve imported your JIRA issues into Justinmind, you can link the issues to elements in the user interface. To do so, navigate to the User Interface tab. Drag and drop onto or select from the canvas the element that you wish to associate with the Justinmind requirement (imported JIRA issue). To associate the requirement to the element, select the Requirements tab from below the canvas (by default you will see the Events tab) and select the ‘Show all’ option. Then, simply drag the requirement from the list and drop it on top of the corresponding element in the canvas.
Want to view the prototype with the associated requirements in Simulation mode? Simply click on the ‘Simulate’ option and view your prototype. On the right, you’ll find the Requirements menu (next to the Prototype and Scenario menu options). Click on a requirement associated with an element and you’ll find an option to ‘View component’ on the left. If you click on this option, the element associated will be highlighted in green in the Simulation window.
Want to view the prototype associated with this particular JIRA issue in JIRA? In the Simulation window, click on a requirement. On the right, you’ll find an option to ‘View in JIRA’. Select this option to be taken to JIRA to view the issue associated with this prototype.
Exporting requirements from Justinmind to JIRA
Want to see the changes you have made in Justinmind in JIRA? To do so, you will need to export the requirements. In this way, the requirements that you have changed in Justinmind that you initially imported from JIRA, as well as the any that you have created from scratch, will be updated in JIRA.
Want to view a link in your JIRA issue that takes you directly to the associated prototype in Justinmind? You can also do so by exporting the requirements.
To do so, first you will need to ensure that the prototype is online, stored in the cloud, so that we can view it in another application. To do so, exit the Simulation window and click on the ‘Share’ option next to the ‘Simulate’ option. Share the prototype to the account of your choosing. Now, go back into the Requirements tab in Justinmind. In the Requirements tab, go to the Plug-ins tab from the main drop down. Select the JIRA option and then the ‘Export Requirements’ option. This action will sync your Justinmind requirements with the associated JIRA issue in JIRA.
Now, click on the Integration tool URL of any requirement associated with a UI element of your prototype to be taken to the corresponding JIRA issue. In JIRA, you will see an additional line in the issue’s description that reads ‘Visualized in’ with a link to the associated prototype in Justimind’s online account.
And that’s it! You’re officially a JIRA-Justinmind issue/requirement expert!