Руководство по установке#
Перед установкой модуля для обмена информацией с ЕПГУ требуется подключение к формам - концентраторам.
Подключение выполняется в порядке, указанном в руководстве.
1. Подключиться к СМЭВ
Если на проекте подключение к СМЭВ 3 не выполнялось, то нужно это сделать (См. Подключение к СМЭВ)
2. Получить доступ в продуктивной среде в качестве потребителя к ВС «Универсальный вид сведений для приема событий электронного заявления на портале государственных услуг (функций)»
Для этого выполните следующее:
если проверка СМЭВ в тестовом контуре уже выполнялась, то переходите к следующему шагу. Если нет, то выполните подготовку окружения
распакуйте архив SmevMezhvedTestContour.zip в каталог /home /GEMS/SmevMezhvedTestContour
в файле appsettings.json в теге Enabled установите значение
true
для вида сведенийEventService
. Если проверку в тестовом контуре нужно выполнить для одного ВС, тоtrue
нужно установить только для него
запустите SmevTestContourTestingApp:
dotnet Gems.Smev.TestContourCheckingApplication.dll
проверьте результаты тестирования
Пример результата тестирования для «Универсального вида сведений для приема событий электронного заявления на портале государственных услуг (функций)»:
Скачать примеры
после получения ответов на тестовый запрос нужно оформить заявку на получение доступа и передать ее заказчику для передачи в СМЭВ 3. К заявке необходимо приложить архив с полученными результатами тестирования.
Пример заявки: Скачать
В заявке желтым цветом выделена информация, которую заполняет разработчик, зеленым - заказчик.
Раздел заявки |
Как заполнить |
---|---|
Полное или краткое наименование Участника |
Присваивается при получении доступа СМЭВ 3 (при отсутствии информации пункт заполняет заказчик) |
Мнемоника Участника в Продуктивной среде |
Присваивается при получении доступа СМЭВ 3 (при отсутствии информации пункт заполняет заказчик) |
Полное или краткое наименование ИС |
Присваивается при получении доступа СМЭВ 3 (при отсутствии информации пункт заполняет заказчик) |
Мнемоника ИС в Продуктивной среде |
Присваивается при получении доступа СМЭВ 3 (при отсутствии информации пункт заполняет заказчик) |
Информация о предварительном тестировании в Тестовой среде |
|
Дата/время прохождения тестирования |
Заполняется после прохождения тестирования значением тэга DeliveryTimestamp из файла Request0\ response__answer.xml [1] |
MessageID запроса |
Заполняется после прохождения тестирования значением тэга MessageID из файла Request0\ Request0.xml [2] |
3. Оформить заявку на получение доступа и передать ее заказчику для передачи в СМЭВ 3.
Раздел заявки |
Как заполнить |
---|---|
Полное или краткое наименование Участника |
Присваивается при получении доступа СМЭВ 3 (при отсутствии информации пункт заполняет заказчик) |
Мнемоника Участника в Продуктивной среде |
Присваивается при получении доступа СМЭВ 3 (при отсутствии информации пункт заполняет заказчик) |
Полное или краткое наименование ИС |
Присваивается при получении доступа СМЭВ 3 (при отсутствии информации пункт заполняет заказчик) |
Мнемоника ИС в Продуктивной среде |
Присваивается при получении доступа СМЭВ 3 (при отсутствии информации пункт заполняет заказчик) |
Код маршрутизации |
ОКТМО Субъекта РФ |
Примеры заявок: Скачать
В заявках желтым цветом выделена информация, которую заполняет разработчик, зеленым - заказчик.
Важно
Для прохождения следующих этапов необходимо запросить у заказчика номера заявок по каждой услуге в формате INC0000000000000
4. Тестирование в тестовой среде для получения доступа к видам сведений в качестве поставщика по каждой услуге в продуктивной среде
Подсказка
Данный процесс необходимо будет пройти по каждой услуге по мере появления информации от заказчика
В ответ на отправленные заявки на получение доступа к формам ЕПГУ по каждой услуге в тестовой среде заказчику придет ответ вида:
В целях прохождения тестирования ВС "Прием заявлений с ЕПГУ по форме «<Наименование услуги>»" версии 1.0.1 в качестве Поставщика в тестовой среде СМЭВ 3.0 службой эксплуатации СМЭВ был направлен запрос: a324b918-f12c-11eb-a91a-c0b88376c776 c кодом маршрутизации …в адрес ИС "ГИСОГД …" с мнемоникой …. Запрос успешно помещен в очередь получателя. Необходимо получить запрос из очереди ИС (метод GetRequestRequest), подтвердить получение с указанием message_id полученного сообщения (метод Ack), сформировать ответ и направить с помощью метода SendResponseRequest. После чего необходимо проинформировать СЭ СМЭВ о прохождении цепочки взаимодействия и предоставить id ответа, сформированный методом SendResponseRequest или xml файл ответа. После выполнения вышеуказанной процедуры предоставить XML файлы: - GetRequestResponse; - GetRequestRequest; - Ack; - SendResponseRequest; - SendResponseResponse. При отсутствии ответа обращение будет закрыто через три календарных дня.
После получения данного ответа в течение 3 дней необходимо:
На сервер где проводилось тестирование из п. 2 положить утилиту <Номер сборки>\Дистрибутивы\Products\SmevProducerEmulator (не ниже 5.6)
В файле appsettings.json указать номер сертификата и пароль
Перейти в папку с утилитой и запустить ее командой:
dotnet Gems.Smev.ProducerEmulator.dll
По окончании работы утилиты перейти в каталог \ProducerEmulator\EnvelopeFiles\<дата запуска утилиты>. В нем появится каталог с наименованием, соответствующим номеру, указанному в заявке - службой эксплуатации СМЭВ был направлен запрос: a324b918-f12c-11eb-a91a-c0b88376c776.
- Проверить, что в каталоге присутствуют 6 файлов:
- - AckRequest.xml- AckResponse.xml- GetRequestRequest.xml- GetRequestResponse.xml- SendResponseRequest.xml- SendResponseResponse.xml
Содержимое каталога упаковать в архив и передать заказчику вместе с содержимым тега MessageID из файла SendResponseRequest.xml
Важно
Не удаляйте утилиту и полученные результаты с сервера. Часто информация от заказчиков поступает позднее, чем СМЭВ направляет запросы для прохождения тестирования. Утилита в процессе работы получает все запросы и повторно их получить не будет возможности
5. Тестирование в продуктивной среде для получения доступа к видам сведений в качестве поставщика по каждой услуге в продуктивной среде
После прохождения предыдущего пункта от СМЭВ придет ответ вида:
Тестирование в тестовой среде СМЭВ 3.0 пройдено успешно. Просьба пройти тестирование в продуктивной среде СМЭВ 3.0.
В целях прохождения тестирования ВС "Прием заявлений с ЕПГУ по форме «<наименование услуги>»" версии 1.0.1
в качестве Поставщика в продуктивной среде СМЭВ 3.0 службой эксплуатации СМЭВ был направлен запрос:
1) 4687b813-f5b4-11eb-9761-c0b88376c776
c кодом маршрутизации 04000000 в адрес ИС "…" с мнемоникой ….
Запрос успешно помещен в очередь получателя.
Необходимо получить запрос из очереди ИС (метод GetRequestRequest), подтвердить получение с указанием message_id полученного сообщения (метод Ack), сформировать ответ и направить с помощью метода SendResponseRequest. После чего необходимо проинформировать СЭ СМЭВ о прохождении цепочки взаимодействия и предоставить id ответа, сформированного методом SendResponseRequest или xml файл ответа.
После выполнения вышеуказанной процедуры предоставить XML файлы:
- GetRequestResponse
- GetRequestRequest
- Ack
- SendResponseRequest
- SendResponseResponse
После получения ответа в течение 3 дней необходимо выполнить действия из п. 5 на боевом сервере.
Важно
Перед запуском утилиты SmevProducerEmulator из п. 6 в файле appsettings.json заменить адрес СМЭВ на "SmevUri": "http://172.20.3.12:7500/smev/v1.2/ws?wsdl",
Обратите внимание
Если не удалось поймать запрос СМЭВ через утилиту ProducerEmulator, запрос был пойман Аmber и ушел в БД.
Установите программу LiteDB Explorer /
Выполните в БД запрос:
select * from amber.http_exchange where "ResponseBody" like '%21e260e0-8f37-11ec-99aa-c8d9d293d75d%'Где
21e260e0-8f37-11ec-99aa-c8d9d293d75d
- номер запроса СМЭВ.
Сохраните значение поля [RegisteredApplicationKey], например 49/
Выполните в БД запрос:
select * from amber.http_exchange where "RegisteredApplicationKey" = 49
Запрос выдаст несколько строк. Значения первых двух самых ранних по времени строк и их значения в полях [ResponseBody] и [RequestBody] сохраните в файлы с соответствующими наименованиями (AckRequest.xml, AckResponse.xml, GetRequestRequest.xml, GetRequestResponse.xml)
Каждое значение полей [ResponseBody] и [RequestBody] в начале xml-описания содержит теги <ns1:AckRequest, <ns1:GetRequestRequest, <ns2:AckResponse, <ns2:GetRequestResponse, которые соответствуют наименованиям файлов, в которые необходимо сохранить значения полей.
Например, xml из данного поля необходимо сохранить в файл AckRequest.xml
На сервере в папке …/ProducerEmulator/EnvelopeFiles/ создайте папку с текущей датой, например 2022-02-18.
В папке 2022-02-18 создайте папку с номером запроса, например 21e260e0-8f37-11ec-99aa-c8d9d293d75d
В папке …/ProducerEmulator/EnvelopeFiles/2022-02-18/21e260e0-8f37-11ec-99aa-c8d9d293d75d разместите подготовленные xml файлы (AckRequest.xml, AckResponse.xml, GetRequestRequest.xml, GetRequestResponse.xml).
Из папки …/ProducerEmulator/ скопируйте на компьютер файл TestRequestsCurator.db.
Запустите программу, установленную на шаге 1 с правами администратора.
В программе выберите пункт File-Открыть-выбрать файл TestRequestsCurator.db.
Отредактировать любой из старых запросов, у которых в колонке IsProcessed стоит true, следующим образом:
Заранее откройте в текстовом редакторе файл GetRequestResponse.xml:
13.1. Выберите запрос.
13.2. Нажмите кнопку «Edit».
13.3. В поле [MessageId] укажите номер запроса 21e260e0-8f37-11ec-99aa-c8d9d293d75d.
13.4. В полях [ReceiveDate] и [ResponseDate] укажите текущую дату, например 2022-02-18.
13.5. Убрерите галочку IsProcessed.
13.6. В поле [LastSuccessStep] впишите AckSent.
13.7. В поле [ReplyTo] укажите значение тега <ns2:ReplyTo> из файла GetRequestResponse.xml, например:
13.8. В поле [MessagePrimaryContent] укажите значение тега <tns:request вместе с тегом, например:
13.9. В поле [RelativePath] укажите значение тега <ns2:MessageID>, например:
13.10. Нажмите кнопку «ОК». Файл TestRequestsCurator.db автоматически сохранится.
Замените файл TestRequestsCurator.db в папке …/ProducerEmulator/ на новый.
Запустите утилиту ProducerEmulator.
В папке …/ProducerEmulator/EnvelopeFiles/2022-02-18/21e260e0-8f37-11ec-99aa-c8d9d293d75d появятся еще два файла (SendResponseRequest.xml, SendResponseResponse.xml).
Передайте заказчику папку …/ProducerEmulator/EnvelopeFiles/2022-02-18/21e260e0-8f37-11ec-99aa-c8d9d293d75d с шестью файлами(AckRequest.xml, AckResponse.xml, GetRequestRequest.xml, GetRequestResponse.xml, SendResponseRequest.xml, SendResponseResponse.xml).
6. Регистрация в тестовой среде ЕПГУ
После получения доступа в тестовой среде по заявкам из п.3 необходимо оформить заявку на регистрацию в тестовой среде ЕПГУ и передать ее заказчику для передачи в СМЭВ 3
Примеры заявок: Скачать
В заявках желтым цветом выделена информация, которую заполняет разработчик, зеленым - заказчик.
Раздел заявки |
Как заполнить |
---|---|
Код маршрутизации |
ОКТМО Субъекта РФ |
Наименование региона |
Наименование Субъекта РФ |
Номер заявки на подключение в тестовой среде СМЭВ 3.х в качестве поставщика к виду сведений «<наименование вида сведений соответствующего услуге>» |
Номер заявки направленной заказчиком на получение доступа к видам сведений из п.3 в формате INC0000000000000 |
7. Заполнить справочник «Уполномоченный орган предоставляющий услугу»
После получения доступа по п.4 необходимо проверить наличие значений в справочнике «Уполномоченный орган предоставляющий услугу»:
Зайдите в тестовую среду ЕПГУ и введите логин: 112-233-446 96, пароль: 11111111, учетная запись: И.В. Каменев.
В правом верхнем углу выберите необходимый Субъект РФ
Заполните все поля заявления.
На последнем этапе необходимо выберите Уполномоченный орган предоставляющий услугу.
В случае если в выпадающем списке отсутствуют значения обратитесь к представителям заказчика и попросите заполнить справочник Уполномоченный орган предоставляющий услугу в тестовой и продуктивной среде:
Адрес тестовой среды: http://esnsi.test.gosuslugi.ruАдрес продуктивной среды: http://esnsi.gosuslugi.ruПосле заполнения заказчиком справочника проверьте наличие нужного значения в списке Уполномоченный орган предоставляющий услугу.
8. Регистрация ВИС в продуктивной среде
Для прохождения данного пункта необходимо наличие значений справочника «Уполномоченный орган предоставляющий услугу» в тестовой среде и наличие доступа по пунктам 2 и 4.
Для регистрации ВИС в продуктивной среде необходимо:
На тестовом стенде с установленным сертификатом установить сборки Geometa и Amber
При установке модуля Интеграции с ЕПГУ (Amber), в таблице БД amber.global_settings должно быть указано
"Environment": "SVCDEV",
вместо"Environment": "PROD",
Направить по каждой услуге 2 заявления с тестовой среды ЕПГУ и сохранить себе их номера:
# Услуга
Ссылка
Выдача разрешения на ввод объекта в эксплуатацию
Примечание
Перед подачей заявления на портале необходимо выбрать свой регион, после выбора начать оформлять новое заявление (не из черновика)
Получить заявления в Geometa
По первому заявлению направить промежуточные статусы.
Для отправки промежуточных статусов в карточке услуги нужно установить статус «Заявление зарегистрировано» и сохранить карточку. Появится сообщение «В ЛК ЕПГУ будет отправлен статус «Заявление зарегистрировано». Продолжить?» – подтвердить отправку и дождаться отображения статуса на портале.Затем установить статус «Подготовка документа» и сохранить карточку. Появится сообщение «В ЛК ЕПГУ будет отправлен статус «Заявление принято к рассмотрению». Продолжить?» – подтвердить отправку и дождаться отображения соответствующего статуса на портале.По первому заявлению направить финальный статус «Услуга оказана».
Для отправки финального статуса в карточке услуги нужно установить статус «Подготовлен результат» и сохранить карточку.Перейти в карточку результата услуги (не отказ), установить у результата услуги статус «Действующий», прикрепить любой файл и сохранить.Перейти в карточку услуги, нажать кнопку Отправить и дождаться отображения результата на портале.По второму заявлению направить финальный статус «Отказано в предоставлении услуги».
Для отправки финального статуса в карточке услуги установить статус «Подготовлен отказ» и сохранить карточку.Перейти в карточку результата услуги «Решение об отказе» *(возврате), установить у результата услуги статус *«Действующий», прикрепить любой файл и сохранить.Перейти в карточку услуги, нажать кнопку Отправить и дождаться отображения результата на портале.Заполнить заявку на регистрацию ВИС и передать ее заказчику для передачи в СМЭВ 3.
Примеры заявок:
Скачать примеры
В заявках желтым цветом выделена информация, которую заполняет разработчик, зеленым - заказчик.
В теме письма необходимо указать ИС ХМАО #КУ-СМЭВ3-ПРОД
Раздел заявки |
Как заполнить |
---|---|
В теме письма необходимо указать ИС ХМАО #КУ-СМЭВ3-ПРОД |
Заменить наименование Субъекта РФ |
Код маршрутизации |
ОКТМО Субъекта РФ |
Наименование региона |
Наименование Субъекта РФ |
Номер заявки на подключение в тестовой среде СМЭВ 3.х в качестве поставщика к виду сведений <наименование вида сведений соответствующего услуге> |
Номер заявки направленной заказчиком на получение доступа к видам сведений из в формате INC0000000000000 |
Номер заявки с промежуточными результатами по заявлению + передача комментария при смене статуса на промежуточный на продуктивной среде (с помощью вида сведений Универсальный вид сведений для приема событий электронного заявления на портале государственных услуг (функций) раздел 11) |
Номер ПЕРВОГО заявления |
Номер заявки, которая была исполнена (статус заявки 3 – Услуга оказана), в тестовой среде |
Номер ПЕРВОГО заявления |
Номер заявки с отказом (статус заявки 4 – Отказ), в тестовой среде |
Номер ВТОРОГО заявления |
После положительного рассмотрения заявок проверить работу услуг в продуктивной среде ЕПГУ.
Для этого:Направьте заявления по всем услугам в продуктивной среде ЕПГУ
# Услуга
Ссылка
Выдача разрешения на ввод объекта в эксплуатацию
Если на боевом сервере заказчика не установлен Amber, то запустите на боевом сервере заказчика утилиту Дистрибутивы\Products\SmevProducerEmulator (не ниже 5.7) и убедитесь, что в каталоге ProducerEmulator\EnvelopeFiles появились все направленные заявления.
Если Amber установлен, то переустановите его с необходимым модулем и получите заявления в Geometa.
Проверьте, что на ЕПГУ заявления находятся в статусе Получено ведомством
Если не все заявления отобразились в утилите, значит они автоматически были направлены в ПГС. В таком случае заказчику необходимо рекомендовать направить заявку с описанием проблемы.
9. Активация ВИС в продуктивной среде
Для прохождения данного пункта необходимо, чтобы заказчик был готов принимать и обрабатывать заявления и имел на своем сервере Geometa и Amber версии не ниже 5.7.
Для активации ВИС в продуктивной среде необходимо:
На продуктивном стенде заказчика с установленным сертификатом разместить сборку Geometa и Amber версии не ниже 5.7
Развернуть новый проект и настроить получение заявлений на него в таблице amber.global_settings (См. Подготовка к установке)
Направить по каждой услуге 2 заявления с продуктивной среды ЕПГУ и сохранить себе их номера
Услуга |
Ссылка |
---|---|
Выдача разрешения на ввод объекта в эксплуатацию |
Примечание
Перед подачей заявления на портале необходимо выбрать свой регион, после выбора начать оформлять новое заявление (не из черновика)
Получить заявления в Geometa
По первому заявлению направить промежуточные статусы.
Для отправки промежуточных статусов в карточке услуги нужно установить статус «Заявление зарегистрировано» и сохранить карточку. Появится сообщение «В ЛК ЕПГУ будет отправлен статус «Заявление зарегистрировано». Продолжить?» – подтвердить отправку и дождаться отображения статуса на портале.Затем установить статус «Подготовка документа» и сохранить карточку. Появится сообщение «В ЛК ЕПГУ будет отправлен статус «Заявление принято к рассмотрению». Продолжить?» – подтвердить отправку и дождаться отображения соответствующего статуса на портале.По первому заявлению направить финальный статус «Услуга оказана».
Для отправки финального статуса в карточке услуги нужно установить статус «Подготовлен результат» и сохранить карточку.Перейти в карточку результата услуги (не отказ), установить у результата услуги статус «Действующий», прикрепить любой файл и сохранить.Перейти в карточку услуги, нажать кнопку Отправить и дождаться отображения результата на портале.По второму заявлению направить финальный статус «Отказано в предоставлении услуги».
Для отправки финального статуса в карточке услуги установить статус «Подготовлен отказ» и сохранить карточку.Перейти в карточку результата услуги «Решение об отказе» *(возврате), установить у результата услуги статус *«Действующий», прикрепить любой файл и сохранить.Перейти в карточку услуги, нажать кнопку Отправить и дождаться отображения результата на портале.Заполнить заявку на активацию ВИС и передать ее заказчику для передачи в СМЭВ 3.
Примеры заявок:
Скачать примеры
В заявках желтым цветом выделена информация, которую заполняет разработчик.
В теме письма необходимо указать ИС ХМАО #КУ-СМЭВ3-АКТИВАЦИЯ
Раздел заявки |
Как заполнить |
---|---|
В теме письма необходимо указать ИС ХМАО #КУ-СМЭВ3-АКТИВАЦИЯ |
Заменить наименование Субъекта РФ |
Код маршрутизации |
ОКТМО Субъекта РФ |
Наименование региона |
Наименование Субъекта РФ |
Номер заявки на подключение в продуктивной среде СМЭВ 3.х в качестве поставщика к виду сведений <наименование вида сведений соответствующего услуге> |
Номер заявки направленной заказчиком на получение доступа к видам сведений в формате INC0000000000000 |
Номер заявления на ЕПГУ с промежуточными результатами по заявлению + передача комментария при смене статуса на промежуточный на продуктивной среде (с помощью вида сведений Универсальный вид сведений для приема событий электронного заявления на портале государственных услуг (функций) раздел 9) |
Номер ПЕРВОГО заявления |
Номер заявки, которая была исполнена (статус заявки 3 – Услуга оказана), в продуктивной среде |
Номер ПЕРВОГО заявления |
Номер заявки с отказом (статус заявки 4 – Отказ) |
Номер ВТОРОГО заявления |
Важно
После оформления всех заявок необходимо изменить настройки в БД в таблице amber.global_settings на реальные данные по всем муниципальным образованиям.
Для получения реальных кодов всех ведомств по всем услугам можно обратиться к заказчику или на сайте Единой системы нормативной справочной информации найти справочник Перечень организаций, предоставляющих массовые социально значимые услуги по необходимому субъекту РФ и скачать данные.