Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

Получить статус

...

распознавания Версия 1 (Net)

Группа действий: Робин OCR Подгруппа Soica

...

Описание

Действие получает из сервиса SOICA статус распознавания отправленных документов, а также ID пакетов, готовых к экспорту.

Под статусом отправленных документов подразумеваются  выходные параметры: поле "ID готовых документов" с коллекцией с номерами документов, которые находятся в статусе "export" в текущий момент, и поле "Таблица со статусами" – таблица с информацией обо всоех пакетах документов, подходящих по запрашиваемым параметрам

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

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

Статусы:

  • import – импорт => ждать смены статуса для возможности дальнейшей обработки;
  • recognize – распознавание =>ждать смены статуса;
  • validation – валидация=> вручную менять статус;
  • export – экспорт =>можно запускать действие "Получить результат распознавания";
  • deleted - пакет был удален =>ждать смены статуса;
  • inaccessible - пакет недоступен =>ждать смены статуса;
  • quality control - тут может зависнуть файл, если пользователь отправил по неправильному сценарию, надо идти вручную проверять.

Общие принципы работы с Soica  указаны в действии "Распознать".

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

Image Modified

Параметры

...

их настройка

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

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

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

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

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

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

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

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

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

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

Настройки параметров 

Свойство

Описание

Тип

Пример заполненияОбязательность заполнения поляПримечание
Входные параметры

URL

Ссылка для аутентификации на аутентификации в сервисе SOICA (RestAPI)Robin.String  http://localhost/administratorДа
Логин

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

Robin.String adminДа
ПарольПароль для входаRobin.Password adminДа
Начальная датаДата, начиная с которой документы были отправлены на распознавание. Если поле не заполнено, начальной датой будет дата отправки на сервер самого первого документаRobin.DateTime
Нет

Если обе даты заполнены, то в таблице будут указаны документы внутри диапазона дат

Если "Дата До" указана раньше, чем "Дата От", то в таблице будут указаны документы внутри диапазона дат. Не будет ошибки

Если заполнена только "Начальная дата" – документы от указанной даты до текущей

Если заполнена только "Конечная дата" – документы с первого использования сервера до указанной даты

Конечная датаДата, до которой документы были отправлены на распознавание. Если поле не заполнено, конечной датой будет текущая датаRobin.DateTime
Нет
Тайм-аут, мсВремя в миллисекундах, в течение которого действие будет ожидать ответ от сервиса SOICARobin.Numeric
Нет

Если не заполнен, то стандартный тайм-аут от httpClient в С# 100 секунд= 100 000 мс

Если тайм-аут закончился раньше, чем получены результаты, то вернутся пустые результаты

Результаты

ID готовых документов

Коллекция идентификационных номеров пакетов документов, которые  которые готовы к экспорту

Robin.Collection


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

Состоит из столбцов:

  • ID
  • Название документа
  • Класс документа
  • Статус
  • Описание ошибки

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

Нужно заранее получить данные для аутентификации в сервисе Сойки.

Действие выдаст:

  • ошибка 403 "Неверный логин или пароль подключения", если задан неверный логин или пароль подключения;
  • ошибка 404 "Неверный адрес для аутентификации на сервере", если неверно указан путь или ссылка.

Общие принципы работы  SOICA можно посмотреть тут: Общий принцип работы SOIСA

Статусы:

  • import – импорт => ждать смены статуса для возможности дальнейшей обработки;
  • recognize – распознавание =>ждать смены статуса;
  • validation – валидация=> вручную менять статус;
  • export – экспорт =>можно запускать действие "Получить результат распознавания";
  • deleted - пакет был удален =>ждать смены статуса;
  • inaccessible - пакет недоступен =>ждать смены статуса;
  • quality control - тут может зависнуть файл, если пользователь отправил по неправильному сценарию, надо идти вручную проверять.

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

Задача

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

Решение

Использовать действия "Отправить на распознавание", "Получить статус распознавания", "Сохранить таблицу в CSV".

Реализация

  1. Последовательно установить действия "Отправить на распознавание", "Получить статус распознавания" и "Сохранить таблицу в CSV" на  на рабочую область.

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

    1. параметры действия  «Отправить на распознавание»; 
      Image Modified

    2. параметры действия  "Получить статус распознавания"

    3. параметры действия  "Сохранить таблицу в CSV"

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

...

Результат

Робот отработал успешно.
Image Added

Робот вернет CSV файл со статусами распознавания.