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

Ключ

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

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

...

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

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

...

Описание

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

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

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

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

Статусы:

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

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

Действие отправляет файл на распознавание в сервис Робин OCR с Сойкой.

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

Image Removed

...

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

Image Added

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

Свойство

Описание

Тип

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

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".
Image Modified

Реализация

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

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

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

...

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

...

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

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

Image Removed

...

Результат

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

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