Div |
---|
|
On this page Table of Contents |
---|
maxLevel | 2 |
---|
exclude | On this page |
---|
type | flat |
---|
separator | | |
---|
|
|
Description
The run macro provides a user form with specified input fields. Form fields will be used to replace variables in the body before rendering. Form values can be provided as follows:
- User interaction - a user inputs data into the fields
- Using Pre-defined variables
- Including request parameters
Any text in the macro body that begins with $ immediately followed by a key found in the replace parameter list (see Field types for details) will be replaced by the value. Typically, values will be provided by a user submitting a form from the page based on the replace parameter. When defining field types, default values may be specified.
...
Info |
---|
|
This macro may have restricted use for security reasons. See CMSP and consult with your administrator for details. |
Configuring the Run Macro
The following steps will help demonstrate how to configure the run macro. In the following example, we will create a simple form that prompts the user to provide responses to example security questions.
Table plus |
---|
border | 0 |
---|
heading | 0 |
---|
multiple | false |
---|
enableHeadingAttributes | false |
---|
columnAttributes | style="border:0;width=5%;",style="border:0;width=65%;",style="border:0;width=30%;max-width=30% !important;" |
---|
id | steps_table |
---|
enableSorting | false |
---|
enableHighlighting | false |
---|
|
| Insert the run macro on a Confluence pageCreate a Confluence page that will eventually contain the form you would like presented to users within your organization. - Create a page named Incredible Form in a space accessible to the desired audience.
- Click Save to save the new page.
| |
| | Edit the Incredible Form page and: - Select Other macros from the top menu.
In the search box type "Run" and select "Run with a user form and parameters" - Click the Run macro from the list of available macros.
| Image Added
|
| Image Added | - Click on "+Add my first field"
- Under form element, let's select the text field type.
- Let's set the value of the unique field key to "text-1".
- The field label will be visible to the user, so let's use "Name of your first pet".
- We can leave the field value empty. This is where we could provide a default value or example.
- Next, let's add another example
|
|
|