СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

В материале представлена пошаговая инструкция по предоставлению доступа к Личному кабинету участника межведомственного взаимодействия (ЛК УВ) для двух категорий пользователей: сотрудник организации (сотрудник УВ) и представитель разработчика.

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

Что такое ЛК УВ?

Тем временем, ЛК УВ предоставляет участникам СМЭВ и их подрядчикам широчайший функционал. В системе в течение 5 минут в автоматическом режиме можно провести следующие процедуры:

  • регистрация информационной системы (ИС УВ) в тестовой и продуктивной среде;
  • получение доступа к виду сведений в тестовой и продуктивной среде в роли Потребителя и Поставщика;
  • мониторинг статуса или поиск пропавшего межведомственного запроса;
  • добавление специальной очереди;
  • регистрация вида сведений;
  • и многие многие другие.

Полное описание возможностей ЛК УВ содержится в Руководстве пользователя, которое Минцифра любезно выложила на Технологическом портале СМЭВ 3. Ниже мы подробно и с иллюстрациями перечислим шаги, которые необходимо пройти для получения доступа в Личный кабинет.

Как попасть в ЛК УВ?

  • Авторизуемся на Портале госуслуг (в ЕСИА) под учетной записью организации — участника межведомственного взаимодействия
  • Выбираем опцию «Расширенный поиск».Организация: Министерство цифрового развития, связи и массовых коммуникаций Российской Федерации.Система: Личный кабинет участника взаимодействия (ЛК УВ).По итогам фильтрации остается только один вариант ИС. Для него выбираем опцию «Присоединить нового сотрудника».
  • В открывшемся списке выбираем сотрудника организации, который еще не получил доступ к ЛК УВ, и подтверждаем выбор.

Предоставление доступа к ЛК УВ сотруднику организации-разработчика

  • Переходим в ЛК УВ и авторизуемся под учетной записью организации-участника взаимодействия.https://lkuv.gosuslugi.ru/
  • Выбираем опцию «Назначить представителя разработчика».
  • Указываем СНИЛС физлица-представителя разработчика.
  • Выбираем организацию-разработчика. Так как один человек на ЕПГУ может одновременно являться сотрудником нескольких организаций.
  • Проверяем и подтверждаем выбор.

После успешного добавления разработчика его данные появляются в разделе «Представители разработчика», а сам разработчик может зайти в ЛК УВ, авторизовавшись в ЛК УВ под учетной записью своей организации.

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

Кстати, у нас есть публичное сообщество «Вопросы СМЭВ» в телеграме. Заходите — там всегда найдется оперативный ответ почти на любой вопрос по СМЭВ.

В материале приводится исчерпывающая информация о взаимодействии с сервисами ГИС ГМП посредством СМЭВ. Перечисляются типы организаций, имеющих право работать с Системой государственных и муниципальных платежей, и их полномочия. Описывается порядок регистрации и доступа к сервису. Проводится полный обзор видов сведений ГИС ГМП в СМЭВ3. Разбирается кейс с передачей информации об оплате.

6 октября 2020 года на технологическом портале СМЭВ3 появился раздел «Интеграционный узел Адаптера, доработанного Адаптера СМЭВ 3.0 в соответствии с новыми возможностями СМЭВ 3».

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

В материале рассмотрены возможности разделения очередей входящих и исходящих сообщений на уровне СМЭВ, Адаптера СМЭВ и информационной системы Участника СМЭВ.

В материале рассмотрены причины снижения скорости работы Адаптера СМЭВ, изучен вариант переустановки Адаптера для повышения его производительности и описано собственное решение команды Хемуль IT для ускорения работы ПО Минкомсвязи — «Бустер Адаптера СМЭВ».

В табличном виде представлен перечень всех информационных систем участников СМЭВ с указанием владельца и мнемоники. Данные актуальны на 29.12.2020. Источник данных — Технологический портал СМЭВ.

На странице собраны ссылки на историю версии бесплатного Адаптера СМЭВ. Ранние версии решения полезны как для последовательного апгрейда до актуальной версии с сохранением пользовательских данных, так и в случае необходимости возврата к более стабильным сборкам..

В материале приводится обзор Модуля мониторинга СМЭВ. Решение предоставляет пользователю набор виджетов и реестр сообщений с полной информацией о процессах обработки межведомственных запросов в электронном виде. Модуль является разработкой команды Хемуль IT и поставляется как в составе Универсального интерфейса Адаптера СМЭВ, так и в качестве самостоятельного серверного решения.

В материале представлен список видов сведений СМЭВ, к которым фактически могут получить доступ юридические лица различных категорий. Материал актуален на декабрь 2021 года.

Для установки Адаптера СМЭВ на компьютер необходимо выполнить несколько основных шагов:

В предыдущих статьях была описана установка на компьютер Java-машины, криптопровайдера и СУБД. Теперь подготовительные работы завершены и вам необходимо установить Адаптер СМЭВ.

Данная статья посвящена установке Адаптера СМЭВ.

Загрузите дистрибутив Адаптера СМЭВ

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

В этом разделе размещены ссылки на скачивание дистрибутивов и технической документации Адаптера СМЭВ.

По завершению загрузки дистрибутива можно приступать к установке Адаптера СМЭВ на компьютер. Установка на Windows отличается от установки на Linux, поэтому описание процесса представлено в соответствующих статьях:

– Специфика установки Адаптера в ОС Windows

– Специфика установки Адаптера в ОС CentOS

Настройте Адаптер СМЭВ после установки

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

Выберите среду СМЭВ

Чтобы подключить Адаптер СМЭВ к тестовой среде СМЭВ, выберите в выпадающем списке предустановленных настроек «СМЭВ 1.2 Тестовая среда» и нажмите кнопку «Применить и сохранить»:

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

Нажмите «Да» в окне подтверждения использования предустановленных настроек:

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

Теперь среда СМЭВ выбрана. Соответствующая этой среде совокупность настроек применена, но при необходимости вы можете изменить любой из параметров отдельно.

Проверьте адрес личного кабинета участника взаимодействия

Теперь необходимо проверить адрес личного кабинета участника взаимодействия. Для этого нажмите кнопку «Показать расширенные настройки» и перейдите в раздел «10. ЛК УВ»:

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

Если это не так, то скорректируйте его и нажмите кнопку «Применить и сохранить».

Включите сохранение сообщений

Возможно, вам потребуется включить сохранение сообщений. Например, это необходимо для получения xml-файлов сообщений, направляемых в Ситуационный центр при подтверждении корректности подключения Участника взаимодействия к СМЭВ для работы с Видом сведений.

Для включения этого функционала нажмите кнопку «Показать расширенные настройки» в верхней части страницы, и перейдите к разделу «11. Отладка»:

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

Включите в нём флажок «11.2 Сохранение входящих/исходящих сообщений СМЭВ» и нажмите кнопку «Сохранить».

Других основных настроек на этом этапе не требуется.

Зарегистрируйте информационную систему

Далее следует зарегистрировать информационную систему. Для этого нажмите на кнопку с тремя горизонтальными полосками в левом верхнем углу страницы веб-интерфейса. Откроется меню, в котором следует выбрать пункт «Информационные системы»:

Больше проверок:  Юридический портал Свердловской области

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

Далее нажмите кнопку «+ Добавить», откроется окно регистрации новой информационной системы:

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

Введите мнемонику вашей информационной системы и нажмите кнопку «Сохранить», после чего вы увидите эту информационную систему в перечне информационных систем:

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

Настройте информационную систему

Зарегистрированную информационную систему требуется настроить. На этом шаге вам следует выбрать способ использования Адаптера СМЭВ, настроить электронную подпись и указать учётные данные для доступа к FTP серверу, используемому для передачи вложений. Кроме того, вам может понадобиться включить сохранение входящих и исходящих сообщений.

Кликните на названии вашей информационной системы. Откроется страница настройки информационной системы.

Выберите способ использования Адаптера СМЭВ

Выберите способ использования Адаптера СМЭВ из выпадающего списка «1.2 Способ использования Адаптера»:

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

Из предлагаемых вариантов выберите «Встроенный интерфейс».

Примечание: В зависимости от потребностей, вы можете выбрать и другие представленные здесь интерфейсы. Особенности их настройки освещены в других статьях, поэтому далее мы рассмотрим отправку и прием сообщений только через встроенный Web-интерфейс Адаптера.

Настройте электронную подпись (ЭЦП)

Для настройки электронной подписи перейдите в раздел «2. Подпись».

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

Заполните корректными данными поля «2.2. Псевдоним приватного ключа», «2.3. Пароль приватного ключа» и «2.4. Псевдоним сертификата». Псевдоним сертификата заполните тем же наименованием, что и псевдоним приватного ключа, найти его вы можете на странице управления ключами КриптоПро JCP. Введите пароль приватного ключа. Обратите внимание, что пароль приватного ключа не может быть пустым значением. Если вы получили ключи без пароля, предварительно следует установить пароль на них, как было описано в посвящённой установке КриптоПро JCP статье.

После этого проверьте корректность настроек электронной подписи. Для этого поднимитесь наверх страницы и нажмите кнопку «Проверить подпись». Если всё сделано правильно, то вы увидите такое сообщение:

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

Нажмите кнопку «ОК» и переходите к настройке доступа к FTP.

Укажите данные доступа к FTP

Перейдите в раздел «7. Вложения»:

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

Теперь информационная система настроена.

Зарегистрируйте Вид сведений

В случае выбора использования Адаптера СМЭВ в режиме встроенного интерфейса вам потребуется зарегистрировать Вид сведений. Для тестирования работоспособности установленного Адаптера СМЭВ можно воспользоваться, например, запросом данных Вида сведений «Выписки из ЕГРИП по запросам органов государственной власти (открытые сведения и адрес места жительства ИП)».

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

После установки Адаптера СМЭВ и подключения к тестовой среде СМЭВ вы должны отправить эталонные сообщения. Получение от СМЭВ эталонных ответов будет свидетельствовать о корректной работе Адаптера СМЭВ с данным Видом сведений.

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

На открывшейся странице нажмите на кнопку «+ Добавить», выберите загруженный zip файл с Видом сведений и нажмите кнопку «Открыть». Обратите внимание, что распаковывать загруженный архив не требуется.

После завершения регистрации Вида сведений в Адаптере СМЭВ откроется карточка Вида сведений. Нажмите кнопку «Редактировать» и внесите удобное наименование Вида сведений вместо предложенного по умолчанию:

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

Нажмите кнопку «Сохранить» и перейдите вниз страницы до раздела «Настройки сообщений»:

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

Нажмите кнопку «Добавить», после чего выполните настройку сообщения Запрос:

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

Выберите в выпадающем списке «Корневой элемент» значение «FNSVipipadrRequest» и нажмите кнопку «Сохранить». Настройка запросов будет сохранена:

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

Нажмите ещё раз кнопку «Добавить» и настройте сообщения Ответ:

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

Выберите в выпадающем списке «Тип» значение «Ответ» и в выпадающем списке «Корневой элемент» значение «FNSVipipadrResponse», после чего нажмите кнопку «Сохранить». Настройка ответов будет сохранена:

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

После завершения настройки сообщений перейдите на вкладку «Настроечные файлы» и нажмите кнопку «Сгенерировать»:

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

Будет сгенерирован конфигурационный файл:

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

Кликните по строке настроечного файла. Откроется страница карточки настроечного файла:

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

Нажмите кнопку «Применить». На этом настройка Вида сведений завершена.

Если вы планируете использовать Адаптер СМЭВ в других режимах, например, в режиме Файлового хранилища, регистрации Вида сведений не требуется.

Зарегистрируйте учётную запись пользователя

Осуществление межведомственного взаимодействия в режиме встроенного интерфейса выполняется под учётной записью простого пользователя, не обладающего административными правами. Для того, чтобы зарегистрировать учётную запись пользователя, откройте главное меню и выберите пункт «Пользователи»:

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

На странице «Пользователи» нажмите кнопку «+ Добавить пользователя». Откроется страница регистрации нового пользователя:

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

После этого вам следует выйти из учётной записи администратора Адаптера СМЭВ и авторизоваться под учётной записью простого пользователя для проверки отправки запроса и получения ответа СМЭВ.

Если вы планируете использовать Адаптер СМЭВ в других режимах, например, в режиме Файлового хранилища, регистрации учётной записи пользователя Адаптера СМЭВ не требуется.

Отправьте запрос и получите ответ

Страница, открывшаяся простому пользователю Адаптера СМЭВ после авторизации, выглядит так:

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

Нажмите кнопку «+ Создать». Откроется окно выбора Вида сведений для создания запроса:

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

Нажмите кнопку «Создать». Откроется страница вашего исходящего взаимодействия:

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

Нажмите кнопку «Заполнить». Откроется форма запроса, которую следует заполнить эталонными данными, использующимися для тестовой среды СМЭВ:

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

Заполните поля формы данными эталонного запроса:

– «Идентификатор запроса, сформированный запрашивающей стороной». Внесите сюда эталонное значение «00000000-0000-0000-0000-000000000006»;

– Из выпадающего списка выберите значение «ИНН физического лица»;

– В поле «ИНН юридического лица» внесите эталонное значение «772747550002».

Нажмите кнопку «Сохранить». Форма закроется и на странице вашего исходящего взаимодействия нажмите кнопку «Отправить». Адаптер СМЭВ проинформирует вас, что сообщение поставлено в очередь:

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

Нажмите кнопку «ОК» и затем откройте главное меню и выберите пункт «Исходящие взаимодействия». Дождитесь информации о входящем сообщении:

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

Нажмите ссылку «Открыть» в форме «Новые уведомления», после чего откроется страница исходящего взаимодействия, содержащая запрос и ответ:

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

В разделе «Ответ» нажмите кнопку «Открыть». Откроется ответ, полученный из СМЭВ:

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

Полученный код обработки «54» соответствует эталонному ответу на отправленный эталонный запрос.

На этом установка, настройка и проверка работы Адаптера СМЭВ в режиме встроенного интерфейса закончена.

Описание настройки и использования интерфейса БД Адаптера приведено в статье “Отсылаем запрос через БД интерфейс Адаптера”.

Описание настройки и использования файлового интерфейса Адаптера приведено в статье “Получаем запрос и отсылаем ответ через файловый интерфейс Адаптера”.

Все, что вы хотели узнать о свободно распространяемом клиенте для межведомственного взаимодействия, но не знали, где искать информацию.

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

UPD 03. 2020

С момента опубликования статьи описываемая в ней версия Адаптера СМЭВ морально и функционально устарела. Решение не поддерживает:

  • новый ГОСТ электронной подписи;
  • версию 1.3 схем СМЭВ.
Больше проверок:  Закон единого

Техподдержка СМЭВ поддерживает только последние версии адаптера.
Первое, что отвечают коллеги на соответсвующие запросы пользователей: «Сначала обновитесь до последней версии»

В связи с этим команда Хемуль IT настоятельно рекомендует обновить решение до последней версии, опубликованной на технологическом портале СМЭВ. Все опубликованные версии ПО также можно найти в материале «История версий Адаптера СМЭВ«.

Бесплатные адаптеры СМЭВ

Те особо любознательные пользователи технологического портала СМЭВ, кто долистывал главную страницу техпортала до конца, могли видеть там следующие ссылки:

В данной статье речь пойдет об Адаптере для работы со СМЭВ 3 (далее — Адаптер). Мы расскажем, какие преимущества можно извлечь из его использования в интеграционных решениях, кратко опишем процедуры установки, настройки и работы с интерфейсом.

В следующих статьях мы расскажем об Адаптере СМЭВ 3.0 и о библиотеке для сборки клиента СМЭВ 3.

Описание Адаптера для работы со СМЭВ 3

Адаптер для работы со СМЭВ 3 был создан по заказу Минкомсвязи для облегчения и ускорения процессов интеграции со СМЭВ 3 на стороне участников межведомственного взаимодействия.

Адаптер представляет собой Java-приложение, которое с одной стороны полностью интегрировано со СМЭВ 3, а с другой — предоставляет участнику взаимодействия 4 различных интерфейса:

  • web-сервис;
  • обмен сообщениями через файловую систему;
  • обмен сообщениями через базу данных;
  • обмен сообщениями через Java Message Service.

Кроме того, к Адаптеру прилагается графическое пользовательское приложение (GUI адаптера), с помощью которого можно реализовать простейшее интеграционное решение без создания дополнительной информационной системы. При этом все запросы к Поставщикам видов сведений и ответы на запросы Потребителей создаются пользователями в ручном режиме посредством графического интерфейса.

GUI адаптера взаимодействует с самим Адаптером только через web-сервис.

Требования

В силу того, что Адаптер написан на Java, он является кроссплатформенным, и его можно устанавливать как на Windows, так и на nix-системы.

Для установки Адаптера требуются следующий набор компонентов:

  • JRE (бесплатно);
  • (КриптоПро CSP + Trusted Java) или (КриптоПро CSP + КриптоПро Java CSP) или КриптоПро JСP.

Для взаимодействия с Адаптером через JMS потребуется Apache ActiveMQ, а для взаимодействия с адаптером через базу данных потребуется одна из поддерживаемых им СУБД:

  • Oracle;
  • MySQL;
  • PostgreSQL;
  • MS SQL Server.

Структура

Функциональная схема Адаптера для работы со СМЭВ представлена на рисунке.

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

К Адаптеру СМЭВ можно подключить несколько информационных систем участника взаимодействия. При этом системы могут подключаться как к одному, так и к разным интерфейсам.

Анализ логов Адаптера позволяет предположить, что он состоит из следующих модулей:

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

В базе данных содержатся все отправленные и полученные сообщения в формате адаптера СМЭВ, а также файлы вложений. Кроме того, в базе хранятся сообщения, которые Адаптер по той или иной причине не смог отправить в СМЭВ (например, на момент отправки запроса временно не работал сервис СМЭВ, или очередь Поставщика была переполнена и не смогла принять очередной запрос). Адаптер будет автоматически повторять попытки отправить эти сообщения в СМЭВ до тех пор, пока они не попадут в очередь Поставщика (или Потребителя, в зависимости от направления взаимодействия).

В качестве СУБД могут быть использованы базы данных Derby (этот режим устанавливается по умолчанию) или PostgreSQL (здесь потребуется исполнить пару простеньких па с бубном).

Кроме сообщений в формате Адаптера СМЭВ, которые хранятся в базе данных, специальный отладочный режим позволяет сохранять сообщения в формате СМЭВ в виде XML-файлов. О разнице форматов Адаптера СМЭВ и самого СМЭВ речь пойдет ниже, а здесь сделаем предупреждение о том, что отладочный режим генерирует очень много XML-файлов. Регистрируется каждый запрос к очереди участника в СМЭВ и ответ на него (включая сообщения о пустой очереди), а эти запросы Адаптер посылает непрерывно.

Преимущества использования Адаптера СМЭВ в интеграционных решениях

В чем же заключаются преимущества использования Адаптера СМЭВ перед разработкой интеграционного решения «с нуля»?

Во-первых, упрощаются форматы XML-сообщений.

На следующих рисунках представлены: сверху — формат СМЭВ (из Методических рекомендаций по работе с ЕСМЭВ версии 3.4), снизу — формат Адаптера СМЭВ.

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

ЭП-ОВ – это электронная подпись информационной системы участника взаимодействия (органа власти).

ЭП-СП – это электронная подпись должностного лица участника взаимодействия, от имени которого подается запрос (расшифровка аббревиатуры СП утеряна).

При беглом анализе обоих схем бросается в глаза то, что в схеме Адаптера отсутствует подпись ЭП-ОВ. Эту функцию адаптер СМЭВ берет на себя – запросы, ответы и сообщения-тикеты (Ack) подписываются Адаптером автоматически.

Маленький бонус – тикеты формируются Адаптером тоже автоматически. Разработчику интеграционного решения нет необходимости реализовывать все нюансы взаимодействия со СМЭВ, описанные в Методических рекомендациях.

Итак, во-вторых, Адаптер СМЭВ автоматически подписывает сообщения и тикеты подписью информационной системы участника взаимодействия.

К сожалению, в тех случаях, когда запросы определенных видов сведений требуют подписи должностного лица (например, запрос данных о доходах физлиц по справкам 2-НДФЛ у ФНС), эту подпись приходится формировать самостоятельно. Адаптер тут не помощник.

Но могут быть использованы:

  • библиотека для сборки клиента СМЭВ 3, о которой будет рассказано в одной из следующих статей;
  • GUI адаптера СМЭВ, если взаимодействие осуществляется с его помощью (GUI адаптера описывается в последнем разделе данной статьи).

В-третьих, вместо элемента TransactionCode в схеме Адаптера применяются элементы комплексного типа createGroupIdentity или linkedGroupIdentity.

Первый из них используется в запросах и представляет собой нижеследующую последовательность элементов.

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

На основании значений этих элементов Адаптер СМЭВ самостоятельно получает код транзакции в СГКТ, используя сервис СПКТ.

Расшифровку этих непроизносимых аббревиатур можно посмотреть в Методических рекомендациях, но лучше не тратить на это время.

Коды транзакций были придуманы для сложных бизнес-процессов, когда одно ведомство посылает запрос во второе ведомство, которое для подготовки ответа посылает запросы в третье или четвертое ведомство. Код транзакции служит для объединения всех этих запросов в одну бизнес-транзакцию.

Больше проверок:  Законодательство, правовая система, новости и аналитика. Все о юридическом рынке

На практике же эта идея пока не используется, поэтому в качестве значений всех трех элементов CreateGroupIdentity можно передавать по двадцать нулей, и СПКТ вернет вполне годный код транзакции.

Элемент linkedGroupIdentity используется в ответах на запросы, полученные из СМЭВа, т.е. когда участник взаимодействия выступает в роли Поставщика вида сведений. Причем этот элемент заполняется Адаптером автоматически при обработке запроса.

В-четвертых, разработчику интеграционного решения, использующему Адаптер СМЭВ, нет необходимости разбираться в том, как передавать вложения в СМЭВ – вложенными в запрос или отдельными файлами через FTP-ресурс.

Все вложения перемещаются в каталог файловой системы, а в элементах AttachmentHeader запроса передаются ссылки на них.

СМЭВ Диджет и СМЭВ ЛК УФ Доступ для сотрудников и разработчиков

Адаптер самостоятельно принимает решение (на основании размера вложения), каким образом передавать вложения – MTOM или отдельным файлом через FTP.

Если вложение не подписано подписью должностного лица, то Адаптер совершенно самостоятельно подписывает его подписью ЭП-ОВ.

Еще два неочевидных преимущества работы через Адаптер СМЭВ – это возможность отправки в СМЭВ псевдосинхронных запросов (SendSyncRequest) при подключении информационной системы через web-интерфейс и реализация Адаптером службы приема от СМЭВ push-уведомлений.

SendSyncRequest со стороны информационной системы участника выглядит как запрос в СМЭВ с немедленным получением синхронного ответа на него.

Под капотом это реализуется с помощью стандартных асинхронных запросов и ответов СМЭВ.

Использование SendSyncRequest имеет смысл только в случае быстрой (секунды) реакции Поставщика на поступающие к нему запросы, а такие виды сведений еще нужно поискать.

Push-сервис – это замечательный компонент, который должен получать push-уведомления от СМЭВ о том, что в очереди участника взаимодействия появилось новое сообщение (например, ответ на запрос).

Но для того, чтобы сделать этот push-сервис видимым со стороны СМЭВ, нужно спуститься в организационно-бюрократический ад и пройти все семь его кругов сначала в одном направлении — с техническими службами Ростелекома, а потом в другом направлении — со службой безопасности.

Если бы push-уведомление содержало в себе сам ответ на запрос (для Потребителя ВС) или запрос от другого участника взаимодействия (для Поставщика ВС),  эти мытарства, может, и имели бы смысл.

Но push-уведомление от СМЭВ реализовано в семантике «Посмотри свою очередь – там что-то новенькое появилось». После такого уведомления все равно требуется посылать запрос в СМЭВ на чтение очереди.

А Адаптер СМЭВ и так непрерывно отправляет такие запросы.

Собственно, поэтому «синхронный» запрос и push-уведомления отнесены нами в разряд неочевидных преимуществ СМЭВ-Адаптера.

Работа с GUI-адаптера (готовое решение из бесплатной коробки)

Если взаимодействие участника со СМЭВ предполагается вдумчивым и неспешным, другими словами, если запросы и ответы будут обрабатываться вручную, а интеграция с информационной системой участника по тем или иным причинам нецелесообразна — за счет подключения GUI к Адаптеру  можно получить полноценный клиент для межведомственного взаимодействия.

  • В двух командных оболочках последовательно запускаем два приложения – Адаптер СМЭВ и GUI адаптера СМЭВ.
  • Открываем интернет-браузер, и в строке адреса вводим «http://localhost:8082/».
  • Откроется интерфейс администратора, в котором заполним сведения о нашей информационной системе.

    Наименование системы может быть любым понятным пользователю.
    Мнемоника системы должна совпадать с той, которая зарегистрирована в СМЭВ и настроена в адаптере СМЭВ.
    Путь к файлу вложений должен совпадать с путем, настроенным в адаптере СМЭВ. Но может и вовсе отсутствовать, если виды сведений, обмен которыми предполагается реализовать, не используют вложений.

  • Переходим на закладку «Управление видами сведений» и добавляем описание вида сведений.

    Наименование вида сведений может совпадать с приведенным на технологическом портале, а может быть любым, удобным и понятным пользователям участника взаимодействия.
    Наименование схемы – необходимо указывать namespace из схемы вида сведений.
    Загрузить файл схемы – прикрепляется либо сам XSD-файл, либо, если в схеме есть импортируемые схемы, zip-архив, содержащий все схемы, используемые для вида сведений.
    Обычно в виде таких архивов схемы ВС хранятся на технологическом портале, но иногда их приходится собирать руками.
    Наименования корневых элементов запроса и ответа копируются из схемы вида сведений.
    В списке связанных информационных систем нужно указать те ИС, которые будут работать с создаваемым видом сведений. Для каждой ИС (если их много) могут быть указаны разные ВС (если их много).
    Нажимаем кнопку «Добавить».

  • Выходим из системы и осуществляем вход под учетной записью пользователя.

    У простого пользователя есть возможность создавать и отправлять в СМЭВ запросы, просматривать полученные ответы, просматривать полученные запросы и писать на них ответы.

  • Пользователю предоставляется интерфейс, в котором он может отслеживать состояние всех отправленных запросов и просматривать полученные ответы.
  • Пользователю предоставляется возможность просматривать как запрос, так и ответ на него.

    Возможность вывода сообщений на печать у пользователя, к сожалению, отсутствует.

Работа с входящими запросами, где участник взаимодействия выступает в роли поставщика вида сведений, происходит аналогичным образом.

В качестве заключения

В настоящей статье приведен общий обзор Адаптера для СМЭВ и преимуществ его применения в интеграционных решениях.

Главный вывод заключается в том, что продукт вполне работоспособен, несмотря на несовершенство документации к нему и определенные трудности в установке и настройке, обусловленные этим несовершенством.

В одной из следующих статей мы расскажем о реальных решениях, построенных на базе Адаптера СМЭВ, а также о последней версии Адаптера, в которую внесен ряд существенных изменений.

Также вы можете передать задачи организации СМЭВ-взаимодействия участникам нашего проекта. Качественная настройка СМЭВа и интеграция Адаптера с различными ИС — наш нехемульский долг.