β”‚ Grooper Help - Version 25.0
25.0.0017 2,127
  • Overview
  • Help Status

Separate

Code Activity Grooper.Activities

Separates a sequence of loose pages into documents.

Remarks

The Separation activity splits a sequence of loose Batch Pages into individual documents or folders, according to configurable separation logic.

Overview

  • Applies separation to all pages that are immediate children of the folder being processed.
  • To separate loose pages in the root of a Batch, run this activity at the batch level.
  • To separate loose pages inside a subfolder, run the activity at the level of the folders containing those pages.

Separation Logic

Workflow Placement

  • Typically runs after Recognize, to ensure all pages have text and layout information available for separation logic.
  • Often precedes a Review step configured with a Separation View, allowing a human operator to review and correct separation results.
  • In review workflows, set the 'Bind Only' property to true to save separation data without applying it, so the review operator can finalize separation.
  • If review is not required, set 'Bind Only' to false and proceed directly to Extract or other downstream activities.

Configuration Guidance

  • Use the 'Provider' property to select and configure a Separation Provider for custom logic.
  • Use the 'Separation Profile' property to apply a shared, reusable separation configuration.
  • Only one of these properties should be set at a time; the UI will hide the other when one is selected.
  • If neither is set, the activity will report a configuration error.

Example Scenarios

  • Batch-level separation: Run at the batch root to split all loose pages into documents using a global Separation Profile. The following diagram shows a batch with 10 loose pages before and after batch-level separation:

    Before Separation

    Batch
     β”œβ”€πŸ“„ Page 1
     β”œβ”€πŸ“„ Page 2
     β”œβ”€πŸ“„ Page 3
     β”œβ”€πŸ“„ Page 4
     β”œβ”€πŸ“„ Page 5
     β”œβ”€πŸ“„ Page 6
     β”œβ”€πŸ“„ Page 7
     β”œβ”€πŸ“„ Page 8
     β”œβ”€πŸ“„ Page 9
     β””β”€πŸ“„ Page 10
    

    After Separation

    Batch
     β”œβ”€πŸ“ Document 1
     β”‚ β”œβ”€πŸ“„ Page 1
     β”‚ β””β”€πŸ“„ Page 2
     β”œβ”€πŸ“ Document 2
     β”‚ β”œβ”€πŸ“„ Page 3
     β”‚ β”œβ”€πŸ“„ Page 4
     β”‚ β””β”€πŸ“„ Page 5
     β”œβ”€πŸ“ Document 3
     β”‚ β”œβ”€πŸ“„ Page 6
     β”‚ β””β”€πŸ“„ Page 7
     β””β”€πŸ“ Document 4
       β”œβ”€πŸ“„ Page 8
       β”œβ”€πŸ“„ Page 9
       β””β”€πŸ“„ Page 10
    
  • Folder-level separation (level 1): Run at the first folder level to separate loose pages within each folder. This is useful when batches are organized into folders (e.g., by source or import) and separation should occur within each folder.

    Before Separation

    Batch
     β”œβ”€πŸ“ Folder A
     β”‚ β”œβ”€πŸ“„ Page 1
     β”‚ β”œβ”€πŸ“„ Page 2
     β”‚ β”œβ”€πŸ“„ Page 3
     β”œβ”€πŸ“ Folder B
     β”‚ β”œβ”€πŸ“„ Page 4
     β”‚ β”œβ”€πŸ“„ Page 5
     β”‚ β”œβ”€πŸ“„ Page 6
    

    After Separation

    Batch
     β”œβ”€πŸ“ Folder A
     β”‚ β”œβ”€πŸ“ Document 1
     β”‚ β”‚ β”œβ”€πŸ“„ Page 1
     β”‚ β”‚ β””β”€πŸ“„ Page 2
     β”‚ β””β”€πŸ“ Document 2
     β”‚   β””β”€πŸ“„ Page 3
     β”œβ”€πŸ“ Folder B
     β”‚ β”œβ”€πŸ“ Document 1
     β”‚ β”‚ β”œβ”€πŸ“„ Page 4
     β”‚ β”‚ β””β”€πŸ“„ Page 5
     β”‚ β””β”€πŸ“ Document 2
     β”‚   β””β”€πŸ“„ Page 6
    
  • Separation with review: Configure 'Bind Only' to true so a reviewer can adjust separation before documents are finalized.

  • Automated separation: Configure 'Bind Only' to false to automatically split and classify documents without human intervention.

Additional Notes

Properties

NameTypeDescription
General
Processing Options

See Also

Used By

Notification