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

Multi Separator

Separation Provider Grooper.Capture

Performs document separation using multiple Separation Providers in sequence.

Remarks

Overview

The Multi Separator class enables advanced separation workflows by applying a configurable list of Separation Providers to each Batch Page. Each provider is evaluated in order, allowing you to combine different separation strategies—such as pattern-based, control sheet, and event-based separation—within a single batch process.


Purpose and Role

  • Composite Separation:
    Allows you to chain multiple Separation Providers, each with its own logic, to handle complex or layered separation requirements.
  • Fallback and Priority:
    Providers are evaluated in order; if a provider does not assign a separation action to a page, the next provider is given a chance.
  • Flexible Configuration:
    Supports any combination of built-in or custom Separation Providers, making it easy to adapt to diverse document sets.

Usage Scenarios

  • Hybrid Separation:
    Combine Control Sheet Separation and Pattern-Based Separation to handle both explicit separator sheets and pattern-based cues in the same batch.
  • Layered Logic:
    Use a primary provider for the main separation logic, and secondary providers for exceptions or special cases.
  • Migration and Testing:
    Gradually introduce new separation logic by adding providers to the list without disrupting existing workflows.

Best Practices

  • Order providers from most specific to most general to ensure correct prioritization.
  • Test the combined logic on representative batches to verify that all intended separation points are detected.
  • Use comments or documentation to clarify the role of each provider in the sequence.

Properties

NameTypeDescription

Used By

Notification