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

Text Document - Insert Page Breaks

Text Document Command Grooper.Extract

Inserts page breaks into a text document based on a regular expression pattern.

Remarks

The InsertPageBreaks command scans a plain text file and inserts page break characters (\f) at locations matching a configurable pattern.

Overview

  • Detects locations for page breaks using a regular expression.
  • Supports inserting the break before or after the matched line.
  • Handles various text encodings and byte order marks (BOM).

Workflow

  1. Reads the text file line by line using the specified encoding and BOM settings.
  2. For each line:
    • If the line matches the configured pattern, inserts a page break before or after the line.
    • Otherwise, writes the line as-is.
  3. Saves the modified text back to the Batch Folder attachment.

Configuration

  • Use PageBreakPattern to define the regular expression for detecting page break locations.
  • Use InsertAfter to control whether the break is inserted before or after the matched line.
  • Set Encoding and DetectBOM for correct text interpretation.

Usage Notes

  • Useful for segmenting reports, statements, or other multi-record text files into logical pages.
  • Combine with downstream extraction or normalization commands for further processing.

Properties

NameTypeDescription
General
Encoding

See Also

Regular ExpressionText Document

Notification