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

Модуль обеспечивает возможность перенаправления заявлений, полученных с ЕПГУ, в другое муниципальное образование, в случае направления заявителем заявления в ведомство, не уполномоченное на предоставление данной услуги.

Установка на все проекты#

Примечание

Модуль устанавливается совместно с Amber и Geometa.

Подключите в проект метаданные подсистем:
- …Подсистемы\ЕФТТ. Маршрутизация заявлений между МО;
- …Подсистемы\ЕФТТ. Маршрутизация заявлений между МО\ЕФТТ. Маршрутизация уведомлений о сносе между МО.
Обновите метаданные на всех схемах проекта.
Убедитесь в наличии модуля Module.Amber.ApplicationsRedirection. Модуль уже присутствует, если вы получили пакет с дистрибутивами для проекта.
Установите компонент БД на сервере:

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.Amber.ApplicationRedirect'

Компонент автоматически создаст новые справочные значения для заявлений, уведомлений, услуг, перенаправлений:

DocRefStateApplication – справочное значение для статусов заявлений:

«Перенаправлено» (redirected);

WfRefProcessingStage – справочное значение для статусов услуг:

«Перенаправлена» (redirected);

DocRefStateRedirect – справочные значения для статусов перенаправлений:

«Перенаправляется» (redirect);

«Перенаправлено» (redirected);

«Ошибка перенаправления» (error);

«Получено» (got).

Также компонент установит права на чтение объектов типа Перенаправление (RedirectApplication) и Состояние перенаправления (DocRefStateRedirect) всем пользователям, у которых есть права на редактирование заявлений (DocApplication).

Добавьте в таблицу БД amber.global_settings новые поля с наименованиями департаментов для маршрутизации с помощью утилиты:

5.1. Скопируйте в директорию /opt/Amber/DepartmentDictionaryFiles csv-файл сопоставления кодов департаментов и их наименований;

5.2. Запустите утилиту из директории /opt/Amber/:

docker-compose --profile config-filler up -d

С помощью утилиты будет дополнен конфигурационный файл, который хранится в таблице amber.global_settings в БД проекта. Утилита добавляет ведомствам полное наименование SmevDepartmentFullName и краткое SmevDepartmentShortName, получая их из csv-файла через сопоставление ведомства из таблицы amber.global_settings по SmevDepartmentCode и ведомства из csv-файла по CODE, взятого с ЕСНСИ.

Полное наименование SmevDepartmentFullName заполняется на основе значения столбца TITLE, а краткое SmevDepartmentShortName – на основе столбца SHORT_TITLE из csv-файла со списком департаментов.

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

Важно

Файл vars_default.yml редактировать не нужно. Он содержит дефолтные значения переменных.
Чтобы изменить значение переменной из vars_default.yml, добавьте (продублируйте) переменную в vars.yml и укажите нужное значение – при установке оно будет перезаписано.
При отсутствии настроек для Module.AmberSatellite, то есть когда переменные gvAMBER_SATELLITE_RABBITMQ и др. не заполняются значениями, – нельзя указывать в vars.yml переменную gvAMBER_ENABLE_SATELLITE_MESSAGING со значением true. Это может привести к ошибкам в модуле Amber. Данная переменная в значении true подразумевает, что должны быть указаны настройки для Satellite, то есть строка подключения к БД, реббиту стенда, на котором он развернут и т.д.

Название переменной	Значение по умолчанию	Описание переменной
vars_default.yml:
gvAMBER_ENABLE_SATELLITE_MESSAGING	"false"	Переменная, отвечающая за взаимодействие Amber с модулем Satellite. Допустимые значения: `true` – включено взаимодействия с Satellite (должны быть указаны настройки Satellite при установке Amber: строка подключения к БД, рэббиту, ФХ, имя Satellite в vars.yml); `false` – отключено взаимодействия с Satellite (когда установлен только Amber и не указаны никакие настройки для Satellite)
gvAMBER_APPLICATIONS_REDIRECT_ENABLE	"false"	Параметр, отвечающий за работу модуля маршрутизации и отображение кнопки «Перенаправить заявление» в карточке. Допустимые значения: `true` – кнопка «Перенаправить заявление» отображается в карточке Заявления/Уведомления; `false` – кнопка не отображается. Значение нужно указывать в кавычках
gvAMBER_DICTIONARY_FILES	[]	Имя csv-файла с наименованиями ведомств для работы утилиты сопоставления кодов департаментов и их наименований. Файл необходимо добавлять в директорию установки Amber /opt/Amber/DepartmentDictionaryFiles. Например, ["departments.csv"]

Обновите основное приложение Geometa и Amber с помощью тегов install_ias, install_amber.

Установка отдельно для региона и МО#

Если и регион, и муниципальные образования, входящие в его состав, используют отдельные Системы и интеграция с ЕПГУ с использованием ЕФТТ выполняется отдельно для каждого из них, то модуль маршрутизации Module.Amber.ApplicationsRedirection устанавливается только для региона.

Для муниципального образования устанавливается Module.AmberSatellite и Module.ServiceResultBehavior.

Примечание

Для взаимодействия необходимо обеспечить доступ с региональной Системы в Систему МО до следующих серверов:

сервер c Geometa по порту 5672;

сервер БД по порту 5432;

сервер файлового хранилища по порту 5555.

Сначала выполняется установка модуля в Системе муниципального образования, а затем установка модуля в Системе региона.

Установка маршрутизации для МО#

Убедитесь, что установлены и настроены модули Module.AmberSatellite, Module.ServiceResultBehavior.
Подключите в проект метаданные подсистем:
- Подсистемы\ЕФТТ. Маршрутизация заявлений между МО;
- Подсистемы\ЕФТТ. Маршрутизация заявлений между МО\ЕФТТ. Маршрутизация уведомлений о сносе между МО.
Обновите метаданные на всех схемах проекта.
Установите компонент БД Common.Amber.ApplicationRedirect на сервере:

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.Amber.ApplicationRedirect'

DocRefStateApplication – справочное значение для статусов заявлений:

«Перенаправлено» (redirected);

WfRefProcessingStage – справочное значение для статусов услуг:

«Перенаправлена» (redirected);

DocRefStateRedirect – справочные значения для статусов перенаправлений:

«Перенаправляется» (redirect);

«Перенаправлено» (redirected);

«Ошибка перенаправления» (error);

«Получено» (got).

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

Важно

Файл vars_default.yml редактировать не нужно. Он содержит дефолтные значения переменных.

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

Название переменной	Значение по умолчанию	Описание переменной
vars_default.yml:
gvAMBER_ENABLE_SATELLITE_MESSAGING	"false"	Переменная, отвечающая за взаимодействие Amber с модулем Satellite. Допустимые значения: `true` – включено взаимодействия с Satellite (должны быть указаны настройки Satellite при установке Amber: строка подключения к БД, рэббиту, ФХ, имя Satellite в vars.yml); `false` – отключено взаимодействия с Satellite (когда установлен только Amber и не указаны никакие настройки для Satellite)
gvAMBER_APPLICATIONS_REDIRECT_ENABLE	"false"	Параметр, отвечающий за работу модуля маршрутизации и отображение кнопки «Перенаправить заявление» в карточке. Допустимые значения: `true` – кнопка «Перенаправить заявление» отображается в карточке Заявления/Уведомления; `false` – кнопка не отображается. Значение нужно указывать в кавычках
gvAMBER_DICTIONARY_FILES	[]	Имя csv-файла с наименованиями ведомств для работы утилиты сопоставления кодов департаментов и их наименований. Файл необходимо добавлять в директорию установки Amber /opt/Amber/DepartmentDictionaryFiles. Например, ["departments.csv"]

Обновите основное приложение Geometa с помощью тега install_ias.

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

Установка модуля отдельно на регион осуществляется так же, как и на все проекты. Смотрите выше раздел «Установка на все проекты».