Action and rule for new Confluence template approach
Use Confluence Template/page in Rule action
Once your Create page/template within Confluence is ready, it's finally time to push your release notes to Confluence that are compatible with the v2/new Confluence editor!
Create Rule
Navigate to the Rules tab under Automated Release Notes app. One can create the Rule from In-project/Cross-project screens. All the steps are same in terms of how to create Rules. Once you have saved the Rule, notice a new Action showing up called Publish to Confluence (with new editor), and click on it.
Create Action
In case of the action, it is the same as creating an action for any other templates as explained here. A few differentiating fields we have added in this action are below -
Confluence Instance - Select the relevant Confluence instance that has the ARN Helper app and is properly integrated via Token.
Select source template -
Select space - Seelect the relavant space where you have created a page/template
Select a confluence page as a template - Select the page where you have added JQL section macro/s and any other content for publishing release notes.
#BestPractices
Now this page will work as a template. To avoid duplicate page errors in logs, in page title use variables like [timeStamp], [releaseDate], [fixVresion], etc.
So everytime you when rule is executed, real-time values will be fetched for given variable to create the unique title of the page.
Select a confluence template -
If you have created a Global Confluence template, select Global confluence templates option in Space field.
If you have created a Local template then select the relevant Space where you have created a template.
Then select the Select a confluence template radio button option and then search for the template you have created.
Destination page settings - In this section, set up the destination page where the release notes are supposed to get published.
Space key - Mention the space key or choose the space
Type - Select whether the it will be published as Blog or Page
Page action - Select the relevant page action here
Create new
Create new or update if exists
Append to existing page
Prepend to existing page
Parent page - It is not mandatory, but use it if you are publishing it under a parent page
Labels - Confluence page labels go here
Skip subsequent actions if this action fails - This option prevents subsequent actions from running if the current action fails.
Once you Save, the release notes will be published as per https://amoeboids.atlassian.net/wiki/spaces/ARN/pages/84541493/Triggers?search_id=b3e34186-f3b3-4c1e-89fb-288cd76c22f0 you set in the rule. Please feel free to share any queries or feedback on our Support portal.