Значение поля пакета
Значение атрибута в пакете ввода: текущее и распознанное, с уверенностью и указанием кадра и области, откуда оно получено.
1. К чему привязано значение
Значение ссылается на атрибут вида документа обязательно, а на поле формы — только если атрибут на бланке напечатан. Место хранения поля формы не имеет: его неоткуда распознать, оно всегда вводится вручную. Ссылка на поле нужна для показа — подпись, порядок, подсветка фрагмента.
Отсюда следует, что отдельной сущности «идентификатор пакета» не нужно: шифр, инвентарный номер, место хранения и дата — обычные атрибуты вида документа, и их значения хранятся наравне с остальными.
Заполнил пользователь значение при формировании пакета или при проверке — разницы нет, это одно и то же значение одного и того же атрибута; различается только происхождение.
2. Два набора значений
У значения два набора: текущий и то, что вернула модель. Исправление пользователя не затирает распознанное.
Причина не в аудите. Пары «что модель прочла / что там на самом деле» и есть материал для дообучения, который Сервис накапливает попутно, разбирая архив. Если исправление затирает распознанное, материал теряется навсегда — и восстановить его неоткуда.
3. Источник значения
Источник — свойства самого значения: кадр и область, оба необязательные.
| Как получено | Кадр | Область |
|---|---|---|
| Распознано из клетки бланка | есть | есть |
| Отнесено к странице целиком | есть | нет |
| Введено пользователем вручную | нет | нет |
Отдельная сущность источника понадобилась бы, если бы одно значение собиралось из нескольких мест; на бланке такого не бывает.
Кадр указывает на снимок, а страница формы известна через сам кадр — он к ней отнесён. Поэтому переназначение кадра другой странице делает распознанные значения недействительными: они получены в предположении другой разметки.
4. Что происходит со значением дальше
Значение живёт в пакете и в карту как таковое не переходит. При создании карты значения становятся атрибутами документов карты, а уверенность, распознанный набор, кадр и область остаются в пакете: карта — документ о результатах обработки, а не о том, как прошло распознавание.
Свойства
| Свойство | Тип | Описание |
|---|---|---|
Id | Guid | Идентификатор значения. |
Values | IReadOnlyList<String> | Текущие значения: результат распознавания либо правка пользователя. |
RecognizedValues | IReadOnlyList<String> | Значения, которые вернула модель; сохраняются даже после правки. |
Confidence | Nullable<Double> | Уверенность распознавания, 0..1; null — значение не распознавалось. |
KindAttribute | DocumentKindAttribute | Атрибут вида документа, значение которого хранится. |
FormField | FormField | Поле формы, если атрибут напечатан на бланке; null — поле вводится вручную. |
Origin | ValueOrigin | Происхождение текущего значения: распознано или введено пользователем. |
ImageFrame | ImageFrame | Кадр, с которого получено значение; null — источника нет. |
Area | SourceArea | Область на кадре; null — значение отнесено к кадру целиком либо источника нет. |