OCR Layer

Defines a distinct layer of OCR extraction for the Layered OCR engine.

Remarks

Overview

An OCR Layer allows you to supplement or repair the main OCR output by running an additional OCR Profile and applying targeted extraction logic.

Each layer can:

• Run a different OCR Profile to target specialized print types or regions.
• Use an extractor to identify and merge specific values or corrections into the main OCR results.
• Optionally use an execution trigger to control when the layer is applied.

How It Works

• If the 'OCR Profile' is different from the main profile, a new OCR operation is performed and the extractor runs against its results.
• If the 'OCR Profile' matches the main profile, the extractor runs against the main OCR output.
• Any matches found by the extractor are merged into the main OCR results, enabling targeted repair or enhancement.

Configuration & Best Practices

• Use layers to address specific recognition challenges, such as handprint, MICR, or problematic field labels.
• Ensure the extractor meets all requirements for OCR repair (see 'Extractor' property for details).
• Use the execution trigger to limit processing to relevant documents or regions.
• Test each layer individually and review the log for errors or invalid matches.

Properties

Name	Type		Description
OCR Profile	OCR Profile	►	The OCR Profile to execute for this layer. EditorNode Reference Editor Requiredtrue If different from the main OCR Profile, a new OCR operation is performed and the extractor runs against its results. If the same as the main OCR Profile, the extractor runs against the main OCR output only. Use this to target specialized print types or to apply different recognition settings for specific regions or fields.
Extractor	Value Extractor	►	The extractor used to identify content to be merged into the main OCR output. EditorEditor ConverterConverter Requiredtrue Can be one of the following types: Value Description Reference Delegates extraction to another configured extractor, enabling reuse and centralization of extraction logic. AI Column Extractor Extracts structured content from documents with two-column layouts. Ask AI Executes a completion using a large language model (LLM) and returns one hit for each choice in the response. Detect Signature Detects a signature within a specified region of a document page by measuring the percentage of the area that is filled. Entity Recognition Identifies and categorizes entities such as people, organizations, locations, and quantities in unstructured text. Field Match Matches the value stored in a previously-extracted field or table column. Find Barcode Searches for barcode values in document Layout Data previously detected during image processing. Highlight Zone Defines a region of a document to be visually highlighted, without extracting any data values. Key Phrase Extraction Identifies key concepts and topics in text using Azure AI Language key phrase extraction. Label Match Matches a list of one or more label values, using matching options defined by a Labeling Behavior. Labeled OMR Reads a group of one or more checkboxes located nearby text labels. Labeled Value Extracts a field presented as a label-value pair within a document, associating labels and values based on their spatial relationship. List Match Extracts values from document text that match any entry in a list of search terms. Ordered OMR Reads one or more checkboxes with a consistent order of appearance inside a rectangular region. Pattern Match Extracts values from document text that match a specified regular expression pattern. Pii Entity Recognition Identifies, categorizes, and redacts sensitive information (PII) in unstructured text using Azure AI Language Services. Query HTML Extracts values from an HTML document using a CSS or XPath selector. Query XML Extracts values from XML documents using XPATH queries, enabling structured data extraction from XML content in Grooper. Read Barcode Extracts barcode values from document images using configurable barcode recognition. Read Metadata Reads a metadata value from a document by accessing a property on an attachment or content link. Read Zone Extracts text content from a specified rectangular region (zone) of a document. Select Page Selects and outputs the full content of one or more pages from a document, based on page number and/or content criteria. Word Match Extracts individual words and multi-word phrases (N-grams) from document text for use in classification, data extraction, and normalization. Zonal OMR Reads one or more checkboxes using manually-configured zones. The extractor must meet special requirements to be valid for OCR repair: Each match must reference a contiguous sequence of characters within a single line of text. Only FuzzyRegEx and FuzzyList match modes are supported. To prevent matches across lines, configure Fuzzy Match Weightings to make line break characters immutable (e.g., Immutable=\\r\\n). Do not use fuzzy lookups, output formats, or lexicon translation to modify output values. Do not use any Collation Provider that produces non-contiguous output values. If the extractor does not meet these requirements, matches will be ignored and error messages will appear in the log.
Execution Trigger	Value Extractor	►	The extractor that determines whether this layer should be executed. EditorEditor ConverterType Selector Can be one of the following types: Value Description Field Match Matches the value stored in a previously-extracted field or table column. Detect Signature Detects a signature within a specified region of a document page by measuring the percentage of the area that is filled. Labeled Value Extracts a field presented as a label-value pair within a document, associating labels and values based on their spatial relationship. Label Match Matches a list of one or more label values, using matching options defined by a Labeling Behavior. Read Metadata Reads a metadata value from a document by accessing a property on an attachment or content link. Select Page Selects and outputs the full content of one or more pages from a document, based on page number and/or content criteria. Find Barcode Searches for barcode values in document Layout Data previously detected during image processing. Highlight Zone Defines a region of a document to be visually highlighted, without extracting any data values. Labeled OMR Reads a group of one or more checkboxes located nearby text labels. Ordered OMR Reads one or more checkboxes with a consistent order of appearance inside a rectangular region. Read Barcode Extracts barcode values from document images using configurable barcode recognition. Read Zone Extracts text content from a specified rectangular region (zone) of a document. Reference Delegates extraction to another configured extractor, enabling reuse and centralization of extraction logic. Zonal OMR Reads one or more checkboxes using manually-configured zones. List Match Extracts values from document text that match any entry in a list of search terms. Pattern Match Extracts values from document text that match a specified regular expression pattern. Word Match Extracts individual words and multi-word phrases (N-grams) from document text for use in classification, data extraction, and normalization. Query XML Extracts values from XML documents using XPATH queries, enabling structured data extraction from XML content in Grooper. Query HTML Extracts values from an HTML document using a CSS or XPath selector. Ask AI Executes a completion using a large language model (LLM) and returns one hit for each choice in the response. AI Column Extractor Extracts structured content from documents with two-column layouts. Entity Recognition Identifies and categorizes entities such as people, organizations, locations, and quantities in unstructured text. Key Phrase Extraction Identifies key concepts and topics in text using Azure AI Language key phrase extraction. Pii Entity Recognition Identifies, categorizes, and redacts sensitive information (PII) in unstructured text using Azure AI Language Services. If set, the layer will only run if the execution trigger finds at least one match in the main OCR results. Use this to limit processing to documents or regions where specific conditions are met.

See Also

OCR ProfileValue Extractor

Used By

Layered OCR