Пример создания кейса «Распознавание паспорта» в ROBIN Process.

Краткое описание кейса

Предварительно пользователь создает 3 экранные формы в разделе "Мои экранные формы". Более подробно ознакомиться с документацией по созданию экранных форм можно по ссылке.

Двух роботов в студии версии Еnterprise. Первый робот будет предназначен для распознавания данных с паспорта, второй робот для формирования отчета в формате excel документа и ссылки на его скачивание. Далее пользователь опубликовывает роботов в хранилище.

После пользователь создает проект процесса. Для этого он располагает в графическом редакторе 2 блока "Робот" и 3 блока "Экранные формы" и блок "Финиш". Более подробно ознакомиться с документацией по созданию процессов можно по ссылке.

1. В первом блоке "Экранная форма" пользователь загружает фотографии паспорта с помощью элемента "Загрузить вложение". Результатом экранной формы будет созданный идентификатор (гуид), который будет передаваться в обработку роботу.
2. Во втором блоке робот считывает данные с фотографий и заносит результаты в экранную форму.
3. В третьем блоке "Экранная форма" пользователь подтверждает, что данные распознались правильно, в случае необходимости, пользователь может их скорректировать.
4. В четвертом блоке робот формирует отчет и ссылку на его скачивание и передает ссылку в итоговую экранную форму.
5. Из блока "Экранная форма" имеется возможность скачивания отчета с помощью элемента "Ссылка". Документа скачивается в формате excel на машину, где был запущен процесс.

Создание экранных форм

Рассмотрим более подробно кейс "Распознавание паспорта". Пользователь создает три экранные формы.

Первая экранная форма

Первая экранная форма с наименованием "Прикрепить паспорт" будет предназначена для загрузки фотографии 2, 3 и 5 страницы паспорта.

Для этого потребуется выбрать с панели с элементами экранной формы элементы "Загрузить вложение", "Колонки" и две "Кнопки" которые будут располагаться внутри элемента "Колонки", а также проставить свойства у этих элементов.  

В ROBIN Process по нажатию на элемент справа отобразятся свойства, которые необходимо заполнить пользователю.

Элемент "Загрузить вложение"

В свойстве "Имя переменной" необходимо указать наименование переменной. Свойство "Название" проставляется автоматически, при необходимости название можно отредактировать (название будет отображаться в редакторе экранных форм в центральной части), также пользователь выбирает в поле "Положение название" радиокнопку "сверху". Ширину у поля "Название" пользователь оставляет по умолчанию 100%, аналогично оставляем поле "Ширина поля для ввода". Формат принимаемых файлов оставляем пустым.

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

Далее рассмотрим элемент "Колонки". Для кейса потребуется 2 колонки.

Для первой колонки выбираем размер колонки 50%, чек-бокс "обводка" для кейса не потребуется, стиль линии пользователь выбирает "Сплошная" и ширину 1 пиксель. Во второй колонке пользователь выбирает аналогичные параметры.

Примечание: 2 колонки поставляются автоматически, если потребуется больше, то необходимо прожать кнопку "Добавить колонку".

Последними элементами экранной формы "Прикрепить паспорт" будут "Кнопки" расположенные внутри элемента "Колонки". Первая "Кнопка" предназначена для подтверждения передачи данных, вторая "Кнопка" для отмены передачи данных. 

Для кнопки "Подтвердить" необходимо заполнить "Название". В поле "Тип" пользователь выбирает цвет кнопки, например зеленый. Обязательный параметр в чек-боксе "кнопка при подтверждении" должен быть проставлен всегда, иначе кнопка не будет активной. 

Для кнопки "Отменить" заполняем поля аналогичным образом.

Таким образом, собрана первая экранная форма "Прикрепить паспорт" для кейса "Распознавание паспорта". Экранную форму можно предварительно посмотреть, нажав на кнопку посмотреть, кнопка опубликовать предназначена для публикации экранной формы в список опубликованных экранных форм для дальнейшего использования в конструкторе процессов. 

Вторая экранная форма

Необходимо создать экранную форму, например с наименованием "Результат распознавания паспорта" через кнопку "Создать экранную форму". Экранная форма будет предназначена для результатов распознавания.  

Для экранной формы потребуется выбрать и перетащить в центральную область элементы "Блок с текстом", "Кнопка", а также "Текстовое поле" и "Изображение" которые будут располагаться внутри элемента "Колонки".

Пользователь располагает в центральной области элемент "Блок с текстом". Вводит текст до 500 символов, например, "Разворот паспорта". В настройках шрифта выбирает жирный курсив 16 размер, положение текста по левому боку.  

Под элементом "Блок с текстом" располагаем элемент "Колонки", потребуется 2 колонки. Для первой колонки пользователь выбирает размер колонки 70%, выбирает чек-бокс "обводка", стиль линии "Сплошная" и ширину 1 пиксель. Во второй колонке размер колонки 30%, стиль линии "Сплошная" и ширина 1 пиксель.

Внутри первой колонки будут располагаться распознанные данные со 2 и 3 страницы паспорта в элементах "Текстовое поле", такие как: "Имя", "Фамилия", "Отчество", "Номер паспорта", "Дата выдачи", "Дата рождения", "Код подразделения", "Кем выдан".

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

Свойства для элемента "Текстовое поле".

В свойстве "Имя переменной" пользователь указывает наименование переменной, например, "Имя", пишет в строку "Название", аналогично, "Имя", также выбирает "Тип" для переменной "Строка", также имеется свойство "Подсказка" (что отображается внутри текстового поля), например, "Введите имя".

В свойстве "Положение названия" пользователь выбирает радиокнопку "Слева". Ширину у поля "Название" пользователь указывает 50%, "Количество отображаемых строк" пользователь выбирает одну строку. "Свойство поля" указывает редактируемое для того, чтобы в случае неверного распознавания имелась возможность текст отредактировать.

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

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

Свойства для элемента "Изображение".

В свойстве "Имя переменной" пользователь указывает, например, "Разворот паспорта" и устанавливает ширину 300 и высоту изображения, например, 500. 

Ниже элемента "Колонки" расположим элемент "Блок с текстом" с названием "Прописка", свойства заполняются аналогично блоку с названием "Разворот паспорта".  

Далее пользователь располагает внутри элемента "Колонки", элементы "Текстовые поля" с наименованиями "Дата регистрации", "Код подразделения", "Полный адрес", а во второй колонке располагается элемент "Изображение" с фотографией распознанной прописки.

Элементы "Колонки", "Текстовое поле" и "Изображение" заполняются аналогично развороту паспорта. Кроме поля "Полный адрес", в этом элементе будет отличаться параметр "Количество отображаемых строк" их будет 4 и элемент "Изображение" будет иметь размеры в ширину 550 и в высоту 300.

Для элемента "Кнопка" необходимо заполнить "Название", например "Подтвердить". В поле "Тип" пользователь указывает цвет "Зеленый". Убеждается, что параметр "Кнопка при подтверждении" проставлен, иначе кнопка не будет активной и пользователь прописывает наименование кнопки с текстом "Подтвердить".

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

Экранная форма для скачивания отчета

Пользователь создает экранную форму "Отчет по распознаванию" через кнопку "Создать экранную форму". Экранная форма будет предназначена для скачивания распознанных данных в виде отчета в формате excel.  

Для экранной формы потребуется выбрать и перетащить в центральную область элементы "Ссылка" и "Кнопка".

В элементе "Ссылка". Пользователь вводит имя переменной, например, "Ссылка", а параметре "Текст ссылки" пользователь вводит, например, "Скачать отчет по распознаванию паспорта". 

А для элемента "Кнопка" необходимо заполнить "Название", например "Готово". В поле "Тип" цвет кнопки пользователь оставляет по умолчанию. Убеждается, что свойство "Кнопка при подтверждении" проставлено и пользователь прописывает наименование кнопки с текстом "Готово".

Таким образом, собрана последняя экранная форма. Пользователь опубликовывает ее для дальнейшего использования в конструкторе процессов. 

Создание проекта процесса

Пользователь располагает в "Редакторе схемы процесса" в центральной части 2 блока "Робот", 3 блока "Экранных форм" и блок "Финиш".

Пользователь располагает блок "Экранная форма" под блоком "Старт" и объединяет блоки с помощью коннектора (стрелки), нажимает на блок "Экранная форма" и выбирает для нее экранную форму с помощью кнопки "Выбрать экранную форму".

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

Параметры блока "Экранная форма".

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

Далее пользователь располагает блок "Робот" под блоком "Экранная форма", аналогично объединяет блоки.  Робота необходимо заранее собрать в студии версии Enterprise и опубликовать в хранилище.  После публикации робот отобразится в хранилище и будет доступен для использования в ROBIN Process.

Пользователь нажимает на блок "Робот" и нажимает на кнопку "Выбрать робота". При отображении модального выбирает из списка необходимого робота и прожимаем кнопку "Выбрать".

Робот прикрепился к блоку.

Параметры блока "Робот". "Имя робота" и "Описание робота" заполняется автоматически, данные для входных параметров получаем из спецификации робота, описание по желанию можно изменить. Так же можно выбрать цвет блока и необходимо указать входные параметры робота. Для этого необходимо нажать на пустое поле, после отобразится выпадающий список, из которого нужно выбрать входные параметры (идентификаторы фото), которые передались из блока "Экранная форма". Выходными параметрами робота будут распознанные данные с фотографии паспорта.

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

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

Далее пользователь располагает еще один блок "Робот" под блоком "Экранная форма" и аналогично объединяет блоки, нажимает на блок "Робот" и выбирает робота с наименованием "Отчет по распознаванию excel".

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

Последний блок "Экранная форма" располагается также под блоком "Робот", пользователь объединяет блоки, нажимает на блок "Экранная форма" и выбирает экранную форму с наименованием "Отчет по распознаванию".

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

Таким образом, собран кейс с наименованием "Распознавание паспорта" и можно запустить и посмотреть отработку с помощью кнопки "Старт".

Запуск процесса через кнопку "Старт"

Запустим процесс. Для этого пользователь нажимает на кнопку "Старт"  , в модальном окне выбирает машину и учетную запись для запуска проекта, например, win10-msdn\admin и запускает процесс.

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

Нажмем на блок "Экранная форма" с наименованием "Прикрепить паспорт", справа отобразятся свойства с кнопкой "Заполнить форму". пользователь нажимает на кнопку и ему отображается модальное окно с экранной формой.

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

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

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

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

В блоке "Экранная форма" с наименованием "Результаты распознавания паспорта" аналогично нужно заполнить форму, с помощью кнопки "Заполнить форму", в результате пользователь увидит экранную форму с распознанными данными и фотографией, при необходимости пользователь данные может отредактировать. Далее нажимаем кнопку "Подтвердить" и данные отправляются в следующий блок "Робот" для формирования отчета.

В блоке "Робот" сформировался отчет в виде excel файла на ранее выбранную машину и сформировал ссылку на скачивание отчета.

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

Кнопка опубликовать  предназначена для публикации процесса. Публикуем процесс, и он будет находиться во вкладке "Опубликованные процессы". Также имеется возможность запустить кейс через раздел "Активности" и "Ассистент".

Примечания

Предварительно в студии в схему робота необходимо добавить действия, для корректной отработки элемента "Загрузить вложение".

Схема будет выглядеть следующим образом:

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

Также предварительно пользователь создает переменную, где будет храниться адрес сервера.

По каждому идентификатору в цикле производятся следующие действия:

С помощью действия "Формируем ссылку на скачивание" робот объединяет идентификатор и адрес сервера для отправки rest запроса в дальнейшем. Пример ссылки: https://prod-robin-platform.rpa-robin.site:8008/files/080f114f-19dc-4cc9-ac99-c63ef5fc341c

Далее создаем числовую переменную и конвертируем ее в строковый тип, с помощью действия "Конвертировать данные".

В действии "Создать наименование файла" объединяем наименование фотографии. Пример наименования: разворот_1.png.

Примечание: Число в наименование будет меняться, если фотографий несколько. Пример: разворот_2.png.

Далее отправляется запрос на сервер для скачивания файла, с помощью действия "Отправить запрос на скачивание".

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

Пример заполнения параметров:

Для того, чтобы числа в наименовании менялись, необходимо увеличивать значение счетчика с помощью действия "Счетчик для наименования" на единицу.

Далее соединяем путь до скаченного файла с помощью параметров в действии "Соединить путь к скаченному файлу":

Приводим его к типу "Путь к файлу" с помощью действия "Конвертировать путь к скаченному файлу".

Далее пользователь может использовать скаченные фотографии в схеме робота.

Элемент "Ссылка"

Для элемента "Ссылка" в студии в схему робота необходимо добавить действия:

1) Отправляем запрос на сервер, действие "Отправить запрос" необходимо обернуть в try catch, так как результат действие упадет с ошибкой.

Заполненные параметры для действия "Отправить запрос":

2) Описание ошибки конвертируется в строковый тип.

3) Далее из описания ошибки робот достает идентификатор, с помощью регулярного выражения. Результатом действия "Извлечь по шаблону" будет идентификатор, который находится в коллекции.

4) Идентификатор из коллекции необходимо достать с помощью действия "Получить значение по индексу".

5) Предварительно создаем пустую переменную "link". 

6) С помощью действия "Формируем ссылку на скачивание" робот объединяет идентификатор и адрес сервера, результат записывается в переменную "link". Пример ссылки: https://prod-robin-platform.rpa-robin.site:8008/files/080f114f-19dc-4cc9-ac99-c63ef5fc341c