¶ Ограничение набора данных в выпадающих списках
¶ Для чего применять
Использование ограничения на данные в выпадающем списке может быть полезным, когда ограничение должно быть только на уровне пользовательского интерфейса, а проверки check constraints не могут быть применимы к задаче.
Например, нужно чтобы пользователь в поле "Ответственный" за задачу мог выбрать только из сотрудников, которые работают прямо сейчас.
Использование условия в check constraint-е вида "ответственный - это сотрудник, который работает сейчас" не подойдет, так как попытка "увольнения" сотрудника приведет к тому, что все записи, где этот сотрудник был ответственным, перестанут проходить проверку и "увольнения" не получится.
В этом случае стоит использовать интерфейсное ограничение на данные в выпадающем списке.
Это ограничение позволяет выводить в интерфейсе пользователя только "сотрудников, работающих сейчас", при этом ни в каких проверках данных в базе это ограничение не нуждается. В таблице задач могут присутствовать старые записи, в которых, например, ответственный - уже не работает.
¶ Как использовать
Для использования интерфейсных ограничений необходимо:
- Создать пользовательское представление с данными для выпадающего списка
- Указать ссылку на это пользовательское представление в атрибуте
options_viewдля референс-поля
¶ 1. Создание пользовательского представления
- В пользовательском представлении должно быть две колонки -
valueиpun:value- содержит идентификатор записи, которая будет вставляться в референс-поле при выбореpun- строка-лэйбл, которая будет отображаться в выпадающем списке
- В представлении может быть любой уровень сложности и вложенности подзапросов, но нужно не забывать, что запрос из вью будет исполняться при каждом использовании референс-поля.
- В представление можно передать аргументы извне и использовать их для фильтрации
Если уж выбранное значение в референс-поле не было найдено в представлении, на которое ссылается
options_view, то в качестве лэйбла отобразится значение главной колонки (как обычно и происходит без ограничений).
¶ 2. Указание ссылки в атрибуте
- В атрибуте
options_viewуказывается ссылка на представление с набором данных:
options_view = &schema.user_view_name
- В представление можно при необходимости передать аргументы:
options_view = {
ref: &schema.user_view_name,
args: {
arg1: $id,
arg2: 95
}
}
¶ В референс-полях
SELECT
....
responsible_contact @{
link = &base.person_form,
options_view = &hrm.ref_employees_working_now_view,
},
...
FROM
pm.actions
...
Пример использования:
Таблица Действий
Представление для ограничения таблицы действий
¶ В мультиселектах
С помощью options_view можно ограничить значения в выпадающем всписке в представлении с типом multi_select:
{ $id reference(user.groups) }:
SELECT
@type = 'multi_select',
@options_view = {
ref: &user.only_my_tasks,
args: {
person: (SELECT id FROM base.people WHERE user = $$user_id)
}
},
"group" @{
default_value = $id,
},
task @{
"select" = true,
}
FROM
user.tasks_for_groups
WHERE
"group"= $id
FOR INSERT INTO
user.tasks_for_groups
¶ В аргументах
{
$owner reference(base.people) null @{
caption = 'Ответственный',
options_view = &hrm.ref_employees_working_now_view,
}
}:
SELECT
...
FROM
...
WHERE
$owner IS NULL OR responsible_person = $owner
...
Пример использования: Доска Сделок