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.
ConfiForms has a lot of various field types to help you with building your data forms. And it has very sophisticated system to retrieve the values stored, including accessing rich objects such as Page, User and other referenced Records when used together with "smart fields"
Accessing values using Velocity syntax is deprecated and not supported in 100% of cases. Please try to accomplish what you have to do using [entry.] notation
Here is the table showing you how to reference field values for different field types. Our field name is: "myfield"
Field type | Accessing in ConfiForms Field macro | Accessing though [entry.] notation | Using in filters | Sorting | Remarks |
---|---|---|---|---|---|
Text | myfield | [entry.myfield] | myfield:*test myfield:test* myfield:*test* myfield:* | as text | |
Action Button | myfield | N/A | N/A | N/A | N/A |
Autolink | myfield | [entry.myfield] | same as text field | as text | only dynamic part is taken when shown as [entry.] notation |
Autonumber | myfield | [entry.myfield] | same as text field | as text | autonumber with previx |
Autopage | myfield | See page type | See page type | See page type | See page type |
Calculated | myfield | [entry.myfield] | Same as numeric field | as number | non-numeric values are set as 0 in sorting |
Captcha | myfield | N/A | N/A | N/A | N/A |
Checkbox | myfield | [entry.myfield] | myfield:true | Returns true or false | |
Checkbox group | myfield | [entry.myfield] | myfield:*fieldvalue* to ensure it is matched | as text | |
Currency | myfield | [entry.myfield] | Same as numeric field | as number | |
Date | myfield | [entry.myfield] | Same as numeric field | as number | timestamp value |
Datetime | myfield | [entry.myfield] | Same as numeric field | as number | timestamp value |
Datetime interval | myfield | [entry.myfield] [entry.myfield.startDateFormatted] [entry.myfield.endDateFormatted] [entry.myfield.startDate] [entry.myfield.endDate] [entry.myfield.asPeriodFormatted] | myfield.startDate: myfield.endDate: conditions as in numeric field | as number by start date | timestamp value |
Drawing canvas | myfield | N/A | N/A | N/A | internal format is returned |
Dropdown | myfield | [entry.myfield] [entry.myfield.id] [entry.myfield.label] | myfield:ID myfield.label:LABEL | as text | Each dropdown choice has ID and LABEL [entry.myfield] returns ID |
Dynamic Dropdown | myfield | [entry.myfield] [entry.myfield.id] [entry.myfield.label] | myfield:*fieldvalue* to ensure it is matched | as text | Each dropdown choice has ID and LABEL [entry.myfield] returns ID |
Dynamic Multilabel | myfield | [entry.myfield] [entry.myfield.id] [entry.myfield.label] | myfield:*fieldvalue* to ensure it is matched | as text | Each choice has ID and LABEL [entry.myfield] returns ID |
Enroll button | myfield | N/A | N/A | N/A | |
File | myfield | [entry.myfield] - will show as link | same as text, see remarks | as text | only attachment/file name is in search |
Formula | myfield | [entry.myfield] | same as numeric field | as number | non-numeric values are set as 0 in sorting |
Html | myfield | [entry.myfield] | same as text type | as text | |
Link | myfield | [entry.myfield] | same as text type | as text | |
Hidden | myfield | [entry.myfield] | same as text type | as text | |
Masked Text | myfield | [entry.myfield] | same as text type | as text | |
Multi Select | myfield | [entry.myfield] | same as dropdown (ID and LABEL properties) | as text | |
Numeric field | myfield | [entry.myfield] | myfield:>= myfield:> myfield:<= myfield:< myfield: | as number | |
JIRA issue | myfield | [entry.myfield] [entry.myfield.key] [entry.myfield.title] [entry.myfield.summary] [entry.myfield.link] | same as text type and only by key | as text | |
Page/Blog post | myfield | [entry.myfield] [entry.myfield.*] - see remarks | same as text, for properties list see remarks | as text, by default pageId | all properties of AbstractPage class (see Confluence API docs) |
Password | myfield | [entry.myfield] | same as text type | as text | |
Radio group | myfield | [entry.myfield] [entry.myfield.id] [entry.myfield.label] | myfield:ID myfield.label:LABEL | as text | Each choice has ID and LABEL [entry.myfield] returns ID |
Readonly | myfield | [entry.myfield] | same as text type | as text | |
Section | myfield | N/A | N/A | N/A | |
Simple Date | myfield | [entry.myfield] | Same as numeric field | as number | timestamp value |
Smart Classifier | myfield | [entry.myfield] [entry.myfield.*] - see remarks | Depends on a field referenced. If [entry.myfield] or just "myfield" is referenced then in most cases it acts as text. But with "smart fields" you reference a record in another form and that means through this reference you can get ANY field of that record, including other smart fields. That said, you can build quite a property graph to get any value, which is lazy loaded for you | depends on a field referenced | Properties you can access totally depend on a structure of the record in the form you reference. You can access ANY field value through this notation, including other smart fields which will be lazy loaded for you. |
Smart Dropdown | myfield | [entry.myfield] [entry.myfield.*] - see remarks | See Smart Classifier | depends on a field referenced | See Smart Classifier |
Smart Multiselect | myfield | [entry.myfield] [entry.myfield.*] - see remarks | See Smart Classifier | depends on a field referenced | See Smart Classifier |
Smart Checkbox | myfield | [entry.myfield] [entry.myfield.*] - see remarks | See Smart Classifier | depends on a field referenced | See Smart Classifier |
Smart Radio buttons | myfield | [entry.myfield] [entry.myfield.*] - see remarks | See Smart Classifier | depends on a field referenced | See Smart Classifier |
Status | myfield | [entry.myfield] | Same as dropdown field, with IDs and LABELs. But has predefined values for IDs (depending on a colour) | as text | |
Textarea | myfield | [entry.myfield] | same as text type | as text | |
User | myfield myfield.username myfield.fullName myfield.picture myfield.email | [entry.myfield] [entry.myfield.username] [entry.myfield.fullName] [entry.myfield.picture] [entry.myfield.email] | same as text type, but you can query for field properties: myfield: myfield.username: myfield.fullName: myfield.picture: myfield.email: | as text, see remarks | sorting is by username field |
User (multiselect) | myfield | [entry.myfield] [entry.myfield.asUserFullNames] [entry.myfield.asUserEmails] * - see remarks | Same as User | as text | You can show user full names in a list, or emails or (when no helper function is used) as list of usernames |
Voting control | myfield | N/A | N/A | N/A | N/A |
WYSIWYG simple editor | myfield | [entry.myfield] | same as text type | as text |
Accessing through [entry.] notation can be used in ListView, in PlainView, in CalendarView and in IFTTT macro body, as well as when referencing ConfiForms record fields in macro parameters
See also Virtual functions to help you with formatting values in the format you want
Accessing values using Velocity syntax is deprecated and not supported in 100% of cases. Please try to accomplish what you have to do using [entry.] notation