Confluence Values
Confluence Values let you automatically capture data from Confluence when a form is submitted.
You can insert these values directly into a form response this means users don't have to type in details like their name or the page title.
Example Confluence Values
Confluence Values are placeholders that resolve automatically when a form is submitted. They can be used by entering one of the following values in the Confluence Value field of an appropriate input field macro.
$user.name- returns the username of the user submitting the form.
$user.fullName- returns the full name of the user submitting the form.
$user.email- returns the email address of the user submitting the form.
$queryparam=title- returns the title of the page where the form is located.
$queryparam=spaceKey- returns the key of the Confluence space containing the form.
$queryparam=group- returns the group memberships of the user submitting the form.
Confluence Value Field locations
Confluence Values can be added to the following input field macros:
- Hidden Field - to capture metadata invisibly with each submission
- Input Fields - to pre-fill text fields with user or page data
- Textarea - to pre-fill longer text values if needed
Each of these macros has configuration options where you can enter a Confluence Value or a Velocity value.
Use Case: Create a call back request using velocity values for a full name.
In this example, a form includes an Input Field macro using $user.Fullname in the Value or a Velocity value field. The form automatically populates the Your Name field with the user name.
Use Case: Request feedback using the velocity value as a page title.
In this example, a feedback form includes a Hidden Field macro with _$queryparam=title_ entered in the Value or a Velocity value field. This will retrieve the page title when the form is submitted. When rendered, the field does not appear in the form. You can also retrieve a space by adding a Hidden Field macro with _$queryparam=spaceKey_.
Use Case: Use the value to create an anonymous survey shared between groups.
In this example, we want to distinguish results according to which group completed the same survey. A group parameter is appended to the page URL for each group, e.g. ?group=1, ?group=2, etc. A Hidden Field macro is added to the form with $queryparam=group entered in the Value or a Velocity value field. The URL can then be shared with the users in the appropriate groups.