Do you use JIRA? Do you also use Confluence? And do you feel like you have two different tools completely disconnected from one another, rather than a unique, powerful and flexible collaborative and integrated platform? If so, this article is for you. It focuses on five native features that connects JIRA and Confluence so you can really start unleashing the power of your collaborative platform.
1. List your JIRA issues within Confluence
The “JIRA Issues” macro provides a simple way to list your JIRA issues within Confluence. It works this way:
1. Open a Confluence Page of your choice in “Edit” mode
2. Set the focus on the spot where you want to insert your list of issues within the Rich Text Editor
3. Select the “JIRA Issues” macro from the “Macro Browser” as pictured below
The result should look like this…
2. Create your JIRA issues from Confluence
You can also use the JIRA Issues macro to create your JIRA issues directly from Confluence. In order to do so, select the “Create New Issue” tab – instead of the “Search” one – from that macro’s configuration panel, as shown in the following illustration, and fill in the fields.
Notice that if your Confluence version is 5.4 and above, you can also create a JIRA issue from a text selected in Confluence through the following process:
1. Go to the Confluence Page of your choice
2. Select the text from which you want to create your issue as pictured below
3. Display your JIRA dashboards into Confluence
It is also possible to display your JIRA Dashboard’s gadgets within Confluence, after having applied the registration procedure described here. Registered gadgets can then be exploited from the Confluence macros browser as shown in the picture below.
4. Display your Confluence pages within JIRA’s dashboards
Conversely, the “Confluence Page Gadget” lets you view a Confluence page in JIRA. It is actually a Confluence gadget which becomes available in JIRA when the JIRA-Confluence Application Links have been configured. Once set up, the “Confluence Page Gadget” appears in the JIRA’s Gadget Directory as shown in the picture below.
As shown in the picture below, its configuration consists in the selection of the page you want to display – and its space.
5. Link your JIRA issues to Confluence pages
Lastly, those of you who are the the most familiar with Atlassian product know that it is possible to link a JIRA issue to a Confluence page through this basic 3 steps process:
2. Select the “Confluence Page” tab as shown in the picture below
It’s done! The whole final picture should look like below.
PS: This last feature only works for JIRA 5 and above.
Over the past few years, Atlassian has worked hard to reinforce the JIRA-Confluence integration. And this is particularly true for releases above Confluence 5.0 and JIRA 5.2. The features presented in this article do not require any plugin or custom development but a prior configuration is necessary.