Context

Jira admins strive to make the life of their users easier. What's easier that being able to create a Confluence page from a Jira issue automatically without any additional action on the user's part?

With Elements Publish to Confluence, Confluence pages can be created when the status of an issue is updated during any given transition.

Tutorial 

In this example, we will create a page from an issue with the key SUP-1 when its status is transitioned to "In Progress".

This guide explains how to configure a Publish to Confluence post-function during a Jira workflow transition so that a recipe is automatically triggered when the status is updated.

Prerequisites

A recipe called "Add to Knowledge Base" has been created, activated, and is available on issue SUP-1.
This recipe must target one Confluence space and one parent page.

When a recipe is triggered during a workflow transition, the page creation is performed without any input from the user. 

For this reason, recipes that are meant to be triggered during transitions must target one space and one parent page, because the user has no occasion to select the target during the transition.

Configuration steps

1 - As a Jira administrator, go to Jira workflows administration page : Settings > Issues > Workflows.

2 - Click on the Edit button related to the workflow you want to update (in our case, the one used by issue SUP-1).

3 - In the diagram view, click on the "In Progress" transition. Then, click on Post-functions.

4 - Click on Add a post-function.

5 - Select the Elements Publish to Confluence option, then click on the Add button.

6 - Select the recipe "Add to Knowledge Base" and add it to the post-function.

In this screen, it is also possible to select a Delay for the execution of the post-function.

By default, the delay is set to "0", which means that the recipe is triggered as soon as the post-function is run. 
However, it is possible to set a delay up to 30 seconds, which means that the recipe will only be triggered 30 seconds after the post-function is run. This can prove useful if you need several processes to run concurrently on a same workflow transition and want to prioritize one over another by delaying it by a few seconds.

7 - Publish the workflow draft.

At this point, the recipe has been added to the workflow transition and is ready to be used.

8 - Open issue SUP-1.

9 - Transition the status to "In Progress". 

Result

After a few seconds, a Confluence page is automatically created from SUP-1 with in the selected target space and parent page.