¶ Редактор аргументов
Позволяет редактировать значения аргументов для пользовательского представления.
Аргументы отображаются в редакторе в том же порядке, в котором указаны в коде представления.
¶ Как открыть
Если у представления есть аргументы, редактор можно открыть через контекстное меню представления (три точки справа сверху).
¶ Быстрый доступ
Можно включить отображение кнопки "Фильтры" прямо над данными, чтобы пользователь мог быстро открыть и закрыть фильтры. Для этого надо для представления включить атрибут show_argument_button.
Вот так:
{ $arg int }:
SELECT
@show_argument_button = true,
...
В итерфейсе слева над данными появится кнопка "Фильтры". Пользователь сможет нажимая на нее отображать и скрывать аргементы:
¶ Открывать по умолчанию
Атрибут запроса show_argument_editor позволяет открывать редактор сразу при загрузке пользовательского представления:
{ $arg int }:
SELECT
@show_argument_editor = true,
...
¶ Атрибуты аргументов
| Атрибут | Тип | Описание |
|---|---|---|
caption |
строка | Отображаемое название аргумента. По умолчанию берётся название атрибута |
options_view |
ссылка на представление | Для аргументов с типом reference или array(reference(...)) позволяет ограничить список значений в выпадающем меню. Подробнее про options_view написано тут |
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может быть не выбран. C помощьюoptions_viewзадается набор значений, которые будут доступны для выбора в выпадающем списке значений для этого аргумента.referenced_entityуказывает сущность, из которой будет браться__mainв случаях, когда выбранного значения нет в в списке изoptions_view(Это воможно, например, если значение аргумента передано в представление извне - из другого представления)statuses- массив идентификаторов записи "статус". То есть в аргументе можно выбрать несколько значений статусов. С помощьюoptions_viewиreferenced_entityзадаются возможные значения, с помощьюcontrol_heightограничивается максимальная высота инпута аргумента.