How To Create A Confluence Page In Jira

How to Automatically Create Confluence Pages from Jira Issues?

Snapbytes " Easy Integrations for Jira " (EIJ).

It does exactly what it says on the tin. EIJ can integrate your Jira instance with any platform using REST API calls, and Confluence is not an exception. You can streamline your content creation by using EIJ's built-in "Confluence page creation" capability to save your time and increase productivity. Let's have a look at the use-case of this nifty built-in feature from the trenches!

During the digital transformation journey of one of our customers, adopting Atlassian JIRA and Confluence for the company's HR department was the key to establish automated processes. For instance, employees used to print out their leave forms such as annual leave, sick leave etc. and have signed from a couple of approvers. It was time-consuming and meant a lot of paperwork!

People vector created by stories — www.freepik.com

As you can guess, instead of following the physical approval procedure, automated JIRA workflows for this HR processes saved a significant amount of time for each employee, their line managers and the HR department. On top of that, EIJ made it possible to archive HR leave forms on Confluence automatically thanks to its built-in Confluence page creation feature. But how? Let's dive into this!

Add Post Function

First, you need to add a "Create Confluence page using a template page" post function to your workflow transition which you would like to create a Confluence page once it's executed.

Condition for Create Confluence Page

Let's decide when our post function will execute. Easy Integrations for Jira gives you great control and flexibility with this decision. You can type your own Groovy script in order to programmatically decide to execute a post function or not.

Select Confluence Page Template

Easy Integrations for Jira provides a strong templating feature where you can use all issue attributes including summary, assignee, priority and many other systems or custom field values.

For this, you basically create a Confluence page as a template using dynamic parameters provided by our app. Here is how a template page looks like:

Then you select this page in the post function by either searching with its name or entering its page ID.

Select Folder For Confluence Page

In this part, you can select where the Confluence page will be created. You can select a parent page (folder) by either searching with its name or entering its page ID.

Page Details And Parameters

The last part of the post function is to define parameters for the Confluence page template. You can define;

Page Title: The title of the new Confluence page. You can use parameters in the title as in the page template. It is a good idea to add an issue key or summary in the title to prevent duplicate page titles.
Request body: JSON request body for the Confluence page, you can send any data defined in parameters. You could leave this part empty as long as you don't want to do some advanced stuff.
Parameters: You can dynamically include issue related information into automatically created pages. Just assign variables here as seen in the sample below and use them in your page templates.

You can define unlimited parameters. Check this page to see some examples.

And that's it.

Now our Confluence page is ready to be created.

We added this post function to Send to Approval transition, so when we click Send to Approval, our Confluence page will be created.

Here it is! Brilliant…

As you can see, you can create Confluence Pages automatically, thanks to EIJ. However, please remember it's just one feature of " Easy Integrations for Jira ". You can address your Jira integration issues by using EIJ and its REST API calls.

Have any questions or suggestions? Feel free to contact us!.