...
| 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 myfield.timestamp | [entry.myfield] [entry.myfield.timestamp] | Same as numeric field | as number | timestamp value Date and Datetime field types allow the following metaparams to be given as input [now], [tomorrow], [yesterday], [today], [today]-days(n), [datetimeyyyyMMdd HH:mm], [dateyyyyMMdd] Basically, same as in ConfiForms Filters | ||||||
| Datetime | myfield myfield.timestamp | [entry.myfield] [entry.myfield.timestamp] | Same as numeric field | as number | timestamp value See above | ||||||
| Datetime interval | myfield myfield.startDateFormatted myfield.endDateFormatted myfield.startDate myfield.endDate myfield.asPeriodFormatted | [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 | ||||||
| DB dropdown | myfield myfield.id myfield.label | see remarks -> | Same as normal dropdown | ||||||||
| DB multi-select | myfield | see remarks -> | Same as normal multi-select | ||||||||
| DB radio group | myfield | see remarks -> | Same as normal radio group | ||||||||
| DB checkbox | myfield | see remarks -> | Same as normal checkbox | ||||||||
| Drawing canvas | myfield | N/A | N/A | N/A | internal format is returned | ||||||
| Dropdown | myfield myfield.id myfield.label | [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 myfield.id myfield.label | [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 myfield.id myfield.label | [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 myfield.key myfield.title myfield.summary (same as title) myfield.description myfield.link myfield.status
Any JIRA field which is provided via JIRA REST API For example: myfield.fields.assignee.emailAddress myfield.fields.reporter.displayName See also: Using Field Definition Rule to request data from JIRA and set it to ConfiForms fields | [entry.myfield] [entry.myfield.key] [entry.myfield.title]
[entry.myfield.summary] (same as title) [entry.myfield.description] [entry.myfield.link] [entry.myfield.status] | same as text type and only by key | as text | |||||||
| Page/Blog post | myfield myfield.* - see remarks | [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 myfield.id myfield.label | [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 myfield.* - see remarks | [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. Example:
| ||||||
| Smart Dropdown | myfield myfield.* - see remarks | [entry.myfield] [entry.myfield.*] - see remarks | See Smart Classifier | depends on a field referenced | See Smart Classifier | ||||||
| Smart Multiselect | myfield myfield.* - see remarks | [entry.myfield] [entry.myfield.*] - see remarks | See Smart Classifier | depends on a field referenced | See Smart Classifier | ||||||
| Smart Checkbox | myfield myfield.* - see remarks | [entry.myfield] [entry.myfield.*] - see remarks | See Smart Classifier | depends on a field referenced | See Smart Classifier | ||||||
| Smart Radio buttons | myfield myfield.* - see remarks | [entry.myfield] [entry.myfield.*] - see remarks | See Smart Classifier | depends on a field referenced | See Smart Classifier | ||||||
| Status | myfield myfield.id myfield.label | [entry.myfield] [entry.myfield.id] [entry.myfield.label] | Same as dropdown field, with IDs and LABELs. But has predefined values for IDs (depending on a colour) | as text | See remarks for dropdown field | ||||||
| Textarea | myfield | [entry.myfield] | same as text type | as text | |||||||
| User | myfield myfield.username myfield.fullName myfield.picture myfield.email myfield.lastName myfield.firstName | [entry.myfield] [entry.myfield.username] [entry.myfield.fullName] [entry.myfield.picture] [entry.myfield.email] [entry.myfield.lastName] [entry.myfield.firstName] | same as text type, but you can query for field properties: myfield: myfield.username: myfield.fullName: myfield.picture: myfield.email: myfield.lastName: myfield.firstName: | as text, see remarks | sorting is by username field lastName and firstName are synthetic properties, which we try to extract from a given fullName. We consider las word as lastName and what is given before is taken as firstName. This solution does not work for the whole world, but this is the best option we can offer you at the moment | ||||||
| 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 |
...