Атрибуты с типом данных Ссылка на элемент списка (Lookup) - одни из самых часто используемых атрибутов в системе.
Их использование пользователями описывает гибкая настройка на основной вкладке карточки атрибута (см. скрин ниже).
Вкладка "Тип элемента" содержит перечень типов элементов, в которых используется данный атрибут (заполняется системой автоматически).
1. В поле Название указать название атрибута как его будет видеть пользователь в интерфейсе. Атрибут является обязательным для заполнения. Обязательное поле.
2. В поле Системное имя указать системное имя атрибута как он запишется в базе данных. Атрибут является обязательным для заполнения.
Важно: системное имя указать в режиме snake_case – латинскими буквами, без caps lock и пробелов.
3. В поле Описание указать описание атрибута (где используется и для чего).
4. В поле Отображаемы атрибуты указать системные имена атрибутов элементов списка. Обязательное поле.
Пример 1 Отображаемые атрибуты = name,image:
| Настройка: Отображаемые атрибуты | Результат для пользователя |
|---|---|
|
|
Пример 2 Отображаемые атрибуты = name,image,position:
| Настройка: Отображаемые атрибуты | Результат для пользователя |
|---|---|
|
|
5. В поле Дополнительные атрибуты при необходимости можно указать системные имена атрибутов элементов списка.
Пример атрибута Статус Согласования – в поле Дополнительные атрибуты указан атрибут color(цвет) - пользователь видит "светофор":
| Настройка: Отображаемые атрибуты | Результат для пользователя |
|---|---|
|
|
6. В поле Значение по умолчанию при необходимости можно указать уникальный id элемента списка, который будет по умолчанию подставляться в атрибут.
7. Отметить флаг Выбор элементов, если при заполнении атрибута необходимо делать выбор значения из сложного иерархического списка или искать значение по нескольким критериям. У пользователя появиться возможность открыть форму выбора с иерархией, фильтрацией и поиском.
Пример с включенным флагом Выбор элементов:
| Результат для пользователя | Форма выбора элемента |
|---|---|
|
|
8. В поле Список указать название связанного с атрибутом справочника. Обязательное поле. если не заполнено поле Фильтр списков.
9. Отметить флаг Множественный выбор из списка, если значение атрибута может принимать несколько значений.
10. При необходимости можно указать в поле Минимальное количество символов, используемых для контекстного поиска значения в атрибутах из поля «Отображаемые атрибуты». При указании значения 0, выпадающий список значений появляется при активации поля.
11. В поле Фильтр значений при необходимости можно указать формулу, на основе которой будет происходить фильтрация списка при заполнении атрибута.
Пример: У атрибута Статус согласования поле Фильтр значений содержит формулу
GetList("bb6d31b7-7ffa-485b-a90c-483c43b0cc81", "i => (new Guid[] {Guid(\"57465f37-3c35-4d73-96e7-b3b53bdd8336\"), Guid(\"0d43e15e-fa91-4976-bd5e-9f8423247d80\"), Guid(\"d1abf56b-cfba-49ba-89e3-672ad012e0d8\")}).Contains(i.Id)", false)
Объяснение: на основании формулы - значения при заполнении атрибута Статус Согласования будут подставляться в соответствии с формулой:
- для типа элемента с ид 57465f37-3c35-4d73-96e7-b3b53bdd8336, атрибут Статус согласования будет заполняться только:
- значениями с ид 0d43e15e-fa91-4976-bd5e-9f8423247d80;
- и значением с ид d1abf56b-cfba-49ba-89e3-672ad012e0d
- для типа элемента с ид 57465f37-3c35-4d73-96e7-b3b53bdd8336, атрибут Статус согласования будет заполняться только:
12. В поле Фильтр списков при необходимости можно указать формулу, на основе которой будет происходить отбор списков списков, откуда можно выбрать значение при заполнении атрибута. При этом поле Список должно быть пустым
Пример: У атрибут Папка проектов заполнено поле Фильтр списков. В соответствии с формулой в этот атрибут можно выбрать значение из всех списков с типом "архив"
13. В поле Вид при необходимости указываться пользовательский вид отображения в форме Выбора элемента, заполняется только при включенном флаге Выбор элементов