Секция Packers предназначена для настройки модуля упаковки.
В секции BasePacker перечислены все подокументные модули упаковки. В секции ImagePacker перечислены все модули упаковки изображений, которые позволяют работать только с изображениями страниц документов. Модули упаковки изображений рекомендуется использовать при поточном вводе, если в каталог ввода поступают только файлы изображений. В остальных случаях рекомендуется использовать подокументные модули упаковки.
Структура секции:
<Packers>
<BasePacker Type="NpoComputer.Dcts.Capture.Packers.
StandardPackers.BasePacker.BasePackerFactory">
<clear/>
<add Name="{Имя модуля}"/>
</BasePacker>
<ImagePacker Type="NpoComputer.Dcts.Capture.Packers.StandardPackers.
ImagePacker.ImagePackerFactory">
<clear/>
{Модуль упаковки}
</ImagePacker>
</Packers>
где {Модуль упаковки}::=
<add Name="{Имя модуля упаковки}"
PackageUnit="{Единица упаковки}"
CompressionMethod="{Метод сжатия изображений}"
Color="{Глубина цвета}"
DeleteBlankPages="{Удалять пустые страницы}"
ThresholdForBlank="{Порог пустой страницы}">
<Triggers>
<clear/>
{Триггер}
…
</Triggers>
</add>
где {Триггер}::=
<add
Name="{Имя триггера}"
TriggerType="{Тип триггера}"
Action="{Обработка страницы-разделителя}"
Number="{Количество единиц упаковки}"
ThresholdForBlank="{Порог пустой страницы}"
BarcodeType="{Типы штрихкодов}"
BarcodeMask="{Маска штрихкода}"
BarcodeRegularExpression="{Регулярное выражение маски штрихкода}"
BarcodeColor="{Глубина цвета}"
BarcodeMaxResolution="{Разрешение изображения}"
IntervalValue="{Время ожидания единицы упаковки}"/>
add – настройки модуля упаковки:
• | Name. Уникальное имя модуля упаковки. Для подокументной обработки укажите значение BasePacker, для поточной – FileSystemStreamPacker. |
• | PackageUnit. Единица упаковки – минимальный объем данных, на который разделяется поток: |
• | CaptureInstance – поток делится на экземпляры захвата, которые могут включать в себя несколько страниц или файлов; |
• | Page – поток делится на страницы; |
• | File – поток делится на файлы. |
• | CompressionMethod. Метод сжатия изображений. Возможные значения: None, PackBits, Deflate, AdobeDeflate, Ccitt3, Ccitt4, Lzw и Jpeg. Методы сжатия Ccitt3, Ccitt4 используются только при черно-белой глубине цвета, а Jpeg не поддерживается при черно-белой глубине цвета. Параметр является необязательным. Значение по умолчанию None. |
• | Color. Глубина цвета, с которой преобразовывается исходное изображение. Если глубина цвета исходного изображения ниже выбранной, то преобразование не выполняется. Возможные значения: |
• | Monochrome – 1 бит (черно-белый); |
• | GrayScale4Bits – 4 бита (оттенки серого); |
• | GrayScale8Bits – 8 бит (оттенки серого); |
• | Color24Bits – 24 бита (цветной); |
• | Color32Bits – 32 бита (цветной). |
Параметр является необязательным. Значение по умолчанию Default.
• | DeleteBlankPages. Признак удаления пустых страниц. Выполняется после срабатывания всех триггеров. Если параметр установлен и при этом используется триггер BlankPage, настроенный на удаление единиц упаковки, возникает конфликт. Упаковщик не сможет удалять только пустые страницы из потока. Пустые страницы будут удалены в составе единиц упаковки. При обнаружении конфликта в журнал событий записывается предупреждение: «Конфликт настройки «DeleteBlankPages» упаковщика <Название упаковщика> и настроек триггера <Название триггера>». Значение по умолчанию False. |
• | ThresholdForBlank. Порог пустой страницы. Определяет, является ли данная страница пустой. Укажите целое число больше или равное 0. Чем больше порог, тем ниже чувствительность и выше вероятность, что страница будет определена как пустая. Значение параметра следует подбирать опытным путем. |
Triggers – настройки триггера.
add – добавление триггера:
• | Name. Уникальное имя триггера. |
• | TriggerType. Тип триггера. Определяет способ разделения потока страниц на документы. Возможные значения: |
• | NewCaptureInstance. Разделение по экземпляру захвата. Формируется новый пакет, когда обнаружена единица упаковки, принадлежащая новому экземпляру захвата. Экземпляры захвата отличаются идентификаторами; |
• | Barcode. Разделение по штрихкоду. Формируется новый пакет, когда в единице упаковки обнаружен штрихкод определенного типа и содержания. Вместе с этим типом триггера могут быть указаны параметры BarcodeType, BarcodeMask, BarcodeRegularExpression, BarcodeColor и BarcodeMaxResolution; |
• | BlankPage. Разделение по пустой странице. Формируется новый пакет, когда в единице упаковки обнаружена пустая страница. Вместе с этим типом триггера должен быть указан параметр ThresholdForBlank; |
• | PackageUnitNumber. Разделение по количеству единиц упаковки. Формируется новый пакет, когда количество обработанных единиц упаковки достигает заданного значения. Вместе с этим типом триггера должен быть указан параметр Number; |
• | Timeout. Разделение по тайм-ауту. Формируется новый пакет, если на вход упаковщика в течение указанного времени не поступают единицы упаковки. Значение задается в формате <[дни.]чч:мм:сс>. |
Каждый поточный модуль упаковки может иметь несколько триггеров одного типа. Например, когда в потоке документов встречаются документы со штрихкодом на первой странице документа и на странице-разделителе, удобно настроить два разных триггера с разделением по штрихкоду.
• | Action. Обработка страницы-разделителя. Выберите необходимое действие со страницей, на которой сработал триггер. Страницей-разделителем называется страница, на которой сработал триггер модуля упаковки. Используется для триггеров Barcode и BlankPage. Например, если используем триггер Barcode, то страницей-разделителем будет страница со штрихкодом указанного типа и содержания. Возможные значения: |
• | AddToCurrentDocument. Страница-разделитель добавляется к текущему документу. Следующая за ней страница будет считаться началом нового документа; |
• | AddToNextDocument. Страница-разделитель считается началом нового документа; |
• | Delete. Страница-разделитель считается не относящейся ни к одному документу и удаляется. Использование этого значения параметра имеет смысл для пустых страниц. |
• | Number. Количество единиц упаковки. Используется для разделения документов фиксированной длины. Используется для триггера PackageUnitNumber. |
• | ThresholdForBlank. Порог пустой страницы. Определяет, является ли данная страница пустой. Укажите целое число больше или равное 0. Чем больше порог, тем ниже чувствительность и выше вероятность, что страница будет определена как пустая. Значение параметра следует подбирать опытным путем. |
• | BarcodeType. Типы распознаваемых штрихкодов, указываются через «,». Используется для триггера Barcode. Возможные значения: Add2, Add5, AustraliaPost, Codabar, Code11, Code39, Code39Extended, Code93, Code128, DataMatrix, EAN13, EAN8, IntelligentMail, Inter2of5, MicroQRCode, Patch, PDF417, PharmaCode, Planet, PostNet, QRCode, RM4SCC, UPCA, UPCE. Если значение не указано, то распознаются все допустимые типы штрихкодов. Параметр не является обязательным. По умолчанию принимает пустое значение. Подробнее см. раздел «Типы штрихкодов». |
• | BarcodeMask. Маска содержания штрихкода, по которому захватываемые данные разделяются на документы. Маска штрихкода может содержать спецсимволы «*» и «?». Указываются через «;». Например, для штрихкодов системы DIRECTUM может быть указана маска «DIRECTUM-*-*». |
• | BarcodeRegularExpression. Регулярное выражение маски штрихкода. Используется для триггера Barcode. Укажите строку-константу или регулярное выражение для формирования штрихкода, например, для штрихкодов системы DIRECTUM может быть указана маска ^DIRECTUM-(\\d+)-(\\d+)$. Полный синтаксис регулярных выражений Microsoft подробнее см. в документации Microsoft. Параметр является не обязательным. По умолчанию принимает пустое значение, т.е. обрабатываются все штрихкоды. |
• | BarcodeColor. Глубина цвета, с которой преобразовывается исходное изображение. Если глубина цвета исходного изображения ниже выбранной, то преобразование не выполняется. Используется для триггера Barcode. Возможные значения: |
• | Monochrome – 1 бит (черно-белый); |
• | GrayScale4Bits – 4 бита (оттенки серого); |
• | GrayScale8Bits – 8 бит (оттенки серого); |
• | Color24Bits – 24 бита (цветной); |
• | Color32Bits – 32 бита (цветной). |
Параметр не является обязательным. По умолчанию изображение преобразуется к глубине GrayScale4Bits. При задании параметра необходимо учитывать, что в изображении с большей глубиной цвета поиск штрихкода будет выполняться дольше, но при этом вероятность ошибки распознавания меньше. Оптимальными являются значения GrayScale4Bits и GrayScale8Bits.
• | BarcodeMaxResolution. Максимальное разрешение изображения. Используется для триггера Barcode. Укажите значение от 100 до 1200. Если разрешение изображения меньше указанного, то преобразование не будет выполняться. Значение параметра указывается в единицах измерения DPI (количество точек на дюйм). В качестве значения можно указывать любое целое число, большее 0. Параметр является не обязательным. По умолчанию используется разрешение 400 DPI. При задании параметра необходимо учитывать, что при большом разрешении распознавание штрихкода будет выполняться дольше. |
• | IntervalValue. Время ожидания следующей единицы упаковки в формате <[дни.]чч:мм:сс>. Используется для триггера Timeout. По истечении указанного времени формируется новый пакет. |
Пример
<Packers>
<BasePacker Type="NpoComputer.Dcts.Capture.Packers.StandardPackers.
BasePacker.BasePackerFactory">
<clear />
<add Name="BasePacker"/>
</BasePacker>
<ImagePacker Type="NpoComputer.Dcts.Capture.Packers.StandardPackers.
ImagePacker.ImagePackerFactory">
<clear />
<add Name="FileSystemStreamPacker"
PackageUnit="Page"
CompressionMethod="Ccitt4"
Color="Default"
DeleteBlankPages="True"
ThresholdForBlank="100">
<Triggers>
<clear />
<add Name="Новый экземпляр захвата"
TriggerType="NewCaptureInstance"/>
<add Name="Количество единиц упаковки"
TriggerType="PackageUnitNumber"
Number="10" />
<add Name="Штрихкод"
TriggerType="Barcode"
Action="AddToNextDocument"
BarcodeType="Code128"
BarcodeMask="123;234;DIRECTUM*"
BarcodeColor="GrayScale4Bits"
BarcodeMaxResolution="400" />
<add Name="Тайм-аут"
TriggerType="Timeout"
IntervalValue="0.00:00:15"/>
</Triggers>
</add>
</ImagePacker>
</Packers>
|