История страницы

Распознать Версия 2 (NetNet)

...

Описание

Извлечение текста из файла с помощью сервиса Робин OCR с Сойкой

Image Removed

Параметры

Входные параметры

URL                                              Ссылка для аутентификации на сервисе Сойки

Логин                                          Логин для входа

Пароль                                        Пароль для входа

Класс пакета                               Класс пакета, которым будет обрабатываться сценарий

Файл                                            Путь к файлу, из которого необходимо извлечь текст. Поддерживаемые форматы изображений: JPEG, PDF, TIFF, BMP, PNG, DOCX, GIF

Тип результата                           Формат, в котором будут представлены результаты

Профиль распознавания           Профиль распознавания для получения результатов

Тайм-аут                                     Время в миллисекундах, в течение которого будет происходить работа действия

Выходные параметры

Результат                                    Коллекция json-объектов или xml-контекстов, содержащих распознанные данные. Если распознание документа еще в процессе, то результат не заполнен

Статус                                           Статус распознавания документа

Действие отправляет изображения в сервис SOICA и получает результаты распознавания

Иконка действия

Image Added

Параметры и их настройки

...

Свойство	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
URL	Ссылка для

аутентификации на

аутентификации в сервисе

Сойки

SOICA	Robin.String	http://localhost/administrator	Да
Логин	Логин для входа	Robin.String	admin	Да
Пароль	Пароль для входа	Robin.Password	admin	Да
Класс пакета	Класс пакета, которым будет обрабатываться сценарий	Robin.String.	Имя класса пакета	Да
Файл	Путь к файлу, из которого необходимо извлечь текст. Поддерживаемые форматы изображений:

JPEG

jpg,

PDF

pdf,

TIFF

tiff,

BMP

bmp,

PNG

png,

DOCX

docx,

GIF

gif	Robin.FilePath.	C:\Users\Документ\1.jpg	Да
Тип результата	Формат, в котором будут представлены результаты Выпадающий список из элементов: XML, JSON Значение по умолчанию: XML	Robin.String	JSON	Нет
Профиль распознавания	Профиль распознавания для получения результатов Профили создаются в самой

Сойке

SOICA и пользователь заранее знает, какой необходимо выбрать. Значение по умолчанию задается системой при создании класса пакетов и называется default	Robin.String	default	Нет
Тайм-аут, мс	Время в миллисекундах, в течение которого

будет происходить работа действия

действие будет ожидать ответ от сервиса SOICA	Robin.Numeric	1000000	Нет
Результаты
Результат	Коллекция json-объектов или xml-контекстов, содержащих

распознанные данные

распознанные данные. Если

распознание документа еще в процессе, то результат не заполнен

истек указанный тайм-аут, а сервис не закончил распознавание, этот параметр вернется пустым	Robin.Collection
Статус	Статус распознавания документа	Robin.String

Особые условия использования

Робот вернет ошибку, если:

1. неверно указан путь, ссылка - 404

2. неверный логин или пароль подключения. 403

3. выбранный сценарий обработки не подходит. 401

4. внутренняя ошибка сервера -500.

5. личные данные и ID документа не принадлежат одному пользователю.

Пример использования

Задача: распознать текст на документе.

Решение: использовать действие "Распознать". 

Image Removed

Реализация:

1. Установить действие "Распознать" на рабочую область.

2. Заполнить параметры действия корректными данными. 

   Image Removed

3. Запустить робота по кнопке "Старт" в верхней панели. 
   Image Removed

Результат: Робот вернул обработанные файлы. Результат представлен в виде коллекции с  json-объектами или xml-контекстами. Статус "export".

Image Removed

Общие принципы работы с ROBIN OCR

...

1. Для отправки документа на распознавание нужно выполнить минимум 2 запроса. Сначала  отправляется запрос на создание пакета, в запрос передается единственное изображение пакета или первое. Запрос возвращает GUID пакета. Если изображений в пакете должно быть несколько, то в последующих запросах эти изображения добавляются к пакету (по одному). Завершающим запросом надо запустить пакет на обработку. Во второй и последующие запросы передается GUID созданного пакета.

2. Формат результата настраивается заранее, в сценарии.

3. Пользователь будет получать результат в виде коллекции json-объектов или xml-контекстов. С полученными результатами можно работать действиями студии.

4. Список классов пакета пользователь должен знать перед запуском действия.

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

6. Когда робот будет завершать работу с ошибкой, в тексте ошибки будет отображаться причина. 

7. Если статус документа не "export", то робот не сможет получить результат и пропустит документ. Пользователь сам должен будет передвинуть документ в статус "экспорт" на сервере. Нужно провести валидацию файла вручную и отправить его на экспорт, путем внесения и принятия изменений в нем.

8. Статусы: 

   1. import –

...

1. 1. импорт =

...

1. 1. > ждать смены статуса;
   2. recognize –

...

1. 1. распознавание =>ждать смены статуса;
   2. validation – валидация=

...

1. 1. > вручную менять статус в системе Сойки;
   2. export –

...

1. 1. экспорт => готово к выгрузке, можно запускать действие "Получить статус распознавания";
   2. deleted - пакет был

...

1. 1. удален, ждать смены статуса;
   2. inaccessible - пакет недоступен, ждать смены статуса;
   3. quality control -  если пользователь отправил по неправильному сценарию, вручную менять статус в системе Сойки.
2. Если таймаут истекает до того как получим распознанный текст будет получен пустой результат, действие не завершается с ошибкой.
   

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

• rest-сервис экспорта отвечает за получение результата;
• json или xml результат будет. Это настраивается внутри сценария обработки пакета в Сойке;
• В действии надо вернуть не строку, а  json-объект или сразу xml-контекст. Xml контекст нужно закрывать, Json не надо;
• Документ предварительно должен быть выгружен модулем экспорта;
• Действие должно ожидать пока статус документа станет "export". Тогда только запускать получение результата.

Пример использования