Руководство по установке#

Модуль обеспечивает возможность передачи информационной модели ОКС в ГИСОГД региона через Геопортал сведений ГИСОГД.

Примечание

Модуль устанавливается совместно с Геопорталом сведений ГИСОГД (Agate) и Geometa. Обновление Geometa нужно для того, чтобы появился компонент БД Common.ImoksToGisogd.1.1.sql.

Установка#

  1. Подключите в проект метаданные подсистемы …\Подсистемы\Передача ИМ ОКС в ГИСОГД.

  2. Обновите метаданные на всех схемах проекта.

  3. Создайте нового клиента в Jasper:

Важно

Не рекомендуется использовать модуль под клиентом «geometa», необходимо добавить нового клиента для Передачи ИМ ОКС в ГИСОГД, например «imoks2gisogd».

Укажите тип авторизации: «Как внешняя система».

Идентификатор и секрет данного клиента необходимо указать в переменных gvIMOKS2GISOGD_JASPER_CLIENT_ID и gvIMOKS2GISOGD_JASPER_CLIENT_SECRET при установке модуля по передаче ИМ ОКС в ГИСОГД.

Задайте клиенту в Jasper права на просмотр следующих типов на всех проектах:

ReqPlaceIMOKSInGisogd
TransferredOKS
GisogdInfoModelOKS
GisogdRefStateDoc
GisogdRefSections
GisigdRefDocClass
DocRefStateDoc
GknParcel
GknRefObjStatus
WfZuDraft
WfRefStateZuDraft
UrbanParselPPM
UrbanStatus
WfEnk
WfRefViewENK
WfEnkObject
WfPurposeObject
WfLinearObject
WfResidentalObjects
WfProjectHB
WfNonresidentalObjects
WfIndustrialObjects
SubjPerson
SubjRefStatus
SubjOrganization
File
SubjRefSubjectType
../../../_images/imoks_gisogd.png

  1. Убедитесь в наличии модуля Imoks2Gisogd c SignatureImoks2Gisogd. Модуль уже присутствует, если вы получили пакет с дистрибутивами для проекта.

  2. Укажите следующие переменные в файле vars.yml.

Важно

Файл vars_default.yml редактировать не нужно.

Чтобы изменить значение переменной из vars_default.yml, добавьте (продублируйте) переменную в vars.yml и укажите нужное значение – при установке оно будет перезаписано.

Название переменной

Значение по умолчанию

Описание переменной

vars.yml:

gvIMOKS2GISOGD_API_URL

{{ gvIMOKS2GISOGD_PUBLIC_ORIGIN }}/api

URL-адрес серверной части ИМ ОКС

gvIMOKS2GISOGD_CLIENT_URL

{{ gvIMOKS2GISOGD_PUBLIC_ORIGIN }}

URL-адрес клиентской части ИМ ОКС

gvIMOKS2GISOGD_ENABLED

"false"

Отвечает за отображение кнопки «Передача ИМ ОКС» в шапке главной страницы Портала ГИСОГД. Допустимые значения: true – кнопка отображается; false – кнопка не отображается. Значение нужно указывать в кавычках

gvIMOKS2GISOGD_PUBLIC_ORIGIN

https://imoks2gisogd-{{ gvNGINX_FQDN }}

URL-адрес, по которому доступен Веб-интерфейс

gvIMOKS2GISOGD_INSTALL_DIR

"/opt/Imoks2Gisogd"

Директория, в которую будет установлен Imoks2Gisogd

gvIMOKS2GISOGD_JASPER_CLIENT_ID

"imoks2gisogd"

Клиент ID Jasper

gvIMOKS2GISOGD_JASPER_CLIENT_SECRET

"imoks2gisogd"

Секрет клиента Jasper

gvIMOKS2GISOGD_MINIO_USER_LOGIN

"minio123"

Логин пользователя файлового хранилища (Minio)

gvIMOKS2GISOGD_MINIO_USER_PASS

"minio123"

Пароль пользователя файлового хранилища (Minio)

gvIMOKS2GISOGD_ESIA_CLIENT_ID

"GEOMETA"

Клиент ID для авторизации через ЕСИА

gvIMOKS2GISOGD_ESIA_CERT_PATH

"/home/user/gems.pfx"

Путь до pfx сертификата

vars_default.yml:

gvIMOKS2GISOGD_BACK_EXTERNAL_PORT

5551

Внешний порт, по которому доступен контейнер с backend частью приложения

gvIMOKS2GISOGD_FRONT_EXTERNAL_PORT

5550

Внешний порт, по которому доступен контейнер с frontend частью приложения

gvIMOKS2GISOGD_MINIO_EXTERNAL_PORT

9551

Порт, по которому доступен WebUI (Minio)

gvIMOKS2GISOGD_MINIO_CONSOLE_EXTERNAL_PORT

9550

Порт, по которому доступен API (Minio)

gvIMOKS2GISOGD_CONNECTION_STRING

Server={{ gvPOSTGRESQL_SERVER }};Port={{ gvPOSTGRESQL_PORT }};Database={{ gvPOSTGRESQL_IAS_DB_NAME }};User Id={{ gvPOSTGRESQL_IAS_USER }};Password={{ gvPOSTGRESQL_IAS_USER_PASS }}; Connection Idle Lifetime=5;Connection Pruning Interval=3; Maximum Pool Size=500;

Строка подключения к БД для сервиса Imoks2Gisogd. По умолчанию используются параметры из секции установки postgres

gvIMOKS2GISOGD_ENVIRONMENT

"Production"

Допустимые значения: Production – используется по умолчанию в продуктивной среде; Development – используется для тестирования, позволяет подключиться к тестовому порталу ЕСИА. Значение нужно указывать в кавычках

gvIMOKS2GISOGD_ESIA_URL

https://esia.gosuslugi.ru/

URL-адрес ЕСИА

gvIMOKS2GISOGD_ESIA_AUTHORIZATION_ENDPOINT

https://esia.gosuslugi.ru/aas/oauth2/ac

URL-адрес, используемый для авторизации

gvIMOKS2GISOGD_ESIA_TOKEN_ENDPOINT

https://esia.gosuslugi.ru/aas/oauth2/te

URL-адрес, используемый для получения токена авторизации

gvIMOKS2GISOGD_ESIA_USER_INFO_ENDPOINT

https://esia.gosuslugi.ru/rs/prns/

URL-адрес, используемый для получения информации о пользователе при авторизации

  1. Обновите Agate, Geometa и Imoks2Gisogd с помощью тегов install_ias, install_agate, install_imoks2gisogd.

  2. Скачайте XSD ReqPlaceIMOKSInGisogd.xsd из директории установки Imoks2Gisogd /opt/Imoks2Gisogd и добавьте её для клиента Jasper, созданного при выполнении пункта 3 установки.

  3. Установите компонент БД Common.ImoksToGisogd.1.1.sql. Компонент добавит права на просмотр ReqPlaceIMOKSInGisogd (Запрос на размещение ИМ ОКС в ГИСОГД) и TransferredOKS (Переданный объект капитального строительства) во все роли, в которых есть права на просмотр и/или редактирование объекта GisogdInfoModelOKS (Информационная модель ОКС):

docker exec -it geometa_cli dotnet ./gems.cli.dll db-migrate-standalone -c 'Server=host;Port=port;Database=db_name;User Id=user;Password=password' -o 'Common.Imoks2Gisogd'

  1. При необходимости вручную выведите реестр Запрос на размещение ИМ ОКС в ГИСОГД (ReqPlaceIMOKSInGisogd) в нужный каталог через конфигуратор Системы для просмотра списка полученных запросов.

Конфигурирование#

Примечание

Список проектов, отображаемых в форме передачи ИМ ОКС в поле [Муниципальное образование], берётся из тех проектов, которые опубликованы на Портале ГИСОГД (Agate).

При разворачивании модуля по умолчанию запущен сервис по очистке успешно завершённых процессов передачи ИМ ОКС в ГИСОГД.

Очистка происходит в БД в таблице imoks2gisogd.workflows для записей, у которых заполнено поле [date_complete].

В логах контейнера (команда docker-compose logs -f) будут информационные сообщения вида:

[Gems.Imoks2Gisogd.BackgroundJobs.ProcessOutboxMessagesJob] Cleaning: 0 workflows has been removed.

Чтобы записи таблицы workflows не очищались, перейдите в директорию установки модуля /opt/Imoks2Gisogd и добавьте в .env:

BackgroundJobsOptions__CleanUpWorkflows__EnableJob=false

Сохраните изменения и перезапустите контейнер:

docker-compose down
docker-compose up -d