Правила конфигурации для ВП "Мультиклассовый список связей"

Правило конфигурации необходимо создать для каждого класса объектов, с объектами которого предоставляется возможность устанавливать связь в виджете приложения.

Место действия в интерфейсе

Интерфейс оператора. Список правил конфигурации на карточке объекта.

Выполнение действия

На панели действий списка правил нажмите кнопку Добавить, заполните поля на форме добавления и нажмите кнопку Сохранить. Затем правило необходимо перевести в статус "Включено" (active).

Поля формы добавления правила конфигурации:

  • Название правила конфигурации.
  • Название объекта.
  • Сокращенное название объекта.
  • Иконка объекта.
  • Код метакласса, для которого строится виджет.
  • Код атрибута связи.
  • Код атрибута с описанием.
  • Код атрибута с дедлайном.

    Список связанных объектов в виджете по дате дедлайна из данного атрибута. Если даты дедлайна нет, то отображается в порядке добавления объектов.

  • Код атрибута с ответственным.
  • Код формы быстрого добавления объекта связи — код формы быстрого добавления объекта можно узнать в интерфейсе технолога в классе объектов, который будет создаваться в виджете приложения, на вкладке "Другие формы".
  • Название кнопки фильтрации списка связанных объектов — название кнопки фильтра на панели действий виджета приложения.

    Если значение не задано, то в качестве названия кнопки фильтра будет использоваться название класса объектов, связанного по атрибуту "Код атрибута связи" (relationCode).

  • Доступен для связывания — наличие иконки добавления связи с объектом на панели действий виджета приложения.(с версии 1.1.0).

Проверки атрибутов для корректного отображения приложения

Каждый связанный объект проверяется на соответствие с правилом конфигурации.

Для этого сравнивается код атрибута, указанный в правиле конфигурации в параметре "Код атрибута связи" (relationCode), с кодом атрибута связи объекта, для которого строится виджет. Если объект удовлетворяет одному из правил конфигурации, то в виджете приложения для него формируется строка в раскрывающемся списке выбора объектов и кнопка фильтра.

Список выбора объектов открывается при нажатии иконки или .

Аналогично проверяется каждый атрибут правила.

Результаты проверки:

  • Если хотя бы один из атрибутов "Код метакласса" (metaClassCode) и "Код атрибута связи" (relationCode) не заполнен или заполнен неверно — нет класса с таким кодом или класс есть, но в нем нет атрибута связи с указанным кодом, то в данном случае приложение считает, что правило не найдено и в виджете ничего не отображается.

  • Если не заполнены атрибуты "Код формы быстрого добавления объекта связи" (fastAddForm) и/или "Название объекта" (objectTitle), то в списке выбора объектов не формируется строки объекта и объект не доступен для выбора.

    Если атрибут "Название объекта" (objectTitle) заполнен, но код формы добавления задан неверно, то строка в списке выбора объектов отобразится, но при нажатии на нее форма добавления не открывается.

Отображение списка связанных объектов

В разделе описано влияние параметров правила на отображение элементов списка.

Для каждого объекта отображается:

  • Цветовой индикатор статуса — приложение получает код статуса state не по коду из правила конфигурации, а сразу из класса или типа, если не наследуются настройки класса.

    • Если статусы жизненного цикла различаются для класса и типа в нем, то берется статус из типа объекта.
    • Если цвет для статуса не задан, то отображается цвет фона.
  • Иконка или краткое название — из параметров, указанных в правиле конфигурации:

    • "Иконка объекта" (objectIcon);
    • "Сокращенное название объекта" (shortTitle).

    Если заполнены оба атрибута, то приоритет отображения у иконки. Если не заполнен ни один, то отображается фон.

  • Описание — из параметра "Код атрибута с описанием" (textCode), указанного в правиле конфигурации. Это может быть описание, тема или любой другой текстовый атрибут связанного объекта.

    Если атрибут не заполнен, то отображается фон.

    Если текст не помещается в поле, то при наведении курсора на поле с описанием отображается всплывающая подсказка с полным содержимым.

  • Дата дедлайна — из параметра "Код атрибута с дедлайном" (dateCode), указанного в правиле конфигурации. Это может быть любой атрибут типа "Счетчик времени(обратный)" или "Дата/время".

    В активном состоянии или приостановленном счетчик отображается черным цветом. Если закончился отсчет или наступило время дедлайна, то счетчик отображается красным цветом.

    Если в атрибуте "Код атрибута с дедлайном" (dateCode) не указано значение или если оно указано, но текущему объекту не задали значение, то счетчик принимает пустой вид.

    Счетчик обновляется в момент обновления списка и при открытии или обновлении страницы.