Separation Behavior

Defines document separation options and logic for a Content Type, enabling configuration of how documents are identified and split during processing.

Remarks

The SeparationBehavior class provides settings that control how Grooper determines the boundaries between documents within a batch. By assigning a Separation Behavior to a Content Type, you can influence how the system recognizes the start of new documents and applies classification logic.

First Page Verification

• The 'First Page Multiplier' property allows you to specify a Value Extractor that is used to verify whether a page is a valid starting point for a document.
• If the extractor finds no matches on a page, that page is excluded as a possible first page.
• If matches are found, the confidence score of the first match is used as a multiplier to adjust the page's classification score, improving the accuracy of document separation.

Typical Usage

• Use Separation Behavior to fine-tune document separation in scenarios where the first page of a document can be reliably identified by specific patterns, keywords, or features.
• Common use cases include separating multi-page scanned documents, mailroom batches, or forms where the first page has a unique header or identifier.

Configuration Guidance

• Assign a Value Extractor to 'First Page Multiplier' to define the criteria for recognizing the first page of a document.
• Adjust the extractor logic to match the unique characteristics of your document types for optimal separation performance.

Related Concepts

• Content Type: The document type to which this behavior is applied.
• Value Extractor: Used to identify and score potential first pages.
• Batch Folder: The container where separated documents are created during processing.

For best results, configure the separation logic to match the structure and variability of your incoming documents, ensuring reliable and accurate document boundaries.

Properties

Name	Type		Description
Content Type	Content Type	►	The content type to which this behavior is bound. EditorContent Type Editor
First Page Multiplier	Value Extractor	►	Specifies the Value Extractor used to verify whether a page qualifies as the first page of a document during separation. EditorEditor ConverterConverter 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 'First Page Multiplier' property allows you to assign a Value Extractor that evaluates each candidate first page in a batch. This extractor searches for specific patterns, keywords, or features that indicate a valid document start. If the extractor finds no matches on a page, that page is excluded as a possible first page. If matches are found, the confidence score of the first match is used as a multiplier to adjust the page's classification score, increasing the accuracy of document separation. Typical Usage Use this property to improve separation reliability when the first page of a document can be identified by unique content, such as a header, form title, or barcode. Adjust the extractor logic to match the characteristics of your documents for optimal results. Related Concepts Value Extractor: The object used to identify and score potential first pages. Separation Behavior: The behavior that controls document boundary detection in a Content Type. For best results, configure the extractor to target features that are consistently present on the first page of your document types.

See Also

Value ExtractorContent CategoryContent ModelDocument TypeForm TypePage Type