¶ Фильтры (редактор аргументов)
Панель фильтров - это редактор, который позволяет изменять значения аргументов для пользовательских представлений.
Аргументы отображаются в панели фильтров в том же порядке, в котором аргументы указаны в коде представления.
¶ Как открыть панель фильтров
Если у представления есть аргументы, панель фильтров всегда можно открыть через контекстное меню представления (три точки справа сверху).
Так же с помощью дополнительных атрибутов можно установить быстрый доступ к редактору аргументов для пользователя.
¶ Быстрый доступ к фильтрам
Чтобы упростить доступ к панели, можно включить кнопку "Фильтры", отображаемую слева над данными. Пользователь сможет быстро открывать и закрывать фильтры, что облегчит навигацию.
Для этого в коде представления нужно добавить атрибут show_argument_button со значением true:
{ $arg int }:
SELECT
@show_argument_button = true,
...
Старый атрибут представления
show_argument_editorтоже добавляет кнопку "Фильтры" в шапку представления, но оставлен для обратной совместимости.
Рекомендуется использовать атрибутshow_argument_button
¶ Атрибуты аргументов
caption: Отображаемое название аргумента. По умолчанию берется название атрибута.options_view: Для аргументов с типомreferenceилиarray(reference(...)), позволяет ограничить список значений в выпадающем меню. Подробнее здесь.control_height: Высота в пикселях для окна выбора в нераскрытом состоянии.
¶ Примеры аргументов с атрибутами
{
$date_from date @{
caption: 'Период с'
},
$date_to date @{
caption: 'Период по'
},
$is_active bool default false @{
caption: 'Активен'
},
$responsible reference(base.people) null @{
caption: 'Ответственный',
options_view = &pm.ref_active_employees_view,
referenced_entity = {
schema: 'base',
name: 'people'
},
},
$statuses array(reference(pm.statuses)) null @{
caption: 'Статус',
options_view = &pm.ref_active_actions_statuses_view,
referenced_entity = {
schema: 'pm',
name: 'statuses'
},
control_height = 50
}
}:
- Первые два аргумента,
date_fromиdate_to, должны обязательно передаваться в представление - они не могут быть пустыми. - Аргумент
is_activeможно не передавать в представление, тогда по умолчанию его значение будетfalse. responsibleможет быть не выбран. С помощьюoptions_viewзадается набор значений, доступных для выбора.statuses- массив идентификаторов статусов. В аргументе можно выбрать несколько значений статусов. С помощьюoptions_viewиreferenced_entityзадаются возможные значения, аcontrol_heightограничивает максимальную высоту инпута аргумента.