Page tree

Versions Compared

Key

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

Basic concepts

Although the ConfiForms plugin contains offers 12 macros. To different Confluence macros to ease form construction, it requires only 2 macros to define a simple form you will need only 2, and just 1 to show it - you will need 1 more macro to employ.

There are couple of concepts to learn to help you to bootstrap your ConfiForms skills

display it anywhere in your Confluence installation. The ConfiForms macros can be quickly reviewed by Inserting a new macro (ctl + shift + A in a Confluence page). 

Getting started
Here are a couple key concepts for understanding ConfiForms:

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

These are the basic concepts you need to learn about begin creating ConfiForms. When you have learnt the mastered these basics, there is a lot more to learn, as are many more useful features to expolore. The ConfiForms plugin supports many scenarios , has integration points to other systems and and has been carefully integrated with other systems in Confluence, providing many customization options. 

 

Scroll down to see, how easy it is to Here the basic concepts and key terms needed to define a simple form. See Explore our tutorials to learn more .

MacroActionConcepts/usage
ConfiForms FormDefineMain macro to define Define the form and it's its rules.
ConfiForms Field DefinitionDefineMacro to use Use inside the ConfiForms Form macro to define form fields, their types and behavior, restrictions and permissions.
ConfiForms Field DefinitionDefineMacro to use when you need Use to define conditional fields and relations between among fields (that is, ConfiForms Field Definitions).
ConfiForms Registration ControlDefine ViewMacro Use to define a form's registration behavior. Each form should have at least one 'Registration Control'. It This control can be placed inside the ConfiForms form or outside. Form could elsewhere on the page, and a form can have any number of registration controls. You can configure your form to   Forms can be embedded on Confluence page pages or to be rendered as a modal dialog.
ConfiForms Edit ControlsDefine ViewMacro This macro defines Edit controls behavior for the ConfiForms ListView and ConfiForms TableView. When you want To enable editing of your stored form data stored then , place this macro inside the ConfiForms ListView or ConfiForms TableView macros.
ConfiForms TableViewViewMacro Use this macro to visualize your stored data as a table, with instant search, filtering, and data sorting/ordering. Add 'ConfiForms Field' macros inside TableView to define what which fields should be shown.
ConfiForms ListViewViewMacro This macro allows you to visualize your stored form data in WYSIWYG view (also supports filtering and data sorting/ordering). Add 'ConfiForms Field' macros inside to define what which fields should be shown.
ConfiForms CardViewViewMacro Use this macro to visualize your stored form data as a vertical table (card) , with instant search, filtering and data sorting/ordering. Add 'ConfiForms Field' macros inside to define what should be shown
ConfiForms FieldViewMacro to define a field to show within ConfiForms TableView or ConfiForms ListView macros
ConfiForms IFTTTDefineMacro to define the integration rules for ConfiForms. Send email notifications when a record is created, changed or modified. Send notifications to other systems via HTTP, or just create new pages from defined templates with data from your forms
ConfiForms TableView MergerViewMacro to aggregate and merge datasets from different ConfiForms forms (or just from one form). Calculate averages, totals, other math operations on your data. The output of this macro is fully compatible with Chart macro and could be used together to create beautiful charts
CSS Rules for ConfiForms FieldsViewHelper macro to support applying of conditional CSS for ConfiForms Fields based on their values

...