Page Comparison

Prerequisites

Before using this you start configuring the action, ensure you have the following prerequisites are metin place:

1. Only Jira administrators have the necessary permissions to access and configure the Create or Update a Confluence Page action within Easy Integration.

2. Confluence Integration must be enabled for your Jira instance.

Options of action

Field Name

Description

Action name

Give a name for the action, it's just a reminder for you!

Condition

How to Configure the Create or Update a Confluence Page Action

The Create or Update a Confluence Page action in Listeners can be accessed within Easy Integration's admin UI. Follow these steps to configure:

1. Navigate to Jira's top menu, and click Apps.

2. Select Manage your apps.

3. In the sidebar, locate and click Easy Integrations configuration.

4. Select Listeners from the app’s top menu.

5. Configure the listener according to your requirements. For more information on that, refer to this documentation.

6. In the Actions section of the listener configuration, click Configure the Create or Update a Confluence Page.

7. Here's how to configure the Create or Update a Confluence Page action:

   Image Added

   • Action name – Give a descriptive name for the action. This is a reminder for you to easily identify this action.

   • Condition – Enable or disable the condition.

     When enabled,

1. • provide a JavaScript condition

1. • for the listener.

1. • The action will execute only if the script returns true.

1. • You can refer to Context variables, Scripts, and Events for more details.

1. • For example:

     return startsWith(data.event.issue.fields.summary, 'Sultans of Swing');

   • Space

1. • – Select the Confluence Space

1. • in which the content is

1. • to be created

1. • .

   • Parent page

1. • – Specify the parent content

1. • for the new content. If you are creating a top-level page,

1. • you can leave this field blank.

   • Template space

1. • – Choose a space for space templates or leave it blank for global templates.

   • Template

1. • – Select a user-defined global or space template.

   • Action parameters (variables)

1. • – Write

1. • JavaScript code to return objects of variables.

1. • For instance, you can define variables such as "issue key,"

1. • "issue summary,"

1. • "issue status,"

1. • and "project name."

1. • These

1. • variables can be used in the

1. • URL, headers, and request body. Here's an example:

     var parameters = {};
parameters['issue key'] = data.event.issue.key;
parameters['issue summary'] = data.event.issue.fields.summary;
parameters['issue status'] = data.event.issue.fields.status.name;
parameters['project name'] = data.event.issue.fields.customfield_10500.name;
return parameters;

   • Page title – Specify the title

1. • of the page.

1. • You can use parameters in the title

1. • by enclosing them in double curly braces.

1. • For example: "New issue is created with key {{issueKey}}."

   • Update existing

1. • – Check this option if you want to update a page with the same title

1. • found

1. • in the directory. Page names

1. • must be unique within a space

1. • . If you

1. • do not check this option,

1. • the action may fail. When checked, an additional option is required:

1. • • Append template

1. • • – If checked, the action appends the template body to the end of the current page; otherwise,

1. • • it overrides the existing content.

   • Add page link to issue

1. • – Enable this option to add a page link

1. • to the issue. When this field is enabled, additional fields are required:

1. • • Issue ID or Key script

1. • • – Write a JavaScript script

1. • • that returns an Issue ID or key. Event data or data from previous actions

1. • • can be used in the script.

     • Confluence application link ID

1. • • – The application links information

1. • • cannot be accessed by the apps.

1. • • To obtain the "id" value of the Confluence object, please log in to Jira, navigate to https://

1. • • [domain name].atlassian.net/rest/applinks/latest/applicationlink, and copy the "id" value

1. • • . For example: "7d4bz3tu-fy2m-26p1-1g3m-

Example Screen

The following example creates an Azure DevOps ticket with the newly created Jira Bug data.

Image Removed

Template Example

1. • • 3857972<9252."

That’s it! You have successfully configured the Create or Update a Confluence Page action in Easy Integrations. For further insights, please refer to the following example:

Example 1: Create/Edit Wiki Page

Note: This is a sample use case and can be customized to suit your integration needs.

Expand
title Example:
Image Added

Example 2: Templates

Templates are employed for the creation or modification of Confluence pages. All action parameters are available accessible as variables. Space templates are under can be found within the "Look and Feel" space settings.