![](https://habrastorage.org/getpro/habr/upload_files/c55/e23/336/c55e23336b324381aa7a87bd5190b143.png)
Привет, Хабр! Меня зовут Софья, я работаю в РЕД СОФТ. Не так давно наша компания ускорила в два раза вывод государственных услуг на портал www.gosuslugi.ru, используя РЕДШЛЮЗ и Визуальный конструктор услуг. В этой статье я расскажу, как нам это удалось.
Уверена, что каждый из вас хотя бы раз использовал портал Госуслуги. Наша компания помогает госорганам переводить свои услуги в электронный вид для того, чтобы сделать жизнь граждан проще. До недавнего времени этот процесс занимал в среднем полгода работы.
Как это было раньше? Ведомство разрабатывало техническое задание с описанием требований на разработку услуги. Макеты будущих экранных форм создавались вручную при помощи сторонних графических редакторов. Процесс согласования технического задания представлял собой не менее трех итераций обмена комплектом документации посредством системы межведомственного электронного документооборота (МЭДО). Многостраничные текстовые описания и правила заполнения полей формы вызывали много вопросов у вовлеченных сторон, а в ходе редактирования технического задания неизбежно всплывали подводные камни. Однако описанный подход позволял реализовывать кастомизированную настройку экранных форм, не предусмотренную шаблонами в высоко востребованных услугах.
Что изменилось? В апреле 2022 года на Госуслугах заработали новые формы подачи заявлений – простые, с пошаговым заполнением и написанные на понятном для обывателя языке. Страницы таких форм строятся при помощи нового инструмента – визуального конструктора услуг (ВКУ).
ВКУ позволяет визуализировать шаги оказания услуги сразу на этапе проектирования, которое ведомство может осуществлять самостоятельно, без привлечения разработчиков Минцифры России. Срок разработки услуги занимает вдвое меньше времени. Однако процесс имеет свои особенности и накладывает определенные ограничения, которые я постаралась осветить в данной статье на основании собственного опыта работы с ВКУ.
Сегодня я научу вас работать с РЕДШЛЮЗ и ВКУ. Поехали!
1. Этапы разработки услуги
Разработка услуги при помощи ВКУ состоит из следующих этапов:
получение учетной записи разработчика и тестового пользователя, регистрация сервисного кода услуги;
конструирование услуги в среде разработки (DEV) с помощью визуального редактора, тестирование и согласование с заказчиком;
разработка VM-шаблонов;
публикация услуги в предпродуктивную среду (UAT);
настройка взаимодействия с ИС ведомства, оказывающего услугу;
публикация услуги в продуктивную среду (PROD).
![Рисунок 1 – Главная страница ВКУ Рисунок 1 – Главная страница ВКУ](https://habrastorage.org/getpro/habr/upload_files/02f/869/63c/02f86963cc766693badc0c67e357a6a8.png)
2. Из чего состоит ВКУ
Процесс сборки услуги при помощи ВКУ заключается в составлении последовательных цепочек («флоу») из статичного набора «экранов».
![Рисунок 2 – Страница услуги Рисунок 2 – Страница услуги](https://habrastorage.org/getpro/habr/upload_files/01b/24d/423/01b24d423c384756b722736847426e1c.png)
Управление главной страницей ВКУ минимально. Можно развернуть «флоу» на весь экран. Масштаб страницы меняется прокруткой колесика мыши. При выделении экрана подсвечивается он сам, а также те экраны, с которыми он связан переходами. При этом справа отображается панель с его составляющими: компонентами, кнопками и переходами.
В нижней части экрана расположена мини-карта, предназначенная для упрощения ориентации в объемных «флоу» услуги. Слева – перечень экранов, отсортированный по возрастанию значения идентификатора экрана с возможностью поиска.
Разработчик может создавать несколько версий одной услуги, при этом используя первоначальную в качестве шаблона. Экспериментировать — в черновиках, а в продуктивную среду уходит сформированная версия.
![Рисунок 3 – Версии услуги Рисунок 3 – Версии услуги](https://habrastorage.org/getpro/habr/upload_files/752/7f4/45f/7527f445f984df9c92e3732539dd445a.png)
2.1. Типы экранов
Разработчиками ВКУ предлагаются следующие типы экранов:
Экран с разводящим вопросом («квиз»).
Экран со сложным компонентом.
Составной экран.
Экран для повторяющегося набора компонентов.
Составной гендерный экран.
Специальный экран, содержащий компонент типа Redirect. Позволяет осуществлять перенаправление по адресу, указанному в компоненте Redirect.
Экран отображения информации.
Концепция ВКУ построена на принципах минимализма и шаблонности. Если в ходе конструирования разработчик не обнаружил нужный экран или комбинацию компонентов, то скорее всего, он отошел от шаблона. В таком случае следует пересмотреть сценарий оказания услуги либо обратиться к команде проектирования услуг. По итогам анализа может быть принято решение о добавлении нового экрана либо компонента.
Изначально поле услуги пустое. Нажатием на «+» в левой панели добавляется первый экран (по умолчанию должен иметь тип «Экран отображения информации», т.к. является приветственным), а в правой панели добавляются его составляющие.
![Рисунок 4 – Параметры нового экрана и возможные действия над ним Рисунок 4 – Параметры нового экрана и возможные действия над ним](https://habrastorage.org/getpro/habr/upload_files/e1a/051/825/e1a051825b295041efbbb4b027031c45.png)
Настройка экрана доступна по действию «Настроить». Обязательные для заполнения поля отмечены значком *. Идентификатор экрана должен быть уникален (имеет вид sN, где N – уникальный номер, присваиваемый в порядке добавления экранов). Название должно отражать суть содержимого экрана для последующего удобного поиска. Заголовок и подзаголовок экрана отображаются заявителю.
Перечень полей экранов и компонентов довольно объемный. При этом отличить поля, содержимое которых будет впоследствии видно заявителю, от чисто технических, невозможно.
Рекомендация: хотелось бы отличать поля, скрытые от заявителя, от технических полей
Все текстовые поля экранов и компонентов распознают html-разметку. Содержимое текстов должно соответствовать редакционной политике Госуслуг.
html-разметка добавляет наглядности текстам, позволяет сделать список, выделить предупреждение и т.п. Однако приходится пользоваться сторонними редакторами, т.к. поля, предполагающие ввод многострочного текста, содержат всего одну строку.
Рекомендация: обеспечить возможность редактирования html-разметки непосредственно в компонентах ВКУ
![Рисунок 5 – Карточка настроек экрана Рисунок 5 – Карточка настроек экрана](https://habrastorage.org/getpro/habr/upload_files/083/d4d/9e3/083d4d9e38b07a9868e745b320b4a1a3.png)
В первом и последнем экранах должен быть проставлен соответствующий признак.
![Рисунок 6 – Признаки первого и последнего экранов Рисунок 6 – Признаки первого и последнего экранов](https://habrastorage.org/getpro/habr/upload_files/333/aff/b3b/333affb3b2cf6e1acae3ed3b0ceef1a1.png)
По действию «Удалить» экран удаляется без возможности восстановления. По действию «Превью» открывается форма предварительного просмотра содержимого экрана. Данный режим позволяет менять местами компоненты либо удалять их, а также перейти к настройке каждого компонента.
Отдельные типы экранов и компонентов предполагают сложную настройку компонентов.
Рекомендация: добавить функцию создания экрана с копированием
![Рисунок 7 – Форма «превью» экрана Рисунок 7 – Форма «превью» экрана](https://habrastorage.org/getpro/habr/upload_files/868/5e7/8e9/8685e78e9f0bb136eccc3f1c4e01b468.png)
В режиме «превью» становятся доступными действия:
«Настроить экран» - открывает форму настройки экрана.
«Проверить экран» - автоматически проверяет экран на наличие ошибок.
![Рисунок 8 – Модальное окно с предупреждением об ошибках на экране Рисунок 8 – Модальное окно с предупреждением об ошибках на экране](https://habrastorage.org/getpro/habr/upload_files/055/f81/bb8/055f81bb807ef6e5ecb6b91dd0ecc647.png)
«Опубликовать экран» - позволяет разработчику услуги увидеть, как услуга будет отображаться заявителю. В режиме публикации активны все кнопки и иные элементы экрана. Они работают так, как будут работать на Госуслугах.
![Рисунок 9 – Превью и опубликованный приветственный экран услуги Рисунок 9 – Превью и опубликованный приветственный экран услуги](https://habrastorage.org/getpro/habr/upload_files/957/e2d/2dc/957e2d2dcd6b9d76534b0cdc1b0b6e0b.png)
2.2. Типы компонентов
Экран должен содержать как минимум один компонент. Каждому типу экрана соответствует определенный набор компонентов. Например, для типов «Экран с разводящим вопросом», «Специальный экран, содержащий компонент типа Redirect…» доступно только по одному типу компонента; для типа «Экран отображения информации» - только два типа компонента. Остальные типы экранов позволяют добавлять множество компонентов различных типов.
![Таблица 1 – Соответствие отдельных типов экранов и присущих им компонентов Таблица 1 – Соответствие отдельных типов экранов и присущих им компонентов](https://habrastorage.org/getpro/habr/upload_files/59d/9ea/561/59d9ea5615426ec0cb16d6686cb0ea1e.png)
В форме добавления компонента реализован поиск, а также разбивка на смысловые группы.
![Рисунок 10 – Форма добавления компонентов на экран Рисунок 10 – Форма добавления компонентов на экран](https://habrastorage.org/getpro/habr/upload_files/d90/d18/e4a/d90d18e4ab93f4e98f9b503db11842e9.png)
Обязательные для заполнения поля отмечены значком *. Идентификатор компонента должен быть уникален (имеет вид сN, где c – латинская, N – уникальный номер, присваиваемый в порядке добавления компонентов). Удобочитаемое имя компонента должно отражать суть его содержимого для последующего удобного поиска. Заголовок компонента отображается заявителю услуги.
Каждый компонент имеет свои особенности. Отдельные типы компонентов, например, «Выпадающий список со строкой поиска (Lookup)», допускают возможность использования внешних справочников, опубликованных в Единой системе нормативно-справочной информации (ЕС НСИ). При этом при настройке компонента описывается маппинг полей.
«Компонент для загрузки файлов (FileUploadComponent)» позволяет обеспечить загрузку как одного, так и множества файлов, ограничивать их формат, размер и количество. Доступна разбивка на смысловые группы путем добавления уникальных «загрузчиков».
«Компонент для объединения повторяющегося набора компонентов» (RepeatableFields)) позволяет объединять добавленные на экран компоненты в группы для последовательного заполнения однотипных данных.
![Рисунок 11 – Пример реализации повторяющегося компонента Lookup Рисунок 11 – Пример реализации повторяющегося компонента Lookup](https://habrastorage.org/getpro/habr/upload_files/14c/bb9/369/14cbb9369b3794bfa3891ac91ec40d3e.png)
![Рисунок 12 – Настройка компонента загрузки файлов и пример отображения заявителю Рисунок 12 – Настройка компонента загрузки файлов и пример отображения заявителю](https://habrastorage.org/getpro/habr/upload_files/e30/b47/c78/e30b47c7800d0a8d1df7edb6012b5979.png)
![Рисунок 13 – Настройка ссылки на внешний справочник и пример отображения заявителю Рисунок 13 – Настройка ссылки на внешний справочник и пример отображения заявителю](https://habrastorage.org/getpro/habr/upload_files/4b6/85a/177/4b685a1779aa8a8601b79f2e484a5ec9.png)
Форма настройки компонента открывается нажатием левой кнопки мыши на его название.
Большинство заголовков и описаний настроек компонентов написаны техническими терминами.
Рекомендация: добавить подсказки с описанием принципа заполнения настроек и их влияние на поведение компонента
![Рисунок 14 – Действия над компонентом и карточка настроек компонента Рисунок 14 – Действия над компонентом и карточка настроек компонента](https://habrastorage.org/getpro/habr/upload_files/135/243/ff9/135243ff91930199c37260a5c9cfe102.png)
2.3. Взаимосвязь экранов
Для того, чтобы обеспечить переход с одного экрана на другой, должна быть добавлена кнопка и настроены правила перехода.
По умолчанию цвет кнопок – синий. На приветственном экране кнопка должна называться «Начать». На экранах, предполагающих только подтверждение автоматически загруженной из личного кабинета пользователя Госуслуг информации, – «Верно». На экране, предназначенном для предпросмотра заполненного заявления – «Подать заявление». На последнем экране – «В личный кабинет». На прочих экранах кнопка обычно имеет название «Далее».
![Рисунок 15 – Форма настройки кнопки Рисунок 15 – Форма настройки кнопки](https://habrastorage.org/getpro/habr/upload_files/f58/9d0/4fa/f589d04fa08edb76974abe3b77cc03a0.png)
Правило перехода – это подробное описание логики перехода между экранами. Правильная настройка правил перехода – залог качественной разработки услуги.
Для каждого экрана, кроме первого и последнего, должно быть обязательно добавлено правило перехода с предыдущего экрана и правило перехода на следующий экран. Если экран содержит варианты ответа на вопрос либо чек-боксы – то должны быть добавлены правила перехода для каждого из выбранных заявителем вариантов.
Обязательные для заполнения поля карточки настройки правила перехода отмечены значком «*». Экран, с которого осуществляется настраиваемый переход, выбирается из раскрывающегося списка экранов, добавленных ранее. Название правила перехода обычно имеет вид: s1-s2. Для настройки правила предназначен блок «Условия перехода». Условие может быть простым или сложным.
В ходе разработки были освоены следующие условия перехода:
простое с посещением компонента – кнопка перехода на следующий экран становится активной при условии, что заявитель посетил экран (см. Рисунок 16);
![Рисунок 16 – Пример простого перехода с посещением экрана Рисунок 16 – Пример простого перехода с посещением экрана](https://habrastorage.org/getpro/habr/upload_files/2e9/dc3/868/2e9dc38686af5bc894c8a9dd3e3ac248.png)
простое с выбранным значением в квизе, радиокнопке или чек-боксе (см. Рисунок 17);
сложное с выбором типа учетной записи пользователя (см. Рисунок 18).
![Рисунок 17 – Пример простого перехода с выбором значением в компоненте Рисунок 17 – Пример простого перехода с выбором значением в компоненте](https://habrastorage.org/getpro/habr/upload_files/efa/b62/aeb/efab62aeb6e3594698631693003b707c.png)
![Рисунок 18 – Пример сложного перехода с выбором типа учетной записи пользователя Рисунок 18 – Пример сложного перехода с выбором типа учетной записи пользователя](https://habrastorage.org/getpro/habr/upload_files/d52/12b/06e/d5212b06e6a393851e58ca0d8c894750.png)
2.4. VM-шаблоны
VM-шаблон XML – это шаблон, написанный с применением синтаксиса Apache Velocity. VM-шаблон служит для создания XML-документа заявления, который направляется непосредственно в ведомство для получения услуги, на основании ответов заявителя, которые автоматически сохраняются в виде сценария DTO в ходе заполнения интерактивной формы заявления.
VM-шаблоны составляются вручную путем заполнения полей XML, необходимых для конкретного сценария, значениями переменных из предварительно выгруженного сценария DTO:
xxxxxxxx_Applicant.vm - шаблон, генерирующий бизнес-данные заявления;
pdf_xxxxxxxx_Applicant.vm - шаблон, используемый для генерации PDF-файла заявления в личном кабинете заявителя;
t_xxxxxxxx.vm - шаблон, на основе которого генерируется транспортная XML,
где xxxxxxxx - сервисный код услуги (ServiceId).
Все составленные шаблоны необходимо загрузить в ВКУ, выбрав соответствующее действие в меню главной страницы услуги.
![Рисунок 19 – Загруженные VM шаблоны Рисунок 19 – Загруженные VM шаблоны](https://habrastorage.org/getpro/habr/upload_files/ad8/aca/3eb/ad8aca3eb64b37eb1d7dd9938da89ded.png)
XML заявления создается Адаптером SP, который собирает XML, заполняя его данными из VM-шаблона, черновика заявления и глобальных переменных профиля пользователя. После этого Адаптер SP отправляет XML в Service Processing (SP), где и происходит отправка в ведомство.
2.5. Сопряжение экранов со СМЭВ
Когда при заполнении заявления пользователь доходит до экрана, который содержит признак последнего (см. Рисунок 6), то сервис автоматически пытается сформировать файлы для отправки в СМЭВ 3 посредством Госуслуг.
Для отправки заявлений в ведомство используется универсальный вид сведений СМЭВ 3.
2.6. Этапы перевода услуги в продуктивную среду
Конструирование услуги ведется в среде разработки (DEV), где хранятся все доработки, которые первично выполнены разработчиками, в том числе черновики. Для DEV-среды используется отдельный набор тестовых учетных записей, настраивается доступ к тестовой ЕС НСИ для корректного отображения внешних справочников.
Следующим шагом является публикация услуги в предпродуктивной среде (UAT), куда попадают только успешно протестированные в DEV доработки, заявленные для релиза в продуктивной среде.
Финальным шагом является публикация услуги в продуктивной среде (PROD).
3. Ограничения ВКУ
Разработка ВКУ весьма динамична и ведется по ходу поступления требований от ведомств, ответственных за оказание госуслуг, однако в ходе разработки можно столкнуться с ограничениями, на обход которых требуются дополнительные временные и трудозатраты.
Тем не менее, главным ограничением является то, что не все компоненты старой версии среды разработки Госуслуг были перенесены в ВКУ.
В ходе проектирования наблюдались периодические сбои в работе компонентов, при этом отображался код ошибки. Для оперативного взаимодействия со службой поддержки помогло бы логирование и/или определение типа ошибки по ее коду.
При поиске конкретного экрана и выборе его в дереве экранов черновика была бы удобной функция автоматического перехода к выбранному экрану на форме (помимо подсветки). Также недоступен поиск по коду компонента.
В связи с тем, что для правки экранов (компонентов) доступен многопользовательский доступ, была бы полезной функция просмотра истории изменений.
Не хватает функции принудительного сохранения черновика после внесения изменений (включая сообщение о том, что сохранение не успешно). Столкнулись с тем, что если в процессе внесения изменений ВКУ отключали на время проведения технических работ, изменения не сохранялись, что приводило к трудозатратам на их восстановление.
XSD-схема зачастую содержит поля, ограниченные только количеством символов. При добавлении компонентов с такими полями разработчику услуги было бы удобнее указывать число, чем составлять регулярное выражение.
ВКУ позволяет выгрузить текущую версию услуги в файл формата json. На случай потери данных «флоу» из-за сбоя ВКУ было бы полезно иметь инструмент, позволяющий загрузить json в ВКУ, чтобы на его основе выстроился «флоу».
Для выявления ошибок в VM-шаблонах на основании сформированного заявления не хватает автотеста. Есть возможность либо написать запрос для генерации XML бизнес-данных самостоятельно, либо запросить отчет у техподдержки.
ВКУ не позволяет загрузить справочники ЕС НСИ с типом «Иерархический».
4. Прием заявлений с Госуслуг
Для организации межведомственного электронного взаимодействия и предоставления государственных услуг в электронном виде использовали РЕДШЛЮЗ.
![](https://habrastorage.org/getpro/habr/upload_files/df6/695/314/df6695314edaf70ce00b250e83dd206f.png)
4.1. Использование в качестве шлюза
В РЕДШЛЮЗ есть собственный модуль, предназначенный для взаимодействия со СМЭВ 3, который позволяет относительно быстро разработать клиент (толстый и тонкий) для ведомства, ответственного за оказание госуслуги, включая адаптеры и маппинг.
Это позволяет создать интеграцию между внутренней ИС ведомства и «Госуслугами», когда РЕДШЛЮЗ берет на себя все задачи формирования / отправки / получения / обработки сообщений для СМЭВ 3.
![Рисунок 20 – Параметры универсального адаптера СМЭВ 3.0 РЕДШЛЮЗ Рисунок 20 – Параметры универсального адаптера СМЭВ 3.0 РЕДШЛЮЗ](https://habrastorage.org/getpro/habr/upload_files/b94/903/3e2/b949033e285fcd4fee6fc101de6334b9.png)
4.2. Использование для оказания госуслуги
Функционал РЕДШЛЮЗ позволяет не только отправлять / получать сообщения через СМЭВ 3, но и реализовать пользовательский интерфейс для сотрудников ведомства, при помощи которого они могут проводить входящие электронные заявления на оказание госуслуги по этапам их жизненного цикла внутри ведомства.
![Рисунок 21 – Карточка электронного заявления на оказание услуги «Запрос сведений о наличии судимости» МВД (РЕДШЛЮЗ) Рисунок 21 – Карточка электронного заявления на оказание услуги «Запрос сведений о наличии судимости» МВД (РЕДШЛЮЗ)](https://habrastorage.org/getpro/habr/upload_files/044/7ea/5f8/0447ea5f89ece6de7772453268068741.png)
5. Вывод
Функционал ВКУ и РЕДШЛЮЗ существенно сократил сроки технологического процесса по выводу интерактивных форм услуги в промышленную эксплуатацию: весь процесс занял около трех месяцев. Процедура создания экранных форм включает интуитивно понятный интерфейс добавления компонентов услуги, есть возможность оперативно вносить правки и отслеживать результат без ожидания публикаций в среде разработки. Транспорт через СМЭВ, организованный РЕДШЛЮЗ, в очередной раз показал свою эффективность. Теперь мы и дальше планируем при работе с органами государственной власти самостоятельно собирать интерактивные формы, используя комбинированное решение.
Ждем актуальных доработок!