This is the documentation for ConfiForms Server/Data Center app

However, this might also work for ConfiForms cloud and in most cases it does. But please see this page to understand the differences between server and cloud versions of the ConfiForms app.

The ConfiForms Plugin

The ConfiForms Plugin uses Confluence's page permissions to control form use. Users with 'edit' permission for a page have administrative rights for the form(s) defined on that page. By restricting 'edit' rights to the page, the administrator controls administrative rights to its form(s).

Each record stored with ConfiForms has an owner. This means that a user who owns the record can fully control it (if edit/delete is enabled by the administrator). Admin users of a form can configure ConfiForms records to be owned by themselves, and also by other users. A form's administrative users can control all records saved by the form.

Each record in ConfiForms has the following associated metadata:

id - the record id, unique for every saved record
ownedBy - the username of the user who owns the record (and can fully control it)
ownedByName - the full name of the user who owns the record
createdBy - the username of the user who has created the record (admin users can create records for other users)
createdByName - the full name of the user who has created the record
created - the timestamp when the record was created
dateCreatedFormatted - a more readable way to see created timestamp

All these metadata fields, in addition to the form's defined fields (definitions), can be referenced using the "ConfiForms Field macro" in these ConfiForms macros:

TableView macro
ListView macro
CardView macro
CalendarView macro

Our Backlog

ConfiForms Backlog

Before contacting support, please make sure you have updated the plugin, you need help with, to latest version. Check Atlassian Marketplace for available versions of our apps
Request Number	[auto]
Add-on	Select an app you need our help with...
Your name *	We would like to know you and be polite when talking to you
Your email *	So, we can reply you back for the details or when the feature is complete. No spam - we promise!
Describe your request	Describe your feature or support request in brief, or in details :-) Always helps when you tell us what Confluence/Jira version you are using
Add-on's license ID (SEN) *	Put license SEN number

Quick tips

Each form has a name and belongs to a page. Use the form's name and the Confluence page where the form is configured to reference a ConfiForms Form
To define the form, use the ConfiForms Form and Field Definition macros
To enable registrations and display the form, use the ConfiForms Registration Control macro
To display the form with its own layout , use the ConfiForms Registration Control macro body as a container for the form's design, placing ConfiForms Field macros in the container that define the form's fields
To enable data edits use ConfiForms Edit Controls with ConfiForms TableView, ListView, CalendarView or CardView macros
To add convenient viewer to your data use ConfiForms Entity Viewer with ConfiForms TableView, ListView, CalendarView or CardView macro
To send email from ConfiForm, use an IFTTT macro placed inside the ConfiForms Form macro
To display saved data, use the ConfiForms TableView, ListView, CalendarView or CardView macro
To customize the output , use the CSS rules for ConfiForms Fields macro
To configure dependent fields and relations between fields, use the ConfiForms Field Definition Rules macro
To aggregate and merge the data from different ConfiForms Forms, use the ConfiForms TableView Merger macro

Macro documentation

ConfiForms Form

confiform

The main macro to define the entry form and its rules

ConfiForms Form name	formName	The name of the form being created. This name be unique within the page and use alphanumeric characters [a-z, 0-9].
Registration form title	registrationFormTitle	The title for the form to be displayed in the registration dialog.
Save button label	saveButtonLabel	The text for the 'Save' button in the registration dialog.
Enable full audit	enableAudit	If set, this enables a full audit, tracking all the changes made to the form and enabling a change history for versioning purposes. The form's admin users are able to see the log as a part of the admin user interface.
Secure storage	secureStorage	When set, if a form has fields of type file then additional subpages with restricted access will be created to hold those files (as page attachments) and enable secure access. Form admins and a record original creator will have access to these attachments for download
Lock form	locked	Use this flag when the ConfiForm should be locked so that additional records cannot be stored. Admin users will still be able to manage the form's data.
Lock message	lockedMessage	The message text that will be displayed to users when the form is locked.
Enforce one entry per user	uniqueByUser	ConfiForms will ensure that only one record per user (ownedBy) is saved.
Restrict record view for non-admin users	showOnlyOwnRecords	This parameter limits access for non-admin users so that only records owned by the user will be visible to this user. Admin users will still have access to all records.
Read-only after submission	readonlyAfterRegistration	This sets the form to be read-only once the user has submitted it. Users who have not yet submitted the form will still be able to do so.
Read-only message	readonlyAfterRegistrationMessage	When the 'Read-only after submission' parameter is set and the user has submitted the form, this text will be displayed.
Track maximum capacity	maxCapacity	The maximum number of records that ConfiForms will allow to be submitted.
Maximum capacity message	maxCapacityMessage	When the 'Track maximum capacity' flag is set and the maximum has been reached, this text will be displayed.
Allow data export	export	Use this parameter to enable data export for non-admin users. The "Enable export" parameter on the TableView macro must also be set.
Enable ''Print'' button	printEnabled	This parameter will enable a print button on the form.
Display editable fields in Print view	printEditable	When this parameter is set, the form's fields will be displayed as editable entries in the Print view. When not set, the fields will be shown as read-only labels. When checked
Additional form admin user names (or groups)	additionalFormAdmins	A comma-separated list of user names / user groups that should be treated as the form's administrators. This parameter can be used to lock the form's configuration but enable full control over the form's data to certain users.
Anonymous form	anonymousInput	Enabling anonymous input for your form will allow you to create records anonymously (createBy and ownedBy fields are not set. Records could be modified only by Form admins)

ConfiForms Field Definition

confiform-field-definition

The macro to use inside the ConfiForms Form macro to define the form's fields, their types, and behavior.

Field name

fieldName

A required parameter which allows alphanumeric values; the name must be unique within the confluence page.

Label

fieldLabel

The label to be shown with a form element (for example, the caption for a button, the title for input fields, or the header when used in a ConfiForms Field in TableView or CardView).

Required

required

If this parameter is set, ConfiForms will ensure the field has a value and validate the user's input.

Field type

type

The field's type which defines how data can be entered in the field (datepickers for dates, dropdowns, etc.) according to these definitions:

Type

Compatibility

Description

Text

4.3+

A simple text input field.

Action Button

4.3+

Action button to update the entry when in "view mode". Easy to implement quick notifications when used together with IFTTT module

Autolink

4.3+

This type creates automatic links to resources based on a defined pattern. When used with an IFTTT macro to create pages, autolinks can reference the record owner as [owner]; the record modifier, as [modifier]; and any record field as [entry.FIELD_NAME] (except entry.id , which is not available when a record is about to be created)

Autonumber

4.3+

This type makes the field's value an auto-incremented number assigned automatically to each record. You can control how the number is displayed by using a mask (prefix) and an initial number. See Text masks and masked input.

Autopage

4.3+

This field type records the source page where the record was submitted.

Calculated

4.3+

This type sets the value for the field based on an expression which can reference record owner as [owner]; record modifier, as [modifier]; any record field as [entry.FIELD_NAME]. Important: the value is calculated only when an entry is created. See the "Formula" field type for a field which is recalculated on each edit. See Supported math operators and functions.

Checkbox

4.3+

Display the field as a checkbox.

Checkbox group

4.3+

Displays the field's options as a group of checkboxes.

Date

5.0+

This type provides a datepicker that stores data in the format specified in Confluence's general settings for Date Format.

Datetime

5.0+

A datepicker with time control to store data in the format specified in Confluence's general settings for Date Time Format.

Drawing canvas

4.3+

A field type for capturing simple drawings such as 'wet signatures,' for example.

Dropdown

4.3+

This field type creates a drop-down list (or combobox) for capturing user input.

Dynamic label

5.1+

This controls behaves similarly to Confluence labels, and allows setting multiple labels to one field. List of labels could be dynamic and you can even set it to reference itself, meaning that when a new label is entered in current form it will be immediately available for lookup

Dynamic Dropdown

4.3+

This one offers a dynamic drop-down list (or combobox) in which the values can be pre-defined or referenced from another form; it includes an option for users to enter their own values.

Enroll button

5.0+

This field type enables one-click record storage.

File

4.3+

This type provides a way to upload files and images. Uploads will be stored as attachments on the page where the ConfiForms form is defined.

Formula

4.3+

This field type sets the value for the field based on an expression which can reference the record owner as [owner], a record modifier as [modifier]; and any record field as [entry.FIELD_NAME]. Important: this value is calculated every time an entry is updated (and created). See the "Calculated" type if the field should NOT recalculated on each edit. See Supported math operators and functions.

Html

4.3+

raw HTML content

Hidden

4.3+

This type provides for a concealed constant value to be stored with the record.

Hidden Html

4.3+

Hidden raw HTML content

Link

4.3+

This field type offers a convenient way to store links to other resources and display them as links.

Masked Text

4.3+

This type provides a way to mask (or constrain the format of characters entered) in a text field. For example, a mask of 00/00/0000 will format the entry in this way: 23/12/2014. See Text masks and masked input to learn more about defining a mask.

Multiselect

5.1+

This type stores multiple values for the field.

JIRA issue

4.3+

This field type provides a means to reference a JIRA issue. It requires an application link between Confluence and JIRA.

Page/Blog post

4.3+

This type permits the field to reference a Confluence page or blog post.

Password

5.0+

A type for passwords which obscures the characters being entered.

Radio group

4.3+

This type provides for a group of radio buttons, which allow the user to choose a single exclusive option. This type can be especially useful with surveys.

Readonly

4.3+

Looks like a text field but is readonly to the user, might have a default value. Usually used with ConfiForms Field Definition Rules which set's value to this field

Section

4.3+

This is a section placeholder to separate fields into groups on the form.

Simple date

4.3+

This type offers 3-part drop-down lest (year, month, and day) for easy date selection.

Smart classifier

4.3+

This sophisticated field type allows users to enter data based on a stored structured dataset and the deep structure can be defined as needed.

4.3+

5.1+

5.1+

5.1+

These types provide ways to reference the data from other ConfiForm forms, either another form's drop-down values, or records stored directly (see the flag 'Reference to values').

Status

5.0+

This field type permits easy grouping and presentation for entered data. Each status level is color-coded to foreground data groupings.

Important

Filtering by the status field can be a bit complex because each color has a constant value which is stored with the data according to this pattern:

Color	Constant
DEFAULT	default
ERROR	error
CURRENT	current
SUCCESS	success
COMPLETE	complete
MOVED	moved

Textarea

4.3+

This type provides a textarea for user input.

User

4.3+

This field type enables reference to users in the Confluence system. Entering initial letters of a username will automatically provide a list of suggested users.

User (multiselect)

5.1+

Like the User type, this one allows selection of multiple users.

Voting

5.0+

Enables quick voting control

WYSIWYG

5.0+ (on 4.3 this controls is shown as textarea)

This field type providea a simple editor that supports basic formatting styles.

* The Compatibility column shows the Confluence version number with which this field type is compatible.

Field description

fieldDescription

This parameter provides a caption text for the field that is visible below the field.

Visibility

restrictions

Use this parameter to limit a field's visibility to selected users or groups. It accepts a comma-separated list of group and users and can be left blank if there are no restrictions.

Editability

editRestrictions

Like the Visibility parameter, this one limits who can edit the field, again using a aomma-separated list of group or user names; can also be left blank if there are no restrictions.

CSS styles

css

This parameter can contain the CSS rules that should be applied to the field's input. Adjust the CSS rules on the ConfiForms Field macro to customize the field's output.

Validation rules

validation

A regular expression to validate the field's input; see detailed documentation at Automatic validation for your fields.

Validation message

validationMessage

A message to be displayd when validation fails; if this is not specified, a standard message will be shown.

ConfiForms Registration Control

confiform-entry-register

This macro defines how the form is displayed (as a pop-up dialog or embedded in the page) and the form's behavior when submitted. Multiple 'Registration Controls' that use the same form (form definition) can be placed on one or multiple pages.

When the macro has a body defined, the fields in the body will be used as inputs for the form layout. To enable WYSIWYG mode, make sure that "ConfiForm Field" macros are in the body of the "ConfiForms Registration Control" macro. ConfiForm Field macros and text can be styled as needed.

If the "ConfiForms Registration Control" macro is not defined (empty), a default layout will be used (either as a table or a card with key-value fields).

ConfiForms Form name	formName	The name of the ConfiForm to which this registration control should be linked. This parameter is required when the macro is used by itself (not inside the ConfiForms Form macro). The name parameter can be skipped when the macro is configured inside the ConfiForms Form macro, and if not defined, the form name is automatically assigned.
Location page name	pageTitle	The name of the page on which the form is defined if not the current one; leave this blank if the form is defined on the same page.
Embedded or Dialog?	embedded	Check this option to have the form embedded on the page, uncheck to display the form as a pop-up dialog.
Submission button label	registrationButtonLabel	The text to be displayed on the submit button.
Post save message	registrationMessage	The text to be displayed after a record been created.
Key-value request parameters	presetValues	This parameter provides a way to preset values for certain fields in the form. These are listed as key-value pairs, separated by & (as request parameters) where the ''key'' is a ConfiForms Field name and the ''value'' is the data to be preset for the field.
Enable auto enroll	autoenroll	Use this parameter when the form has preset values (key-value pairs) and can be auto submitted. Because the form can have multiple registration controls, the auto enroll can be combined with predefined data to enable one-click submissions, for example, to capture yes/no feedback.
Valid redirect URL	redirectUrl	An optional location to which the user will be redirected after a successful ''save'' operation. This parameter supports parameters and references to record fields: the record owner can be referenced as [owner], the record modifier as [modifier]; and any record field can be referenced as [entry.FIELD_NAME].
CSS styles	css	CSS rules to be applied to the Submit button when the form is displayed as a pop-up dialog (when the form is embedded in the page, this button is not shown).
Visible only to groups/users	restrictions	This parameter accepts a comma-separated list of groups and users to which this field will be visible. Leave this parameter blank if there are no restrictions.
Hide control when stored data matches this criteria	hideIfMatches	ALL ConfiForms entries stored by the form referenced will be concealed when the items in this parameter are matched in the entry. The control itself will be hidden when the condition/filter given is met, and this parameter uses the same syntax as in filters .

ConfiForms Edit Controls

confiform-entry-edit

This macro defines the behavior of the Edit control for ConfiForms ListView and TableView.

Inline edit or in dialog	inline	Defines how the record edit should be done: through a dialog or inline on the page.
Display Edit and Delete buttons	showBoth	This parameter can be configured to conceal the 'Delete' action for non-administrative users, or to display both Edit and Delete. To conceal both Edit and Delete, do not define the 'ConfiForms Edit Controls' macro.
Label for Edit button	editButtonLabel	The text to display on the edit button.
Label for Delete button	deleteButtonLabel	The text to display on the delete button, which is actually a link in the user interface.
Post update message	updateMessage	The text to display after a record has been updated.
Hide control when stored data matches this criteria	hideIfMatches	The current ConfiForms entry stored by the form referenced will be concealed when the items in this parameter are matched in the entry. The control itself will be hidden when the condition/filter given is met, and this parameter uses the same syntax as in filters .

ConfiForms TableView

confiform-table

The macro to display stored data as a table, with instant search, filtering, and data sorting/ordering.

ConfiForms Form name	formName	The name of the ConfiForm form that TableView will use.
Form Location page	pageTitle	The name of the page on which the form is defined if not the current one; leave this blank if the form is defined on the same page.
Filter	filter	The filter to be applied to the stored dataset; see detailed documentation at ConfiForms Filters and/or in the tutorials.
Ordering/Sorting rules	sort	Rules for ordering and sorting the returned dataset; see detailed documentation at Sorting in ConfiForms and/or in the tutorials.
Enable instant search	enableSearch	This parameter adds a search input field above the table to enable quick searching and filtering of the stored data.
Enable export	export	This parameter provides a way for non-administrative users to download the returned data in CSV, XML, or JSON formats. While the form's administrative users can always export ConfiForms data with the administrative interface, they should enable data export for non-administrative users with the 'Allow data export' parameter in the ConfiForms form macro.
Pagination	pager	A parameter to enable displaying records in sets (for example, in groups of 1, 25, 50, 100, or 200 per page); if not configured then all stored records are shown.
Scrollable tables	wrapped	This parameter provides scroll bars for larger tables by applying CSS style rules.
CSS styles	css	Use this parameter to customize CSS styling for the table to be generated; to apply a CSS class prefix the ruleset with 'class:'
Striped table rendering	withHighlighting	This parameter enables highlighting alternate rows in a table.

ConfiForms ListView

confiform-list

This macro displays your stored data in WYSIWYG view (it also supports filtering and data sorting/ordering).

ConfiForms Form name	formName	The name of the ConfiForm form TableView should use.
Form Location page	pageTitle	The location of the page on which the form is defined; leave blank if the form is on the same page.
Filter	filter	A parameter for selecting records from the dataset; see detailed documentation at ConfiForms Filters and/or in the tutorials.
Pagination	pager	A parameter to enable displaying records in sets (for example, in groups of 1, 25, 50, 100, or 200 per page); if not configured then all stored records are shown.
Ordering/Sorting	sort	See detailed documentation at Sorting in ConfiForms and/or in the tutorials.
CSS styles	css	Use this parameter to customize CSS styling for the table to be generated; to apply a CSS class prefix the ruleset with 'class:'

ConfiForms CardView

confiform-card

This macro displays your stored data as a vertical table (or card) with instant search, filtering, and data sorting/ordering.

ConfiForms Form name	formName	The name of the ConfiForm form that CardView should use.
Form Location page	pageTitle	A parameter to store the page where the form has been defined; this should be left blank if the form is defined on the same page
Filters	filter	See detailed documentation at ConfiForms Filters and/or in the tutorials.
Ordering/Sorting rules	sort	See detailed documentation at Sorting in ConfiForms and/or in the tutorials.
Instant search	enableSearch	Adds a search input field above the table to enable quick search and filtering of stored data.
Enable export	export	This parameter provides a way for non-administrative users to download the returned data in CSV, XML, or JSON formats. While the form's administrative users can always export ConfiForms data with the administrative interface, they should enable data export for non-administrative users with the 'Allow data export' parameter in the ConfiForms form macro.
Pagination	pager	A parameter to enable displaying records in sets (for example, in groups of 1, 25, 50, 100, or 200 per page); if not configured then all stored records are shown.
Scrollable tables	wrapped	This parameter provides scroll bars for larger tables by applying CSS style rules.
CSS styles	css	Use this parameter to customize CSS styling for the table to be generated; to apply a CSS class prefix the ruleset with 'class:'

ConfiForms CalendarView

confiform-calendar

This macro displays your stored data in a calendar view.

Name of the field to use as a grouping field fro calendar	groupingFieldName	Must be of type Date/Datetime
ConfiForms Form name	formName	The name of the ConfiForm form that CardView should use.
Form Location page	pageTitle	A parameter to store the page where the form has been defined; this should be left blank if the form is defined on the same page
Filters	filter	See detailed documentation at ConfiForms Filters and/or in the tutorials.
Ordering/Sorting rules	sort	See detailed documentation at Sorting in ConfiForms and/or in the tutorials.
CSS styles	css	Use this parameter to customize CSS styling for the table to be generated; to apply a CSS class prefix the ruleset with 'class:'

ConfiForms Field

confiform-field

This macro defines a field to be displayed within the ConfiForms TableView, ListView, or CardView macros

Field name	fieldName	The name of the field defined on the form referenced. The macro's preview mode displays the field names stored within the form. The ConfiForm metadata fields are available always as well (see above).
Field label	withLabel	The label from the ConfiForms field definition will be added as a prefix before the field value.

Hide if empty	hideIfEmpty	Use this parameter in order to conceal a field when its stored value is blank, as in ListView or CardView, for example.
CSS styles	css	This parameter provides a way to apply CSS styles (for example: color:red; border:1px) to the field. Styles will be applied on stored values on output.

ConfiForms IFTTT

confiform-ifttt

This macro defines the integration rules for ConfiForms forms and is to be placed inside ConfiForms Form macro body. The macro body is used as the message body, task content, javascript snippet, page content, or request content, depending on the action type selected.

The macro body completely supports referencing records, including the record owner as [owner], the record modifier as [modifier], and any record field as [entry.FIELD_NAME]. The body can include complex types; see "Subject for email / title for page / url for request" below for details.

Event

event

onCreated - when a new record is created
onModified - when a record is modified
onDeleted - when a record is deleted

Action to be performed

action

Send Email - Send email to the list of participants, defined below
Create Page - Create a page based on a given template
Make request - Performs an HTTP request (GET or POST, depending on the macro body).
Send Notification - Send a Confluence notification
Create ConfiForms Entry - create a ConfiForms entry in another form (macro body is ignored)
Create Task - Creates task in Confluence for user
Run JavaScript - runs given Javascript snippet on ConfiForms event (Use this macro body to write your Javascript)

Subject for email / title for page / url for request

title

This setting defines the subject to be used on emails, the title for the page created, or the URL for an HTTP request. It
allows parameters and substitutions which can be constructed dynamically, including references to the record owner as [owner], the record modifier as [modifier], and any record field as [entry.FIELD_NAME].

Complex fields (such as of type page/blogpost or user) are also supported.

ConfiForms entry

This is used when referencing a smart classifier field, and it can access all the standard fields, plus additional fields defined in the ConfiForms entry:

id - the record id, unique for every saved record: [entry.FIELD_NAME.id]

ownedBy - the username of the user who owns the record (and can fully control it): [entry.FIELD_NAME.ownedBy]

ownedByName - the full name of the user who owns the record: [entry.FIELD_NAME.ownedByName]

createdBy - the username of the user who has created the record (admin users can create records for other users): [entry.FIELD_NAME.createdBy]

createdByName - the full name of the user who has created the record: [entry.FIELD_NAME.createdByName]

created - the timestamp when the record was created: [entry.FIELD_NAME.created]

dateCreatedFormatted - a formatted way to see the timestamp for a created record: [entry.FIELD_NAME.dateCreatedFormatted]

As well as other, non-standard fields defined in the ConfiForms entry: [entry.FIELD_NAME.FIELD_NAME]

User

fullName: [entry.FIELD_NAME.fullName]
username: [entry.FIELD_NAME.username]
email: [entry.FIELD_NAME.email]

Page/BlogPost

title: [entry.FIELD_NAME.title]
spaceKey: [entry.FIELD_NAME.spaceKey]
id: [entry.FIELD_NAME.id]
version: [entry.FIELD_NAME.version]

as well as other simple Page properties.

In order to reference fields to create the email body, a page template, and the data to send to another service, use either the ${} notation or the notation above, using [entry.FIELD_NAME]. Both methods are supported. See detailed example at Using IFTTT macro for integrations.

ConfiForms TableView Merger

confiform-table-merger

This ConfiForms helper macro merges TableView results.

This macro takes RICH TEXT as an input to define which fields (ConfiForms Field macros) to display and which tables to merge (in the ConfiForms TableView macros). It supports expressions which can be used when aggregating the data. Learn more in TableView Merger examples.

For examples, see the documentation in Merge and aggregation for ConfiForms and for advanced techniques, see Advanced aggregations in TableView Merger.
Filter	filter	Select records based on this configuration; see detailed documentation at ConfiForms Filters and/or in the tutorials.
Ordering/Sorting	sort	Rules for ordering or sorting entries in the dataset; see detailed documentation at Sorting in ConfiForms and/or in the tutorials.
Enable export	export	This parameter provides a way to download returned data in CSV, XML and JSON formats. Admin users can always export ConfiForms data with the administrative interface. For non-admin users, the form's owner should enable support for data export via 'Allow data export' in the ConfiForms form macro.
Pagination	pager	A parameter to enable displaying records in sets (for example, in groups of 1, 25, 50, 100, or 200 per page); if not configured then all stored records are shown.
Striped table rendering	withHighlighting	This parameter enables highlighting alternate rows in a table.

ConfiForms Field Definition Rules

confiform-field-definition-rules

This macro configures how ConfiForms Field Definitions are related. It supports creating complex relationships between form fields, based on selections, values entered, and so on. To be used inside the ConfiForms Form macro to define rules for Field Definitions.

Field name	actionFieldName	The name of the field to be tracked / validated.
Action	action	Action to perform Show field Hide field Set value Set value if empty Set expression Validation rule
Condition	condition	This parameter defines the condition to be met in order for the action to be executed; it uses the same syntax as in filters; and the scope is the current entry/record.
Actionable field name	fieldName	When the 'Show/Hide field' action is used, this parameter specifies which fields are affected (can specify a list of comma-separated field names to affect many fields at once). the name of the parameter depends on the action selected
Values to be set	values	When the 'Set value' (or 'Set value if empty') action is configured, this parameter specifies which fields and values are to be set. Values are set as key-value pairs, separated by & (as request parameters), where the ''key'' is the field name, and the ''value'' is the entry to be set. the name of the parameter depends on the action selected Important to note that for validations the regular expression is expected! See Automatic validation for your fields

CSS Rules for ConfiForms Fields

confiform-field-css

The macro to use to display fields based on their values. To be used inside the ConfiForms TableView, ListView, or CardView macros.

Field value or expression to match	condition	This parameter accepts values or expressions, similar to filters (see the detailed documentation on filters: ConfiForms Filters). The scope for filtering is the whole dataset and depends on the container macro in which this macro is used as the dataset is passed from the container macro.
Field name	fieldName	The name of the field to which the CSS styling rule(s) should be applied; if left empty, the style is applied to the row.
Conditional CSS	css	This parameter accepts valid CSS styles, separated by semicolon (for example: color:red;border:1px). Styles will be applied to a field (if given) or on a row when used within a table (a CSS container div is used when in ConfiForms ListView) if the field name is not set.

ConfiForms Entry Viewer

confiform-entry-viewer

The macro to use when you need to show all the fields for the stored entity in a readonly pop-up dialog.

Field name	fieldName	Name of the field defined on the form. Leave empty if you want to use just a static caption. See parameter below
Caption/label to use	buttonLabel	Static label to use for viewer field
Render as	type	The control can be rendered as: Button Link
View mode	mode	How the controls in the dialog should look like ReadOnly Editable
Visibility	restrictions	This parameter accepts a comma-separated list of groups and users to which this field will be visible. Leave this parameter blank if there are no restrictions.
Hide control when stored data matches this criteria	hideIfMatches	Current ConfiForms entry stored by the form referenced will be concealed when the items in this parameter are matched in the entry. The control itself will be hidden when the condition/filter given is met, and this parameter uses the same syntax as in filters .
CSS styles	css	This parameter provides a way to apply CSS styles (for example: color:red; border:1px) to the field. Styles will be applied on stored values on output.

How to reference a ConfiForms field:

from IFTTT macro body	[entry.FIELD_NAME] ${FIELD_NAME} (see IFTTT macro documentation for more details) using the ConfiForms Field Macro when IFTTT is used to create a page, and in this case the value will be dynamic.
from IFTTT macro title parameter	[entry.FIELD_NAME]
ConfiForms Registration Control, redirectURL parameter	[entry.FIELD_NAME]
in Calculated/Formula field, when constructing an expression	[entry.FIELD_NAME]

Also see Virtual functions

Page tree

Documentation

The ConfiForms Plugin

Our Backlog

Quick tips

Macro documentation

ConfiForms Form

ConfiForms Field Definition

ConfiForms Registration Control

ConfiForms Edit Controls

ConfiForms TableView

ConfiForms ListView

ConfiForms CardView

ConfiForms CalendarView

ConfiForms Field

ConfiForms IFTTT

ConfiForms TableView Merger

ConfiForms Field Definition Rules

CSS Rules for ConfiForms Fields

ConfiForms Entry Viewer

How to reference a ConfiForms field: