Справочник элементов
Атрибут типа Справочник элементов позволяет подключить различные папки как справочники содержащихся в них элементов. Для выбранных из справочника элементов автоматически создаётся связь для перехода к связанным элементам или быстрой фильтрации по ним.
Для настройки в Pilot-myAdmin:
- выберите нужный тип элемента или задания, для которого будет работать настройка;
- создайте атрибут типа Справочкик элементов;
- добавьте конфигурацию вида:
<Configuration>
<ElementBook
Source="[идентификатор]"
StringFormat="{[имя атрибута]}"/>
</Configuration>
Где:
[идентификатор] — id корневого элемента справочника.
[имя атрибута] — значение атрибута для текста ссылки и заполнения поля карточки элемента.
Структура и параметры скрипта конфигурации
<Configuration>
<ElementBook
[параметры справочника]/>
<AutoFill
[параметры автозаполнения]/>
</Configuration>
Скрипт конфигурации состоит из двух разделов:
- 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
(если |
Фильтр типа родителей вложения. | “имя_типа” | Значение для автозаполнения будет взято у первого родителя вложения, соответствующего указанному типу. |
Пример скрипта конфигурации с настройкой автозаполнения
<Configuration>
<ElementBook
Source="00000001-0001-0001-0001-000000000001"
StringFormat="{code}"
ElementsTypes="project"
AllowMultiSelect="false"/>
<AutoFill
When="AttachmentChanged"
ValueSource="Parent"
ParentType="project"/>
</Configuration>
Описание примера:
При добавлении вложения в задание произойдёт автозаполнение атрибута значением, взятым у родительского проекта вложения. Конфигурация работает со всем деревом, т.к. "00000001-0001-0001-0001-000000000001" — идентификатор папки Начало. Для заполнения поля атрибута Справочник элементов используется значение поля Шифр (StringFormat="{code}"). Конфигурация позволяет выбрать один элемент типа Проект.