Often, you will be using JIRA to track the progress of your engineering projects, and you will use another application to keep documentation. In this recipe, we will look at how to integrate JIRA with Confluence, another popular application from Atlassian, which is commonly used for documentation.
Since we will be using Confluence in this recipe, you will need to have an instance of Confluence running on your system. If you do not have one, you can download a free Confluence trial from https://www.atlassian.com/software/confluence.
The first step is to establish the link between JIRA and Confluence:
- Navigate to Administration | Applications | Application links in JIRA.
- Enter your Confluence URL into the Application text box, and click the Create new link button. JIRA should automatically detect the target application as Confluence; if, for some reason, it does not, make sure you select Confluence as the Application type when prompted.
We also need to enable the Remote access API (disabled by default) in Confluence:
- Log in to Confluence as a Confluence administrator.
- Navigate to Administration | Further Configuration.
- Click on Edit, scroll down, and check the Remote API (XML-RPC and SOAP) option.
- Click on Save to apply the change.
Once we have linked JIRA with Confluence, there will be a new option called Confluence Page, which appears when you select the Link option in the More issue menu, as shown in the following screenshot:
If you know the exact URL to the Confluence page, you can enter it in the Page URL field, or click on the search for a page link and search for the page you want to link to:
Once you have found the page you want, simply click on it, and then click on the Link button. Linked pages will be shown under the Issue Links section, in the Wiki Page category, as seen in the next screenshot:
