Diagnostics Viewer

Displays diagnostic information after testing a Grooper component.

Remarks

The Diagnostics Viewer is a specialized UI component for reviewing, navigating, and analyzing diagnostic output generated during Grooper component testing or troubleshooting. It provides a dual-pane interface: a hierarchical file/folder tree on the left and a document viewer on the right. This layout allows users to quickly locate and inspect diagnostic files, logs, and supporting artifacts produced during a test or error event.

Purpose and Functionality

• Diagnostics Navigation:
  Presents the contents of a diagnostic ZIP archive as a tree of folders and files, mirroring the structure of the diagnostic output.
• File Preview:
  Selecting a file in the tree displays its content in the integrated {Viewer}, which automatically selects the best viewer/editor for the file type (text, image, PDF, etc.).
• Session Management:
  Handles expired or missing diagnostic sessions gracefully, providing clear error messages if the ZIP archive is unavailable.
• Launch in New Window:
  The {launch} button allows users to open the Diagnostics Viewer in a separate window for side-by-side analysis.

UI Components

• File/Folder Tree:
  • Hierarchical navigation of all files and folders in the diagnostic archive.
  • Expand/collapse folders to reveal nested files and subfolders.
  • Hidden or irrelevant files (such as .ann or .diag extensions) are filtered from the tree.
• Document Viewer:
  • Displays the content of the selected file using the most appropriate viewer/editor.
  • Supports a wide range of file types, including images, text, logs, and structured data.
• Toolbar:
  • {launch}: Opens the Diagnostics Viewer in a new window for expanded review.

Example

The following diagram illustrates the layout of the Diagnostics Viewer:

┌──────────────────────────────────────────────────────────────────────────────┐
│ Diagnostics Viewer                                                           │
├──────────────────────────────────────────────────────────────────────────────┤
│ ┌──────────── File/Folder Tree ────────────┐ ┌───── Document Viewer ───────┐ │
│ │ Root/                                    │ │                             │ │
│ │ ├─ Info.txt                              │ │                             │ │
│ │ ├─ Log/                                  │ │                             │ │
│ │ │   └─ Error.log                         │ │                             │ │
│ │ └─ Output/                               │ │                             │ │
│ │     ├─ Result1.pdf                       │ │                             │ │
│ │     └─ Result2.png                       │ │                             │ │
│ └──────────────────────────────────────────┘ └─────────────────────────────┘ │
│ {launch}                                                                     │
└──────────────────────────────────────────────────────────────────────────────┘

• The left pane shows the file/folder tree for the diagnostic archive.
• The right pane previews the selected file using the integrated document viewer.
• The {launch} button opens the viewer in a new window.

Usage Tips

• Click folders to expand/collapse and files to preview their content.
• Use the {launch} button to open the Diagnostics Viewer in a separate window for easier comparison or multitasking.
• Only relevant files are shown; hidden or system files are filtered out for clarity.
• The viewer automatically selects the best display mode for each file type, making it easy to review logs, images, and other artifacts.

The Diagnostics Viewer streamlines the process of reviewing and troubleshooting diagnostic output, making it easy to locate, preview, and analyze files generated during Grooper component testing or error analysis.

Command Buttons

Button	Shortcut Key		Summary
launch launch		►	Opens the diagnostic viewer in a new window. The 'launch' button opens the Diagnostics Viewer in a separate browser window for expanded review and multitasking. Purpose and Functionality Allows users to open the Diagnostics Viewer in a new window for side-by-side comparison or detailed analysis. Useful for multitasking, sharing, or working with multiple diagnostic sessions simultaneously.

Child Controls

Name	Type		Summary
Viewer	Document Viewer	►	Displays the currently-selected file. The 'Viewer' control provides a flexible document viewer for previewing the content of the selected file in the diagnostics archive. Purpose and Functionality Automatically selects the best viewer/editor for the file type (text, image, PDF, etc.). Supports a wide range of file types, including logs, images, PDFs, and structured data. Updates in real time as the user selects different files in the file/folder tree. Enables users to review logs, error reports, screenshots, and other diagnostic artifacts.

Used By

IP Element Container - TesterIP Step - Tester