Versions Compared

Key

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

How to use ConfiFroms

Back to: 

Linktoparent

Principles

Documentation: https://wiki.vertuna.com/display/CONFIFORMS/Documentation

Info
Getting started

Here are a couple of key concepts for understanding ConfiForms:

  • Forms are defined through two macros: "ConfiForms Form (Definition)" and "ConfiForms Field Definition"
  • The "ConfiForms Registration Control" macro both configures how the form should be displayed and enables the display. This macro enables displaying the form as a dialog, embedded in the page, or formatted using the layout defined. 
  • A form can have multiple "ConfiForms Registration Control" macros associated with it. This means you can show the form on different pages in different ways.
  • Data stored by the form can be used on different pages (using the View macros).  This allows you to control which fields are shown and how they are displayed. Fields can be configured by placing "ConfiForms Field" macros inside View macros. See Multiple ways to show your form data in Confluence with ConfiForms

Simple Example

all 3 components, 1) Definition, 2) Registration Control, 3) DataView are bellow, form itself have 4 fields 1) basic text field, 2) Checkbox, 3) checkbox group, 4) Drop down

Panel
borderColor#999999
bgColor#F6FCFF
titleConfiForm Definition

using "ConfiForms Form Definition" macro

  • serves for defining form, its fields, and logic
  • should be on a separated page accessible only to UN Staff


Example:

ConfiForms Form Definition
formNameTestForm
registrationFormTitleTest Form

TestTextFieldTest Text Fieldtext

TestCheckboxFieldTest Checkbox Fieldcheckbox

TestCheckboxGroupFieldTest Checkbox Group Fieldfalse[1=option 1|2=option 2|3=option 3|]checkbox_group

TestDropdownFieldTest Dropdown Fieldfalse[1=option 1|2=option 2|3=option 3|]select



Panel
borderColor#999999
bgColor#F6FCFF
titleConfiForm Registration Control (form display)

Form Presentation

using "ConfiForms (Form View) Registration Control" macro,

  • reference From Definition
  • Should be on a separate page accessible to all users intended to use the form
    • Everyone for Expert Registration
    • Existing experts for simplified Event registration etc.

Example:

ConfiForms (FormView) Registrations Control
formNameTestForm
embeddedtrue





Panel
borderColor#999999
bgColor#F6FCFF
titleConfiForm TableView (data display)

Form Data

using "ConfiForms TableView" macro,

  • reference From Definition,
  • reference each field that should be displayed
  • Should be on a separate page accessible to specific users
    • List of participants, list of Visa support requests etc.

Example:


ConfiForms TableView
enableFilterSupporttrue
formNameTestForm

TestTextField

TestCheckboxField

TestCheckboxGroupField

TestDropdownField



ConfiForms Form Filter Control
pageTitleHow to use ConfiFroms
formNameTestForm

TestTextField

TestCheckboxField

TestCheckboxGroupField

TestDropdownField