Service Collection

Displays a list of Grooper Service Instances and provides functions to manage them.

Remarks

The Service Collection control is a management interface for Grooper Service Instances, allowing users to view, configure, and control the operational state of services deployed across machines in the Grooper environment. It is designed for administrators and solution designers who need to monitor, start, stop, and update service configurations from a single, unified workspace.

Purpose and Functionality

• Service Listing:
  Presents all Service Instances in a sortable, filterable list, grouped by machine and service name. Users can quickly locate and review the status of each service.
• Service Property Editing:
  Selecting a service displays its properties in a categorized property grid, supporting inline editing, validation, and contextual help. Changes to service properties can be made directly in the UI.
• Service Control Actions:
  Action buttons allow users to start, stop, save, or cancel changes for selected services. Button states are context-sensitive and reflect the current selection and service status.
• Bulk Operations:
  Multiple services can be selected for batch start/stop operations, streamlining management of large environments.
• Status Monitoring:
  Real-time status, error tracking, and operational controls are provided for each service instance, supporting proactive maintenance and troubleshooting.

UI Components

• Service List:
  • Tabular view of all Service Instances, with columns for service name, machine, status, and other key properties.
  • Supports multi-selection, sorting, and filtering.
• Service Properties:
  • Property grid for the currently-selected service, with categorized sections, inline editors, and contextual help.
  • Changes are not applied until saved; a service must be restarted for changes to take effect.
• Toolbar/Action Buttons:
  • {start}: Start selected services.
  • {stop}: Stop selected services.
  • {save}: Save changes to service properties (requires service restart).
  • {cancel}: Discard unsaved changes.

Example

The following diagram illustrates the layout of the Service Collection control:

┌───────────────────────────────────────────────────────────────────────────────┐
│ Service Collection                             {start} {stop} {save} {cancel} │
├───────────────────────────────────────────────────────────────────────────────┤
│ ┌──────────── Service List ─────────────┐ ┌────── Service Properties ───────┐ │
│ │                                       │ │                                 │ │
│ │                                       │ │                                 │ │
│ │                                       │ │                                 │ │
│ └───────────────────────────────────────┘ └─────────────────────────────────┘ │
└───────────────────────────────────────────────────────────────────────────────┘

• Service List: Object List containing all Grooper Service Instances.
• Service Properties: Property Grid showing properties for the selected service.
• {start}: Start selected services.
• {stop}: Stop selected services.
• {save}: Save changes to service properties (requires restart).
• {cancel}: Discard unsaved changes.

Usage Tips

• Select one or more services in the list to start or stop them using the toolbar buttons.
• Click a service to view and edit its properties in the property grid. Save changes before restarting the service.
• Use sorting and filtering to quickly locate services by machine, name, or status.
• Monitor service status and errors for proactive maintenance and troubleshooting.
• Remember: changes to service properties require a service restart to take effect.

The Service Collection control streamlines the management of Grooper services, providing a centralized, user-friendly interface for configuration, monitoring, and operational control.

Command Buttons

Child Controls

┌──────────── Service List ─────────────┐
│ Name         | Machine   | Status     │
│--------------|-----------|------------│
│ ActivityProc | Server01  | Running    │
│ OCRService   | Server02  | Stopped    │
│ ...                               ... │
└───────────────────────────────────────┘

┌──────────── Service Properties ─────────────┐
│ Category: General                          │
│ ─ Service Name: {Text Box}                 │
│ ─ Machine: {Drop-down}                     │
│ Category: Advanced                         │
│ ─ Thread Count: {Numeric UpDown}           │
│ ─ Enabled: {Checkbox}                      │
│ ────────────── Help Window ──────────────  │
│   Description and usage guidance           │
└────────────────────────────────────────────┘

Used By

Processing Queue - WorkersMachines - GeneralMachines - Services