Справочник элементов

Атрибут типа Справочник элементов позволяет подключить различные папки как справочники содержащихся в них элементов. Для выбранных из справочника элементов автоматически создаётся связь для перехода к связанным элементам или быстрой фильтрации по ним.

Для настройки в Pilot-myAdmin:

• выберите нужный тип элемента или задания, для которого будет работать настройка;
• создайте атрибут типа Справочкик элементов;
• добавьте конфигурацию вида:

Где:

[идентификатор] — id корневого элемента справочника.

[имя атрибута] — значение атрибута для текста ссылки и заполнения поля карточки элемента.

Структура и параметры скрипта конфигурации

Скрипт конфигурации состоит из двух разделов:

• ElementBook — раздел конфигурации, который описывает сам справочник.
• AutoFill — раздел конфигурации, который описывает автозаполнение атрибута. Autofill работает только для заданий и срабатывает на добавление вложения.

Параметры атрибутов раздела ElementBook

Параметр	Описание параметра	Значения	Комментарий
Source	id корневого элемента структуры, множество значений которой сможет использовать атрибут.	"id"	Значение Source="00000001-0001-0001-0001-000000000001" соответствует папке Начало. Такое значение Source позволит использовать все элементы базы.
StringFormat	Определяет, какой из атрибутов элемента выбран для текста ссылки и заполнения поля в карточке.	"{имя атрибута}"	Например, при StringFormat="{code}" текст ссылки будет содержать значение поля Шифр элемента.
AllowMultiSelect	Разрешает выбор нескольких значений в диалоговом окне.	"True"	Выбор нескольких значений возможен (по умолчанию).
		"False"	Выбор ограничен одним значением.
ElementsTypes	Позволяет ограничить выбор элементов, указав только нужные имена.	“имя_типа_1, имя_типа_2, …”	Если атрибут не указан, то в справочник можно выбрать только элементы тех типов, для которых не указаны связи.
ShowInListView	Определяет, нужно ли показывать атрибут в списке элементов.	"True"	Атрибут виден (по умолчанию).
		"False"	Атрибут скрыт.
EnablePopupCommands	Определяет, будет ли активен атрибут, показанный в карточке.	"True"	Атрибут активен (по умолчанию).
		"False"	Атрибут неактивен.
CreateLink	Определяет будет ли создана дополнительная горизонтальная связь, отображаемая на вкладке Связи. В большинстве случаев создание дополнительной связи не требуется.	"True"	Связь создаётся.
		"False"	Связь не создаётся (по умолчанию).

Параметры атрибутов раздела AutoFill

Параметр	Описание параметра	Значения	Комментарий
When	Определяет, на какое событие срабатывает автозаполнение.	"{ событие}"	Необязательный параметр. Настройка работает только при добавлении вложения: When= "AttachmentChanged".
ValueSource	Определяет, откуда будет взято значение для автозаполнения.	"Self"	Значением атрибута будет само вложение.
		"Parent"	Значением атрибута будет один из родителей вложения (по умолчанию).
ParentType (если ValueSource ≠ "Self")	Фильтр типа родителей вложения.	“имя_типа”	Значение для автозаполнения будет взято у первого родителя вложения, соответствующего указанному типу.

Пример скрипта конфигурации с настройкой автозаполнения

Описание примера:

При добавлении вложения в задание произойдёт автозаполнение атрибута значением, взятым у родительского проекта вложения. Конфигурация работает со всем деревом, т.к. "00000001-0001-0001-0001-000000000001" — идентификатор папки Начало. Для заполнения поля атрибута Справочник элементов используется значение поля Шифр (StringFormat="{code}"). Конфигурация позволяет выбрать один элемент типа Проект.