Batch List

Displays a paged, sortable list of batches for review, selection, and batch-level operations.

Remarks

The Batch List is a central UI component for managing and interacting with Batches in Grooper. It provides a dynamic, filterable table view of batches under a specified base folder or process, supporting efficient navigation, selection, and execution of batch commands.

Purpose and Functionality

The Batch List enables users to browse, search, and act on large sets of batches. It supports paging (up to 1000 batches per page), column sorting, and searching by batch name or other criteria. The list adapts to both production and test environments, and can be filtered using the Batch Filter to focus on relevant batches for a given workflow.

UI Components

• Header Row:
  Displays sortable column headers for key batch properties, including Name, Process, Step, Activity, Status, Priority, Created, and Created By. Clicking a header sorts the list by that column.

• Batch Table:
  Shows batches in a scrollable, virtualized table for high performance. Each row represents a batch and displays its properties. Rows are selectable and support multi-selection.

• Context Menu:
  Right-clicking a batch row opens a context menu with batch-level commands such as Open, Review, and View Properties. The menu adapts to the current selection and user permissions.

• Progress Bar:
  Indicates loading or processing activity.

• Keyboard Navigation:
  Supports efficient navigation and selection using keyboard shortcuts:

  • Up/Down: Move between batches.
  • Shift + Up/Down: Multi-select.
  • Home/End: Jump to start or end of the list.
  • Page Up/Page Down: Scroll quickly.
  • Ctrl + A: Select all batches.
  • Enter: Open the current batch in the Review Page.

Interactive Features

• Paging and Performance:
  Results are paged at 1000 batches per page to ensure responsive performance, even with large batch sets.

• Sorting and Filtering:
  Batches can be sorted by any column and filtered by process, step, activity, status, or search term. Filtering is dynamic and can be updated at any time.

• Selection and Multi-Selection:
  Click or use keyboard shortcuts to select one or more batches. Multi-selection enables batch operations on multiple items.

• Context Menu Commands:
  Provides quick access to batch-level actions, including:

  • Open: Opens the selected batch for viewing or editing.
  • Review: Launches the review workflow for the current step of the batch.
  • ^^View Properties:** Displays detailed properties of the selected batch or folder.
  • Additional commands may be available based on workflow, permissions, or custom configuration.

• Change Tracking:
  Integrates with change tracking to highlight batches with unsaved changes or updates, supporting collaborative review and batch management.

Usage Guidance

To use the Batch List, select a base folder or process to display batches from. Optionally, configure sorting, filtering, and search parameters to tailor the displayed batch set. The list will automatically load batches according to the specified criteria and persist selection and filter state in the session.

Example

The following diagram illustrates the layout of the Batch List control:

┌─────────────────────────────────────────────────────────────────────────────────┐
│ Name   | Process | Step | Activity | Status | Priority | Created | Created By   │
├────────┬─────────┬──────┬──────────┬────────┬──────────┬─────────┬──────────────┤
│ Batch1 | ...     | ...  | ...      | ...    | ...      | ...     | ...          │
│ Batch2 | ...     | ...  | ...      | ...    | ...      | ...     | ...          │
│ ...                                                                             │
├─────────────────────────────────────────────────────────────────────────────────┤
│ {Context Menu} (on right-click)                                                 │
│  ┌──────────────── Context Menu ────────────────┐                               │
│  │ Open            <kbd>Ctrl</kbd>+<kbd>O</kbd> │                               │
│  │ Review          <kbd>Ctrl</kbd>+<kbd>R</kbd> │                               │
│  │ View Properties <kbd>F12</kbd>               │                               │
│  │ ...                                          │                               │
│  └──────────────────────────────────────────────┘                               │
└─────────────────────────────────────────────────────────────────────────────────┘

Context Menu Commands

Command	Shortcut	Description
file_copy Copy	Ctrl+C	Copies the current selection to the clipboard. Items will be duplicated when pasted.
account_tree Open	Ctrl+O	Opens the selected batch for viewing or editing.
person Review	Ctrl+R	Launches the review workflow for the current step of the selected batch.
list_alt View Properties	F12	Displays properties of the currently-selected batch, folder, or page.

Child Controls

Name	Type		Summary
Context Menu	Context Menu	►	Displays a context menu of commands for Batch objects in the Batch List. The Context Menu provides quick access to batch-level actions and commands for the selected batch or batches. It appears when you right-click on a batch row or use the keyboard shortcut to open the menu. Usage Right-click a batch row to open the context menu. Select a command such as {Open}, {Review}, or {ViewProperties} to perform actions on the selected batch. The menu adapts to your selection, showing only commands that are enabled for the current batch state and user permissions. Keyboard shortcuts for each command are displayed in the menu for quick access. Available Commands Open: Opens the selected batch for viewing or editing. Review: Launches the review workflow for the current step of the batch. View Properties: Displays detailed properties of the selected batch or folder. Additional commands may be available based on workflow, permissions, or custom configuration. Accessibility Fully navigable by keyboard and mouse. Screen reader support for menu items and command descriptions. Visual highlighting for enabled, disabled, and focused commands.

Used By

Batch Manager