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

Key-Value Pair

Ordered Array Grooper.Extract

Matches cases where a key-value pair occur on the document in a specific layout.

Remarks

The KeyValueProvider collation provider is designed for extracting field label / field value pairs from documents, based on their spatial or sequential layout.

How it works:

  • Requires exactly two extractors on the host Data Type: the first for keys (labels), the second for values.
  • For each key instance, the provider locates the closest value instance according to the configured layout and direction.
  • Only the value component is included in the output; the key is stored as context.

Requirements:

  • The Data Type must define exactly two extractors (pattern, referenced, or child extractors).

Configuration:

  • The direction and layout for matching pairs can be controlled using the 'VerticalDirection', 'HorizontalDirection', and 'FlowDirection' properties.
  • The 'EnforceLineBoundaries' property can be used to prevent pairing across detected lines (such as table or form lines).

Use cases:

  • Extracting labeled fields from forms, such as "Name: John Doe" or "Date: 01/01/2024".
  • Capturing key-value pairs in structured or semi-structured documents where the key and value may appear in various positions or orientations.

Properties

NameTypeDescription
General
Layout
Combine Options

See Also

Used By

Notification