Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Section
Column
Note

Make sure that you have read and understood the section on using frevvoresolve macros.

View the Merge to Confluence Page video for more information if you are using Confluence v4.0 - v4.2. The way of adding and parsing templates has been changed in Confluence v4.3 and v5.1. Refer to this documentation for information about templates in these versions.

Using Live Forms for Confluence, you can create forms/workflows that store the form data in one or more Confluence pages. Every time the form/flow is submitted, the data is merged into an existing Confluence page. If the desired page does not exist, it will be created using a Confluence template.

For example, assume that you want to use a form to collect registrations for an event. We'll create a Confluence page with an embedded form and a result Confluence page in which we'll collect the list of registered users. The result page stores a table with a row for each registered user.

Column
width240px

On This Page:

Table of Contents
maxLevel2
 

...

  1. Create a Confluence Template with frevvoresolve macros
  2. [Optional] Create the parent page of the hierarchy. All pages created/updated by the form will be child pages of this parent page. If you skip this step, all pages will be created as children of the Confluence page which embeds the form or workflow.
  3. [Optional] Create a confirmation page to display after the form/flow has been submitted. If you skip this step, the child page that is created/updated will be displayed. 
  4. Create a form or workflow, embed it in a Confluence page and run the Form Action > Merge to Confluence page wizard.

Image RemovedImage Added

Here is an example result page Template called Registered Users in Confluence 4.0 - 4.2:

...

Tip

If you make changes to a template, existing result pages will not reflect the changes. This is as-designed. Merge to page only uses the template the first time. In subsequent merges, the macros from the result page are used and not the template.

A new version of the template requires a new result page to reflect the updates to the template. See this documentation for information about creating templates.

...

Warning

This approach does NOT work with the add-on for Confluence v4.0 - v5. Use the Merging using a Template approach instead

Image RemovedImage Added

The steps are as shown in the Figure above.

  • Create an initial results page with frevvoresolve macro.
  • [Optional] Create a confirmation page to display after the form/flow has been submitted. If you skip this step, the child page that is created/updated will be displayed.
  • Create a form or workflow, embed it in a Confluence page and run the Form Action > Merge to Confluence page wizard.

...

Create a Confluence page and add a form or workflow to it. For details on adding a form or workflow to a Confluence page, please see the Creating Forms in Confluence or Creating Flows in Confluence documentation.

Merge to Confluence Page Wizard

Click on Form Action and select the Merge to Confluence page form action.

Image RemovedImage Added

Merge to Confluence Page Form Action

...

Warning

 If you are using the add-on for Confluence v4.x you must supply a template name here. See Merging using a Template.

Image RemovedImage Added

Merge to Confluence Page Wizard

...

Fill out the form and Submit it. The result page is shown below.

Image RemovedImage Added

Use Form in Confluence

Image RemovedImage Added

Use Form in Confluence

...

Info

Time and Date/Time controls are displayed in UTC when used on a result page in Confluence. See the image below:

Image RemovedImage Added