a!recordFilterChoices() Function

System Functions

Function

a!recordFilterChoices( choiceLabels, choiceValues )

Creates choices of a user filter for an expression-backed record.

Parameters

Keyword	Type	Description
`choiceLabels`	List of Text String	The list of text to be displayed to the user as the filter choices.
`choiceValues`	List of Variant	The list of values associated with the available choices.

Usage considerations

To use this function in your record type, see User filters for record types that use a web service.

Since users can save default selections for user filters, try to use expressions that rarely change the choices available. If users save a choice that is not available the next time they load the record, their saved filter selections will be cleared and a warning message will display.

Example

=a!recordFilterChoices(
  choiceLabels: {"Active", "Inactive"},
  choiceValues: {1, 0}
)

Feature compatibility

The table below lists this function's compatibility with various features in Appian.

Feature	Compatibility	Note
Portals	Partially compatible	Can be used with Appian Portals if it is connected using an integration and web API.
Offline Mobile	Partially compatible	Can be used with offline mobile if it is loaded at the top of the form.
Sync-Time Custom Record Fields	Incompatible
Real-Time Custom Record Fields	Incompatible
Process Reports	Incompatible	You cannot use this function to configure a process report.
Process Events	Incompatible	You cannot use this function to configure a process event node, such as a start event or timer event.

a!recordFilterChoices() Function