The filter mission is to limit the set of records that will be displayed in the list (in any list: related list, open list, the dictionary). The filter is a set of conditions the record must meet to be on the list. Filters can be configured with the condition builder.
Dynamic filters extend the filters by the JS scripts executing ability. This ability is available in the list condition builder and in the dynamic reference qualifier condition builder.
In Condition Builder, dynamic filters are available when selecting the reference field and the 'is dynamic' operator (system name is ISDYNAMIC). After this, the list of available dynamic filters will appear.
When executing the filter as a value of the condition using the 'is dynamic' operator, the value returned by the dynamic filter script will be used.
To create a new dynamic filter, please complete the following steps (a new record in the sys_filter_option_dynamic will be created):
| Field | Description |
|---|---|
| Title | The filter title. |
| Script | Enter the script that the dynamic filter runs. You can use all methods of server-side API classes here, After executing, the script should return the record ID or array of IDs. |
| Active | Turn this checkbox on to make the filter active. |
| Available for filter | Turn this checkbox on if you need this filter to be available in the list filters. |
| Available for reference qualifier | Turn this checkbox on if you need this filter to be a dynamic reference qualifier. |
| Order | Enter the number to define the order of filter processing. |
| Column type | The column type used in the filter. |
| Referenced table | The table |
| Sys updated by | Information about who has updated the record. |
| Sys created by | Information about who has created the record. |
Скрипт (поле script) динамического фильтра обязан вернуть идентификатор записи или массив, состоящий из идентификаторов записи.