How to use ConfiFroms

Back to: 

Principles

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

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

ConfiForm 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:



ConfiForm 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:

Test Form




ConfiForm 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:


Test Text Field

Test Checkbox Field

Test Checkbox Group Field

Test Dropdown Field

This is 1st Test yes option 1 option 2 option 1
test no option 1 option 1



Start typing to see the options...