Правила конфигурации для ВП "Мультиклассовый список связей"
Правило конфигурации необходимо создать для каждого класса объектов, с объектами которого предоставляется возможность устанавливать связь в виджете приложения.
Место действия в интерфейсе
Интерфейс оператора. Список правил конфигурации на карточке объекта.
Выполнение действия
На панели действий списка правил нажмите кнопку Добавить, заполните поля на форме добавления и нажмите кнопку Сохранить. Затем правило необходимо перевести в статус "Включено" (active).
Поля формы добавления правила конфигурации:
- Название правила конфигурации.
- Название объекта.
- Сокращенное название объекта.
- Иконка объекта.
- Код метакласса, для которого строится виджет.
- Код атрибута связи.
- Код атрибута с описанием.
-
Код атрибута с дедлайном.
Список связанных объектов в виджете по дате дедлайна из данного атрибута. Если даты дедлайна нет, то отображается в порядке добавления объектов.
- Код атрибута с ответственным.
- Код формы быстрого добавления объекта связи — код формы быстрого добавления объекта можно узнать в интерфейсе технолога в классе объектов, который будет создаваться в виджете приложения, на вкладке "Другие формы".
-
Название кнопки фильтрации списка связанных объектов — название кнопки фильтра на панели действий виджета приложения.
Если значение не задано, то в качестве названия кнопки фильтра будет использоваться название класса объектов, связанного по атрибуту "Код атрибута связи" (relationCode).
-
Доступен для связывания — наличие иконки добавления связи с объектом
на панели действий виджета приложения.(с версии 1.1.0).
Проверки атрибутов для корректного отображения приложения
Каждый связанный объект проверяется на соответствие с правилом конфигурации.
Для этого сравнивается код атрибута, указанный в правиле конфигурации в параметре "Код атрибута связи" (relationCode), с кодом атрибута связи объекта, для которого строится виджет. Если объект удовлетворяет одному из правил конфигурации, то в виджете приложения для него формируется строка в раскрывающемся списке выбора объектов и кнопка фильтра.
Список выбора объектов открывается при нажатии иконки или
.
Аналогично проверяется каждый атрибут правила.
Результаты проверки:
-
Если хотя бы один из атрибутов "Код метакласса" (metaClassCode) и "Код атрибута связи" (relationCode) не заполнен или заполнен неверно — нет класса с таким кодом или класс есть, но в нем нет атрибута связи с указанным кодом, то в данном случае приложение считает, что правило не найдено и в виджете ничего не отображается.
-
Если не заполнены атрибуты "Код формы быстрого добавления объекта связи" (fastAddForm) и/или "Название объекта" (objectTitle), то в списке выбора объектов не формируется строки объекта и объект не доступен для выбора.
Если атрибут "Название объекта" (objectTitle) заполнен, но код формы добавления задан неверно, то строка в списке выбора объектов отобразится, но при нажатии на нее форма добавления не открывается.
Отображение списка связанных объектов
В разделе описано влияние параметров правила на отображение элементов списка.
Для каждого объекта отображается:
-
Цветовой индикатор статуса — приложение получает код статуса state не по коду из правила конфигурации, а сразу из класса или типа, если не наследуются настройки класса.
- Если статусы жизненного цикла различаются для класса и типа в нем, то берется статус из типа объекта.
- Если цвет для статуса не задан, то отображается цвет фона.
-
Иконка или краткое название — из параметров, указанных в правиле конфигурации:
- "Иконка объекта" (objectIcon);
- "Сокращенное название объекта" (shortTitle).
Если заполнены оба атрибута, то приоритет отображения у иконки. Если не заполнен ни один, то отображается фон.
-
Описание — из параметра "Код атрибута с описанием" (textCode), указанного в правиле конфигурации. Это может быть описание, тема или любой другой текстовый атрибут связанного объекта.
Если атрибут не заполнен, то отображается фон.
Если текст не помещается в поле, то при наведении курсора на поле с описанием отображается всплывающая подсказка с полным содержимым.
-
Дата дедлайна — из параметра "Код атрибута с дедлайном" (dateCode), указанного в правиле конфигурации. Это может быть любой атрибут типа "Счетчик времени(обратный)" или "Дата/время".
В активном состоянии или приостановленном счетчик отображается черным цветом. Если закончился отсчет или наступило время дедлайна, то счетчик отображается красным цветом.
Если в атрибуте "Код атрибута с дедлайном" (dateCode) не указано значение или если оно указано, но текущему объекту не задали значение, то счетчик принимает пустой вид.
Счетчик обновляется в момент обновления списка и при открытии или обновлении страницы.