Creating Forms and Form Templates

The Scaffolding plugin allows you to create dynamic forms and form templates. 

Capabilities of the Scaffolding Macros

The Scaffolding macros are available in an add-on distributed by Service Rocket, whose website explains that Scaffolding gives a Confluence instance the ability to do the following:

• Create forms to fill in
• Collect and display data
• Manipulate and evaluate data
• Using live-templates, create pages with forms and data; these forms and data will change dynamically wherever the template is in use, each time someone updates the template.

Service Rocket organizes the macros in a hierarchy as follows:

• Tables (table-data)
• Templates (live-template)
• Fields
  • date-data
  • eval-data
  • excerpt-data
  • get-data
  • group-data
  • hidden-data
  • number-data
  • repeating-data
  • set-data
  • text-data
• Lists (list-data)
  • label-options
  • content-options
  • list-option
  • attachment-options
  • user-options
• Attachments (attachment-data)

List of the Scaffolding Macros

The Service Rocket Macro Reference  provides a complete list of the macros:

• attachment-data
• attachment-options
• content-options
• date-data
• eval-data
• excerpt-data
• get-data
• group-data
• hidden-data
• label-options
• list-data
• list-option
• live-template
• number-data
• repeating-data
• set-data
• table-data
• text-data
• user-options

Using the Scaffolding Macros

To use the Scaffolding macros

1. Enter { and the first few characters of the name of the macro. The macro browser appears.
2. Select the macro, configure the parameters, and insert the macro.

To edit data on a page with Scaffolding macros

1. Click Edit Contents.
2. Complete the fields provided.

To edit the page

1. Click Edit.
2. Make the changes and click Save.

We provided the following pages to show tasks that can be completed using one or more of the macros on the NCI Wiki. These examples were initially adapted or excerpted from Atlassian's pages for Confluence 3.4.

• Add and Remove Repeating Sections with the Repeating Data Macro
• Attachments and Scaffolding Macros
• Display and Format Field Data with the Get Data Macro
• Enter Field Data with the Set Data Macro
• Evaluate Mathematical Expressions with the Number Data and Evaluate Data Macros
• Excerpt for the Page Created with the Excerpt Data Macro
• Form Fields Created with Scaffolding Macros
• Group Data with the Group Data Macro
• Hide Data with the Hidden Data Macro
• Selectable List of Labels Created with the List Data and Label Options Macros
• Selectable Lists Created with Scaffolding Macros - Attachments, Content Options, User Options
• Selectable Lists Created with the List Data and List Option Macros
• Tabular Form Created with Table Data and Text Data Macros
• Template that Changes on Pages when the Template is Updated - Live Template

Additional Information

The following resources provide more information about the Scaffolding macros.

Videos

• Videos listed on the Service Rocket website
• Scaffolding Plugin video on YouTube
• Scaffolding and Reporting Plugins video on YouTube  (The Reporting macros are not installed on the NCI Wiki.)

Overviews, User Guide, Example

• Atlassian's overview
• Service Rocket's overview
• User Guide
• Example from New York University (search for "Scaffolding Plugin")