Versions Compared

Key

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

...

Table of Contents
minLevel1
maxLevel2

Create a new template

Info

This functionality is not available in Simply Requirements Management for Jira

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

    Image Modified

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

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

    Image Modified

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

    Image Modified

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.

    Image Modified
  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.

    Image Modified
  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 Modified

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.

...

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

${uid}

The id of the current user (since 2.5.0)

${uname}

The display name of the current user (since 2.5.0)

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

    Image Modified
  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 Modified
  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 Modified

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.

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

    Image Modified

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

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

    Image Modified
  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.

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

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

    Image Modified

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.

...

For a guide on how to create new fields check out our documentation (Data Forms fields - How to create, customise and delete Data Form fields ).

  1. To add a field to a section just drag and drop it from the sidebar on the right into the section.

    Image Modified

  2. You can also drag and drop fields from one section to another.

    Image Modified

  3. Or remove a field from a section by dragging and droping it into the sidebar on the right.

    Image Modified

  4. If you press Configure on a field or the Cog icon,

    Image Modified
  5. dialog opens and you can:

    1. change the name

    2. change the description

    3. specify that the field is required

    4. specify a default value

      Image Modified
  6. Don’t forget to save your changes by clicking on the Save button.

    Image Modified