Настройка сервиса «Связи»¶
Примечание – Прежде, чем настраивать модель данных для связей необходимо создать конфигурации (Source и Target (источник и приемник)), в которых будет указано какие классы будут использоваться в качестве объектов-источников и объектов-приемников связи (завести ключи конфигурации для сервиса «Связи»).
1. В разделе «Конфигурации» нажать кнопку
– откроется форма создания новой конфигурации.
2. Заполнить поля:
-
«Системный код приложения» (в данном случае для связей – «Сервис связей (dh-relations-service)»);
-
«Ключ» – путь в YAML-файле, куда записать эту конфигурацию для использования – «docshouse.application.relations.allowedSourceObjectClasses.documents» (Настройки сервиса «Связи»).
Значения в полях «Значение», «Профиль» и «Метка» оставить по умолчанию.
Примечание – Для того, чтобы задать ограничения на классы документов и папок, которые будут образовывать связи (иными словами, связывать только конкретные классы документов и папок), необходимо заполнить поле «Значение» наименованиями необходимых классов документов и папок. Если оставить это поле пустым, то документы всех классов будут иметь возможность быть связанными с папками любого из класса папок.
3. Нажать кнопку
– конфигурация класса объекта-источника связи будет сохранена.
4. В разделе «Конфигурации» нажать кнопку
– откроется форма создания новой конфигурации.
5. Заполнить поля:
-
«Системный код приложения» (в данном случае для связей – «Сервис связей (dh-relations-service)»);
-
«Ключ» – путь в YAML-файле, куда записать эту конфигурацию для использования – «docshouse.application.relations.allowedTargetObjectClasses.folders» (Настройки сервиса «Связи»).
Значения в полях «Значение», «Профиль» и «Метка» оставить по умолчанию.
6. Нажать кнопку
– конфигурация класса объекта-приемника связи будет сохранена.
7. Зайти в раздел «LowCode» – «Модели данных» – «Связи» и нажать кнопку
. Откроется форма создания нового класса связи (рисунок ниже).
8. Заполнить поля:
-
«Наименование»;
-
«Код класса»;
-
«Описание».
9. В блоке «Выбор класса объекта-источника связи» перевести переключатель «Документы» в положение «Включено», нажать на фразу «Без ограничений» – откроется окно «Документы: выбрать классы объекта-источника связи» (рисунок ниже).
10. Выбрать ранее созданный класс документа, а в графе «Тип связи» для него выбрать значение «Динамическая» и нажать кнопку «Сохранить» (рисунок ниже).
11. В блоке «Выбор класса объекта-приемника связи» перевести переключатель «Папки» в положение «Включено».
12. Нажать кнопку «Сохранить».
13. В разделе «Конфигурации» нажать кнопку
– откроется форма создания новой конфигурации.
14. Заполнить поля:
-
«Системный код приложения» (в данном случае для связей – «Сервис связей (dh-relations-service)»);
-
«Ключ» – путь в YAML-файле, куда записать эту конфигурацию для использования – «docshouse.datamodel.starter.classes» (Создание класса объекта «Связь»);
-
«Значение» – наименование класса «relation».
Значения в полях «Профиль» и «Метка» оставить по умолчанию.
15. Нажать кнопку
– конфигурация для созданного класса связей будет сохранена.
16. Перейти в раздел «Управление документами» – «Документы», открыть карточку документа, который необходимо связать с папкой.
17. В открытой карточке документа перейти в раздел «Связи» и нажать кнопку
– откроется окно «Новая связь документа», содержащее четыре шага.
18. На первом шаге убедиться, что в открывшемся окне тип связи проставился автоматически («relation»), и заполнить поле «Наименование связи», после чего нажать кнопку «Продолжить».
19. На втором шаге убедиться, что для текущего документа установлено значение «источником» и нажать кнопку «Продолжить».
20. На третьем шаге в поле «Вид связи» выбрать значение «Динамическая» и нажать кнопку «Продолжить».
21. На четвертом шаге в поле «Тип» выбрать значение «Папка» (поле «Сервис» при этом заполнится автоматически), в поле «Класс» нажать кнопку меню
и в открывшемся окне выбрать класс папки «folder» и нажать кнопку «Выбрать», в поле «Папка» нажать кнопку меню
и в открывшемся окне выбрать ранее созданный экземпляр папки, с которой планируется связать документ, и нажать кнопку «Выбрать».
22. В окне «Новая связь документа» нажать кнопку «Создать» – связь документа с папкой будет создана.
23. Перейти в раздел «Управление документами» – «Связи», убедиться, что созданная связь отображается в таблице.












