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

Ключ

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

Получить статус распознавания Версия 1 (Net)

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

...

Описание

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

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

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

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

Действие отправляет файл на распознавание в сервис Робин OCR с Сойкой, а также ID пакетов, готовых к экспорту.

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

Image Removed

Параметры

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

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

Логин                          Логин для входа в систему Сойки

Пароль                       Пароль для входа в систему Сойки

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

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

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

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

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

Таблица со статусами          Таблица, в которой указываются данные о документах, отправленных на распознавание в указанный диапазон времени.

Настройки 

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 Added

Реализация

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

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

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

...

    1. Image Added

...

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

...

    1. Image Added

...

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

...

    1. Image Added

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

Image Removed

...


Результат

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

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