Объектная модель приложения "Мультиклассовый список связей"
Для работы приложения "Мультиклассовый список связей" необходима настроенная объектная модель: класс "Правило конфигурации ВП" и справочник с иконками.
Объектную модель можно добавить в систему при загрузке метаинформации или создать вручную.
Загрузка объектной модели
Перед загрузкой метаинформации нужно убедиться, что в системе нет классов и типов с такими же кодами, как в объектной модели, чтобы избежать потерю данных.
В интерфейсе администратора перейдите в раздел "Настройка системы" → "Администрирование". На вкладке "Управление системой" в блоке "Выгрузка/ загрузка" в строке "Метаинформация" нажмите кнопку Загрузить, выберите файл с метаинформацией и нажмите кнопку Начать загрузку. После этого выполнится процесс загрузки файла.
Загрузка метаинформации может занимать длительное время. Во время загрузки могут появляться сообщения о результатах загрузки или о превышении таймаута загрузки. Достоверным критерием окончания загрузки является появление в логе действий технолога события с сообщением о завершении загрузки метаинформации.
По итогам загрузки метаинформации в системе создается класс "Правило конфигурации ВП" и вложенный тип "Визуализация связей", а также справочник "Иконки для ВП "Мультиклассовый список связей".
Подробное описание загрузки метаинформации в систему приводится в разделе Выгрузка и перенос настроек системы (метаинформации).
Класс объектов "Правило конфигурации ВП"
Класс "Правило конфигурации ВП" (appConfig) предназначен для хранения структуры.
Класс содержит тип "Визуализация связей".
В классе есть жизненный цикл.
Статусы: "Настройка" (registred), "Включено" (active), "Выключено" (closed).
Тип объектов "Визуализация связей"
Вся объектная модель настроена на уровне типа "Визуализация связей" (relationConfig). Тип хранит в себе правила конфигурации для отображения связанных объектов в виджете приложения и возможности добавления новых связанных объектов и установления связи с уже существующими объектами.
Атрибуты типа
-
"Название правила конфигурации" (title) — используется для отображения названия в списке правил конфигурации.
Тип "Строка". Обязательный, редактируемый.
-
"Название объекта" (objectTitle) — используется для формирования названия объекта в раскрывающемся списке выбора объектов, который отображается при нажатии иконки
или
на панели действий виджета приложения.
Тип "Строка". Обязательный, редактируемый.
-
"Сокращенное название объекта" (shortTitle) — используется для отображения типа объекта.
Тип "Строка". Редактируемый.
-
"Иконка объекта" (objectIcon) — используется для отображения типа объекта в виде иконки.
Тип "Элемент справочника", справочник "Иконки для ВП "Мультиклассовый список связей" (linkVisualIcon). Редактируемый.
-
"Код метакласса" (metaClassCode) — используется для определения класса, для которого строится виджет.
Тип "Строка". Обязательный, редактируемый.
-
"Код атрибута связи" (relationCode) — используется для определения класса, с объектами которого устанавливается связь.
Тип "Строка". Обязательный, редактируемый.
Ожидаемый тип атрибутов по коду: "Обратная ссылка", "Набор ссылок на БО".
-
"Код атрибута с описанием" (textCode) — используется для отображения описания.
Тип "Строка". Редактируемый.
Ожидаемый тип атрибутов по коду: "Строка", "Текст", "Текст в формате RTF".
-
"Код атрибута с дедлайном" (dateCode) — используется для отображения дедлайна.
Тип "Строка". Редактируемый.
Ожидаемый тип атрибутов по коду: "Счетчик времени (обратный)", "Дата и Время".
-
"Код атрибута с ответственным" (respCode) — отображается только для onHover.
Тип "Строка". Редактируемый.
Ожидаемый тип атрибутов по коду: "Ответственный".
-
"Код формы быстрого добавления объекта связи" (fastAddForm) — используется для определения формы добавления класса связанного объекта.
Тип "Строка". Редактируемый.
-
"Название кнопки фильтрации списка для связанных объектов" (buttonTitle) — используется для отображения название кнопки фильтра на панели действий виджета приложения.
-
"Доступен для связывания" (linkable) — включает/выключает возможность добавления связи с объектами данного типа и отображение иконки добавления связи с объектом
(с версии 1.1.0).
Тип "Логический". Редактируемый. По умолчанию "да".
Форма добавления
Выше перечисленные атрибуты должны быть размещены на форме добавления объектов типа "Визуализация связей", в указанном порядке.
Размещение списка правил конфигурации
Список правил необходимо разместить на карточке объекта в удобном месте на усмотрение технолога и добавить возможность создания правил.
Справочник
Справочник "Иконки для ВП "Мультиклассовый список связей" (linkVisualIcon) содержит папки и используется для хранения иконок, которые будут отображаться в списке объектов.
После загрузки метаинформации содержится базовый набор иконок, их можно заменить и добавить свои.
Классы объектов, с которыми устанавливается связь
Быстрая форма добавления
Для добавления объектов через приложение у классов объектов, с объектами которых предоставляется возможность устанавливать связь, должны быть быстрые формы добавления.
Формы добавления и группы атрибутов не содержатся в предоставляемой метаинформации.
Чтобы создать форму, в карточке класса на вкладке "Другие формы" нажмите кнопку Добавить форму, на форме добавления выберите тип формы: "Форма быстрого добавления и редактирования", название формы и код произвольные и нажмите кнопку Сохранить.
При необходимости можно создать группу атрибутов для отображения на быстрой форме добавления.
Подробное описание настроек приводится в разделах:
Для системного класса "Запрос" (serviceCall) нельзя настроить быструю форму добавления, поэтому добавление объектов этого класса через ВП "Мультиклассовый список связей" невозможно.
Сложная форма добавления связи
Для добавления связи между объектами через приложение используется сложная форма добавления связи.
Для наполнения формы по умолчанию используется группа атрибутов "[Форма добавления связи] Информация о связываемом объекте с кодом" (relationsExtendedEditFormList) класса объектов, с объектами которых предоставляется возможность устанавливать связь в виджете приложения. Если такой группы в классе нет, то используется группа атрибутов "Системные атрибуты" (system). Группу атрибутов можно создать и наполнить самостоятельно на вкладке "Группы атрибутов".
Подробное описание работы с группами атрибутов приведено в разделе Группы атрибутов.
Права и метки
Права
Чтобы у пользователя отображались связанные объекты, ему необходимо выдать профиль прав с правами на просмотр атрибута связи.
Чтобы у пользователя была возможность добавлять объекты и добавлять связи между объектами, ему необходимо выдать профиль прав со следующими правами:
- Добавление объекта (только для добавления);
- Редактирование и просмотр атрибута связи (добавление и связывание).
Метки
Если класс объектов отмечен меткой и она выключена, то:
- кнопка фильтр не отображается;
- класс объектов не отображается в списке выбора;
- объекты данного класса не отображается в списке виджета.