IP Element Container - Tester

Edit properties pf am IP Profile or IP Group and test image processing.

Remarks

The IP Container Tester tab provides an interactive workspace for configuring, testing, and troubleshooting IP Element Containers in Grooper. This control is designed for solution designers and administrators who need to define image processing workflows, validate step logic, and review diagnostic output using real-world images and immediate feedback.

Purpose

Use this tab to edit the properties of the selected IP Element Container, select test images, execute image processing tests, and review diagnostics. The integrated workspace streamlines the process of building, validating, and troubleshooting image processing pipelines, supporting rapid iteration and diagnostics.

UI Components

• Properties Panel:
  • Displays all configurable properties of the current IP Element Container in a categorized, interactive grid.
  • Supports inline editing, drop-down lists, checkboxes, and expandable sections for complex properties.
  • Provides contextual help and validation for each property, with a help window that updates as you select different fields.
  • Right-click to access context menu commands such as Clear, Reset, Copy, and Paste.
• Test Source Panel:
  • Allows selection and browsing of batches or documents to use as test images.
  • Includes toolbar buttons for searching, browsing, and navigating to specific items.
  • Supports hierarchical navigation and multi-selection for batch testing scenarios.
• Diagnostics Viewer:
  • Displays diagnostic output generated during image processing tests.
  • Shows logs, error messages, and supporting files in a dual-pane layout (file/folder tree and document viewer).
  • Allows users to preview diagnostic files, review logs, and analyze results.
• Toolbar and Buttons:
  • {test}: Execute a test on the current image using the configured IP Element Container.
  • {toggle}: Enable or disable automatic testing when the selected test document changes.
  • {save}: Save changes to the properties of the IP Element Container.
  • {cancel}: Discard unsaved changes and revert to the last saved state.
  • 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 IP Element Container node in the design tree, including IP Profile and IP Group.
• Edit properties in the properties panel to define the sequence, logic, and configuration of image processing steps.
• Use the test source panel to select images for testing.
• Click {test} to execute the image processing workflow and review results in the diagnostics viewer.
• Use {toggle} to enable or disable automatic testing on image selection changes.
• Save changes to update the container configuration, or cancel to revert to the previous state.

Example

The following diagram illustrates the typical layout of the IP Container Tester tab:

┌──────────────────────────────────────────────────────────────────┐
│ Tester                           {test} {toggle} {save} {cancel} │
├──────────────────────────────────────────────────────────────────┤
│ ┌───────── Left Pane ─────────┐ ┌───────── Right Pane ─────────┐ │
│ │ {Properties}                │ │ {Diagnostics}                │ │
│ │ ┌─────────────────────────┐ │ │ ┌──────────────────────────┐ │ │
│ │ │ Property Grid           │ │ │ │ Diagnostics Viewer       │ │ │
│ │ │ - Name                  │ │ │ │ - Diagnostics Tree       │ │ │
│ │ │ - Enabled               │ │ │ │ - Document Viewer        │ │ │
│ │ │ - Steps                 │ │ │ │ - Log Output             │ │ │
│ │ │ ...                     │ │ │ │ - Diagnostic Images      │ │ │
│ │ └─────────────────────────┘ │ │ │ ...                      │ │ │
│ │ {TestSource}                │ │ │                          │ │ │
│ │ ┌─────────────────────────┐ │ │ │                          │ │ │
│ │ │ Batch Contents Tree     │ │ │ │                          │ │ │
│ │ │ - Folder 1              │ │ │ │                          │ │ │
│ │ │   - Document 1          │ │ │ │                          │ │ │
│ │ │   - Document 2          │ │ │ │                          │ │ │
│ │ │ - Folder 2              │ │ │ │                          │ │ │
│ │ │   - Document 3          │ │ │ │                          │ │ │
│ │ └─────────────────────────┘ │ │ └──────────────────────────┘ │ │
│ └─────────────────────────────┘ └──────────────────────────────┘ │
└──────────────────────────────────────────────────────────────────┘

• {Properties}: Edit and configure all properties of the IP element container.
• {TestSource}: Select and browse batches or documents for image processing tests.
• {Diagnostics}: Review diagnostic output, logs, and supporting files after test execution.
• {test}, {toggle}, {save}, {cancel}: Command buttons for testing, auto-test, saving, and discarding changes.

Accessibility

• Fully navigable by keyboard and mouse.
• Contextual help and validation are provided for all properties.
• Tooltips and context menus offer guidance for available actions.

Advanced Features

• Live Testing: Instantly execute image processing tests and review diagnostics.
• Auto-Test: Enable automatic testing when the test source changes for rapid iteration.
• Diagnostics Review: Access detailed logs, error messages, and supporting files for troubleshooting.
• Contextual Help: Access documentation and usage guidance for each property.

Command Buttons

Button	Shortcut Key		Summary
play_circle test		►	Execute a test on the current image. The test button runs the configured image processing workflow on the selected test image(s) and updates the diagnostics output. Use this command to validate step logic and review results. The button is enabled when a test source is selected and the container is properly configured. Tooltips provide guidance on running tests and interpreting results.
toggle_on toggle		►	Toggle automatic testing on or off. The toggle button enables or disables automatic testing when the test source changes. This controls whether a test is run automatically each time the selected test document changes. When enabled, tests run automatically after each change to the selected test document. When disabled, tests must be run manually using the {test} button. Tooltips provide guidance on auto-test mode and its impact on workflow.
save save		►	Save changes to the properties. The save button commits all changes made to the properties of the current IP Element Container. Applies edits to step sequence, logic, and advanced options. The button is only enabled when there are unsaved changes. Tooltips provide guidance on saving and versioning.
cancel cancel		►	Discard changes to the properties. The cancel button reverts all unsaved changes to the properties of the current IP Element Container. Restores all properties to their last saved state, discarding any edits made since the last save. The button is only enabled when there are unsaved changes. Tooltips provide guidance on canceling and data loss prevention.

Child Controls

Name	Type		Summary
Properties	Property Grid	►	Displays the properties of this node. The Properties control presents all configurable properties of the current IP Element Container in a categorized, interactive grid. Properties are grouped by category and shown as rows with their name, value, and optional description. Supports inline editing, drop-down lists, checkboxes, color pickers, and expandable sections for complex or list properties. Provides contextual help and validation for each property, with a help window that updates as you select different fields. Right-click any property to access context menu commands such as Clear, Reset, Copy, and Paste. Validation errors are visually indicated, and error messages are shown in the help window. Keyboard navigation and multi-property selection are supported for efficient editing. Use this control to configure all aspects of the image processing container, including step sequence, logic, and advanced options.
Test Source	Test Source	►	Allows selection and browsing of batches or documents to use as test images. The Test Source control enables users to select and browse batches or documents for image processing tests. Presents a hierarchical tree of folders, batches, and documents available for testing. Supports multi-selection for batch testing scenarios. Includes toolbar buttons for searching, browsing, and navigating to specific items. Selection updates the test context for image processing and diagnostics. Fully navigable by keyboard and mouse, with visual cues for selected items. Use this control to choose the source images for testing and validation of the IP container configuration.
Diagnostics	Diagnostics Viewer	►	Displays diagnostics for the previous test. The Diagnostics control presents diagnostic output generated during image processing tests. Shows logs, error messages, and supporting files in a dual-pane layout: file/folder tree on the left and document viewer on the right. Allows users to preview diagnostic files, review logs, and analyze results. Visual indicators highlight errors, warnings, and critical events. Includes a {launch} button to open the Diagnostics Viewer in a new window for expanded review. Automatically updates after each test run, providing immediate feedback and troubleshooting tools. Use this control to review diagnostic output, troubleshoot image processing steps, and analyze test results.

Used By

Design Tab Host