Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents
minLevel4

Create a new template

  1. In the admin panel of Data Forms for Confluence go to the Templates tab.

  2. Click on Create template. A modal will open.

  3. Add a name for the field and click Create.

  4. Your new template is now created and will be shown to you. The template can now be further customised.

Rename the template/ add a description

  1. To rename the template or add a description click on the current name or on More details => Add description here.

  2. Enter a new name or description.

  3. Submit the change by clicking on the checkmark button. Note that the change is not yet saved.

  4. To save your changes click on the Save button. (Note that the Save button will only be enabled if there are changes to be saved.)

Add Id or Name template

Starting with Version 2.4.0 and Cloud Release 2022-08-17 you can specify how the ID or name of the data form should look like.

Here you can use the following Placeholder

Placeholder

Replacement

${yyyy}

The current year

${yyyy-mm}

The current year and month

${yyyy-mm-dd}

The current year, month and day

${uuid}

A universally unique identifier

${cid}

The pageId, issueKey, spaceKey or projectKey of the page/issue/space/project where the data form was saved

${tid}

The id of this data form template

  1. To change the Id or Name tempalte click on More details => Add id template here or Add name template here.

    Image Added
  2. Enter a new it template or name template.

  3. Submit the change by clicking on the checkmark button. Note that the change is not yet saved.

    Image Added
  4. To save your changes click on the Save button. (Note that the Save button will only be enabled if there are changes to be saved.)

    Image Added

Add sections to a form

In order to add fields to your form you first have to add a section to put the fields in.

  1. Click on the Add new section button. A modal will open.

  2. Add a name for the section and submit the change by clicking on Create.

  3. To add a description to the new section click on Add description here and enter a short text.

  4. To change the name of the section click on the current name and enter a new name.

  5. If you have more than one section you can change the order of the sections by clicking on the arrow buttons to move the section up or down.

  6. To delete the section click on Delete section. Note that only empty sections can be deleted.

  7. To save the changes click on the Save button.

Add fields to a section

With at least one section created you can start to fill your form with fields.
All predefined fields that are available to you are shown in the right sidebar.
Note that each field can only be used once in a form.

...