1.4. Linking Jira project with Confluence JQL queries

Goal

This section contains the instructions to automatically update the JQL queries used in Confluence macros, by adding Gaia tags.

Pre-requisites

This tutorial was written considering that :

• you have a Jira instance installed and running on your server with Gaia for Jira installed;
• you have a Confluence instance installed and running on your server or you are using the Confluence Cloud service from Atlassian;

Linking a Jira project with Confluence

1. Adding the Jira project key Gaia tag into a Confluence JQL query :

In your Confluence Space template, when you specify a JQL query in a macro (e.g: Jira Issue) you can use the tag ##PROJECTKEY## to add a reference to the project that will be created from that template.

When the project will be created, Gaia for Jira will automatically replace this tag by the project key.

For example:

Confluence refuses to let me add my keys or queries

Note that if you try to embed these keys into macros or JQL queries, they might sometimes be refused, as Confluence do not recognize them as valid project. To bypass this limitation, you may need to edit the Confluence page source using a source editor (https://marketplace.atlassian.com/plugins/com.atlassian.confluence.plugins.editor.confluence-source-editor/server/overview).