Data Element - Tester

Test data extraction for a Data Element.

Remarks

The Data Element Tester tab provides an interactive workspace for building, testing, and refining extraction logic for Data Elements and Data Models in Grooper. This control is designed for solution designers, administrators, and subject matter experts who need to validate extraction rules, review results, and troubleshoot data model configuration using real-world documents and immediate feedback.

Purpose

Use this tab to select a Data Element or Data Model, run extraction tests against sample documents, and review the results in a structured, visual format. The integrated workspace streamlines the process of developing, validating, and troubleshooting extraction logic, providing powerful tools for rapid iteration and diagnostics.

UI Components

• Test Source Panel:
  • Tree viewer for selecting the data element or document to test.
  • Action buttons: {test}, {save}, {diagnostics}, {inspect}.
  • Supports selection-driven workflow, updating the main panel as selections change.
• Main Panel:
  • Split layout with the data grid (extraction results) on the left and the document viewer on the right.
  • The data grid displays extracted values for the selected element or model, supporting sorting, filtering, and review.
  • The document viewer shows the currently-selected document for visual verification of extraction results.
• Action Buttons:
  • {test}: Run extraction and update the data grid.
  • {save}: Save changes to extracted data or test configuration.
  • {diagnostics}: View diagnostics from the previous test, including error messages and performance metrics.
  • {inspect}: Open the Data Inspector in a new window for detailed data review.
  • Button states and tooltips provide guidance for available actions and indicate when unsaved changes are present.

Workflow and Scope

• The tab is available for any Data Element node except Data Column.
• Select a data element or document in the Test Source panel to begin testing.
• Click {test} to run extraction and view results in the data grid.
• Use {diagnostics} to troubleshoot extraction issues and {inspect} for detailed data review.
• Save changes with {save} when modifications are made to extracted data or configuration.
• Use the document viewer to visually confirm extraction results against the source content.
• Enable 'AutoRun' to automatically test extraction on selection changes for rapid iteration.

Example

The following diagram illustrates the layout of the Data Element Tester tab:

┌───────────────────────────────────────────────────────────────────────────────┐
│ Tester                                  {test} {save} {diagnostics} {inspect} │
├───────────────────────────────────────────────────────────────────────────────┤
│ ┌─────────────── Data Grid ───────────────┐ ┌─────── Document Viewer ───────┐ │
│ │                                         │ │                               │ │
│ │                                         │ │                               │ │
│ │                                         │ │                               │ │
│ └─────────────────────────────────────────┘ └───────────────────────────────┘ │
└───────────────────────────────────────────────────────────────────────────────┘

• Test Source: Tree viewer for selecting the data element or document.
• {test}: Run extraction test.
• {save}: Save changes.
• {diagnostics}: View diagnostics from the previous test.
• {inspect}: Open Data Inspector.
• Data Grid: Tabular display of extraction results.
• Document Viewer: Preview of the selected document.

Accessibility

• Fully navigable by keyboard and mouse.
• Visual cues and highlighting indicate the selected element, test status, and errors.
• Tooltips and context menus provide guidance for available actions.

Advanced Features

• Immediate Feedback: Extraction results and diagnostics are updated in real time after each test run.
• Diagnostics and Data Inspector: Access error messages, warnings, and performance metrics for troubleshooting extraction logic.
• Auto-Run Support: Optionally run extraction tests automatically when a new selection is made.
• Data Grid Features: Supports sorting, filtering, and reviewing of extraction results, including saved data for Data Models.
• Document Navigation: The document viewer supports zooming, panning, and page navigation for multi-page documents.

Child Controls

Name	Type		Summary
Tester	Data Element Tester	►	Provides an interactive workspace for unit testing data element extraction within a batch process. The Tester control is the main interactive panel for building, testing, and refining extraction logic for Data Elements and Data Models. Includes a test source panel for selecting the data element or document to test. Displays a data grid with extraction results and a document viewer for visual verification. Action buttons ({test}, {save}, {diagnostics}, {inspect}) provide quick access to core testing and review functions. Supports sorting, filtering, and reviewing extracted values, as well as launching diagnostics and the Data Inspector. Updates in real time after each test run, providing immediate feedback and troubleshooting tools. Use this control to validate extraction rules, review results, and troubleshoot data model configuration using real-world documents.

Used By

Design Tab Host