│ Grooper Help - Version 25.0
25.0.0024 2,166

Section Instance

Element Container Instance Grooper.Core

Represents the extracted content associated with a Data Section.

Remarks

The Section Instance class models a single occurrence of a Data Section within a document’s extracted data.
It serves as the primary container for grouping related fields, tables, and nested sections, supporting both single-instance and multi-instance (repeating) section structures.

Role in Grooper

Section Instances are created automatically during extraction, validation, or user entry, and are organized as children of Element Container Instances such as the document root or parent sections. The Section Extract Method assigned to a Data Section determines how the section instance is recognized and populated.

Section Instances are essential for representing logical groupings of data within a document, such as "Patient Information", "Claim Details", or "Line Items".
They support both simple and complex document schemas, including nested and repeating structures.

Usage and Configuration

  • Section Instances are managed by Grooper’s extraction engine and are not created or configured directly by end users.
  • They are visible in the Data Review UI, where users can review, validate, and edit grouped data elements within a section.
  • Advanced users may interact with Section Instances via expressions, custom code, or API integrations for automation, validation, or custom export scenarios.

Extraction, Validation, and Review

  • Section Instances are created and populated during the Extract activity, using the extraction logic defined in the Data Section.
  • Validation is performed automatically or on demand, using rules defined in the Data Section and the broader Data Model.
  • The Section Instance tracks validation status, error messages, and change tracking for all contained fields, tables, and nested sections.
  • In the Data Review UI, the Section Instance provides a focused view for reviewing, editing, and confirming grouped data.

Hierarchy and Structure

  • Section Instances can be single-instance (appearing once per document) or part of a collection (multi-instance/repeating sections).
  • They may contain any combination of fields, tables, and nested sections, supporting flexible and recursive document layouts.
  • The class provides methods for extracting, copying, and managing child elements, as well as for handling pre-extracted or placeholder content.

Integration with Other Grooper Features

  • Section Instances support advanced features such as recursive extraction, diagnostics, and dynamic section management.
  • They are used in workflows for data extraction, validation, review, and export, ensuring that grouped data is processed as a unit.
  • The class provides utility methods for extracting child elements, copying values, and integrating with diagnostic logging.

Diagnostics and Audit Trails

  • Section Instances participate in diagnostic logging and audit trails for extraction, validation, and review activities.
  • Diagnostic artifacts may include extraction logs, validation error messages, and audit trails of user edits or automated changes.

Properties

NameTypeDescription
General
Document Reference

Context Menu Commands

Command Shortcut Description
delete Delete Record Ctrl+Del Deletes the current record from the collection.
table_rows Insert Record Ctrl+Shift+Ins Inserts a new record before the current one.
move_down Move Next Ctrl+Shift+Right Moves the current record toward the end of the collection.

See Also

Rectangle

Notification