Установка модуля интеграции с Системой#

Для чего нужен модуль#

Модуль Gems.Module.Diamond.Integration обеспечивает интеграцию приложения ГИСОГД с Системой. Интеграция необходима для:

Получения информации о пространственных объектах, в том числе данных адресного плана, необходимых при регистрации сведений, документов, материалов: земельные участки, ОКС, ЗОУИТ и других
Получения геометрии контура территории действия размещаемых сведений, документов, материалов по ОКТМО или кадастровому номеру ЗУ, которые хранятся в Системе
Обеспечения переноса зарегистрированных сведений, документов, материалов из ГИСОГД в Систему
Подписания и последующей передачи на размещение в ГИСОГД документов, созданных в Системе.

Что необходимо для работы модуля

Модуль интеграции требует переустановки Системы. Поэтому необходимо поднять версию NetCore до 3.1 на тех проектах, где это еще не сделано
Для работы модуля требуется RabbitMQ – брокер сообщений, по которому происходит обмен данными между ГИСОГД и Системой. RabbitMQ устанавливается из контейнера Docker, вместе с приложением ГИСОГД и занимает порт 5673

Установка модуля#

Для установки модуля Gems.Module.Diamond.Integration добавьте в команду установки Системы параметры:

добавление модуля интеграции в сборку:
```
-extraModule=Gems.Module.Diamond.Integration
```

DNS-имя или IP RabbitMQ:

-appServerEnvVar="Modules__DiamondIntegration__RabbitMQ__Host=localhost"

порт RabbitMQ:

-appServerEnvVar="Modules__DiamondIntegration__RabbitMQ__Port=5673"

имя учётной записи RabbitMQ:

-appServerEnvVar="Modules__DiamondIntegration__RabbitMQ__Login=gems"

пароль учётной записи RabbitMQ:

-appServerEnvVar="Modules__DiamondIntegration__RabbitMQ__Password=gemsAdmin123$"

Указанные выше параметры подключения к RabbitMQ должны совпадать с таковыми для ГИСОГД, так как для корректного обмена сообщениями оба приложения должны смотреть на один и тот же экземпляр RabbitMQ

Важно

Обновление или перезапуск ГИСОГД создаёт очереди RabbitMQ заново, поэтому после них требуется перезапуск Системы для подключения к новым очередям

Конфигурирование модуля#

Настройка модуля Gems.Module.Diamond.Integration происходит с помощью файлов конфигурации:

modulesettings.json – файл конфигурации с перечнем проектов. Располагается в корневой папке сервера приложения в папке Modules/Gems.Module.Diamond.Integration.
DocumentTypes.json – файл конфигурации с перечнем типов документов, для которых кнопка ИСОГД будет заменена на Отправить в ГИСОГД. Располагается по пути Configuration/GisogdDocumentRegistration.

Функция подписания документов#

По умолчанию функция подписания документов, созданных в Системе, включена для всех проектов.

Отключение функционала возможно после получения от заказчика письменного запроса.

Отключение кнопки ИСОГД#

Чтобы скрыть кнопку ИСОГД в карточках документов Системы, необходимо в файле конфигурации модуля modulesettings.json внутри секции «ProjectAliases» изменить значение параметра «Value». Параметр «Value» содержит перечень проектов, для документов которых будет скрыта кнопка ИСОГД и может быть добавлена кнопка Отправить в ГИСОГД.

В параметре Value указываются alias-ы проектов через запятую «project1», «project2» и т.д. Для указания всех проектов нужно ввести «*», если кнопка должна остаться для всех проектов, то [ ]

"ProjectAliases": {
    "Value": ["*"]
     }

Добавление кнопки Отправить в ГИСОГД#

Для отображения кнопки Отправить в ГИСОГД в карточках документов Системы, подлежащих размещению в ГИСОГД, задайте настройки в файлах:

modulesettings.json (Описание см. выше в блоке «Отключение кнопки ИСОГД».)
DocumentTypes.json