Stats Result Set

Displays a report and a paged list of Session Stats for a Stats Query, with interactive navigation and export options.

Remarks

The Stats Result Set control provides a unified interface for viewing, navigating, and exporting the results of a Stats Query. It combines a detailed report, a paged list of matching Session Stats, and controls for paging, deletion, and download, making it easy to analyze and manage batch processing statistics in Grooper.

Overview

Stats Result Set is typically presented as a main panel or results page after running a Stats Query. It displays a summary report (see {Report}), a paged table of individual Session Stats (see {SessionList}), and navigation controls (see {Pager}) for browsing large result sets. Action buttons allow users to delete all matching sessions or download the report as a CSV file.

Key Features

• Integrated Report and List View:

  • Shows a summary report generated from the Stats Query, including grouped and formatted statistics.
  • Displays a paged list of individual Session Stats records matching the query criteria.

• Paging and Navigation:

  • Supports paging through large result sets, with navigation controls for moving between pages.
  • Displays the current page and total page count.

• Export and Management Actions:

  • {download}: Download the current report as a CSV file for further analysis or sharing.
  • {delete}: Delete all sessions matching the current query (requires appropriate permissions).

• Security and Permissions:

  • The {delete} button is only available to users with design rights.
  • The control respects user permissions for viewing, deleting, and exporting data.

• Integration:

  • Designed to work seamlessly with the Stats Query and Stats Report infrastructure.
  • Can be embedded in dashboards, analytics pages, or custom reporting workflows.

Interactive Components

• Session List ({SessionList}):

  • Displays a paged, tabular list of Session Stats records.
  • Columns are generated dynamically based on the properties of Session Stats.
  • Supports selection, sorting, and keyboard navigation.

• Page Navigator ({Pager}):

  • Provides controls for moving between pages of results.
  • Shows the current page, total pages, and allows direct page selection.

• Stats Report ({Report}):

  • Shows a summary report for the current query, including grouped statistics and totals.
  • Adapts to the grouping, filtering, and formatting options of the Stats Query.

• Action Buttons:

  • {delete}: Permanently deletes all sessions matching the query (design rights required).
  • {download}: Exports the report as a CSV file.

Usage Guidance

• Use Stats Result Set to review and analyze the results of a Stats Query, including both summary statistics and individual sessions.
• Navigate through large result sets using the pager controls.
• Download the report for offline analysis or sharing with stakeholders.
• Delete sessions only when necessary and with appropriate permissions, as this action is irreversible.

Accessibility

• Fully navigable by keyboard and mouse.
• Screen reader support for all controls, including the report, session list, and pager.
• Visual highlighting for selected rows, focused controls, and action buttons.

Example

┌──────────── Stats Result Set ─────────────┐
│ {Report}                                  │
│                                           │
│ Session List:                             │
│ ┌───────────────┬───────────────┬───────┐ │
│ │ User          │ Tasks         │ Time  │ │
│ ├───────────────┼───────────────┼───────┤ │
│ │ Alice         │ 120           │ 8h    │ │
│ │ Bob           │ 95            │ 6h    │ │
│ │ ...           │ ...           │ ...   │ │
│ └───────────────┴───────────────┴───────┘ │
│                                           │
│ {Pager}                                   │
│                                           │
│ {download} {delete}                       │
└───────────────────────────────────────────┘

Command Buttons

Child Controls

┌───────────── Session List ─────────────┐
│ User   | Tasks | Time                  │
│--------|-------|------                 │
│ Alice  | 120   | 8h                    │
│ Bob    | 95    | 6h                    │
│ ...    | ...   | ...                   │
└────────────────────────────────────────┘

┌───────────── Stats Report ─────────────┐
│ Group: User                            │
│ Alice: 120 tasks, 8h                   │
│ Bob:   95 tasks, 6h                    │
│ ...                                    │
│ Totals: 215 tasks, 14h                 │
└────────────────────────────────────────┘

Used By

Stats Page