Graph Dashboard Widget

The Graph Widget presents system data in a dynamic visual chart format powered by Chart.js. Its primary purpose is to help administrators analyze operational trends—such as ticket issuance volume, active permit distribution, LPR scan activity, and dispatch logs—over time or across specific operational categories. This article is intended for OPSCOM administrators.

Setup and Configuration

The Graph widget is built directly into the dashboard framework.

• Admin Side: Administrators must have system role permissions enabled to edit dashboards (dashboard_edit_any or ownership of the target dashboard).

• Data Sources: Supports aggregated data from Violation Stats, Permit Stats (Beta), LPR Stats, Active Permits (Beta), Permit Activity (Beta), Dispatch Stats (Beta), and Incident Stats (Beta).

Using this Feature

Administrators can use the following instructions to add and configure a Graph widget on any customizable dashboard workspace.

Adding and Configuring the Graph Widget

1. Open your target dashboard, toggle Edit Mode to On, and click + Add Widget.

2. Select Graph Widget from the gallery.

3. Click the gear icon (Settings) in the widget header to open configuration settings.

4. Select your Widget Name, Data Source, and preferred Chart Type (Bar, Stacked Bar, Line, Pie, or Doughnut).

Display and Filter Options

Display Settings Tab

Display options adjust automatically based on your selected Data Source:

• Standard Stats (Violation, Permit, Dispatch, Incident, LPR): Customize your date range (Time Period), time intervals (Time Grouping), data grouping (Group By attributes like lot, camera, or permit type), metric (Count vs. Revenue), and sort order.

• Active Permits (Beta): Configure Group By and Stack By attributes (Lot, Lot Zone, or Permit Type) to structure stacked visual comparisons.

• Permit Activity (Beta): Define your relative Time Period, choose interval granularity via Bucket Size, and set the Auto Refresh rate.

Filter Settings Tab

Filters adapt dynamically based on your selected Data Source:

• Violation Stats: Refine by Payment Status (Unpaid, Overdue, Paid, Collections) or toggle options to isolate Payable Only (excludes warnings/spoiled tickets), Geo Coordinates Only, or Active Writer tickets.

• Permit Stats (Beta): Toggle Active permits only, or filter by specific Permit Type, Lots, Lot Group, or Lot Zone.

• Dispatch Stats (Beta): Toggle Parent Logs Only to exclude sub-logs, or filter by Log Status.

Click Save to apply your configuration and render the graph.

Available Controls and Display Modes

Widget Header Toolbar

• Refresh (circular arrow icon): Updates the graph to fetch and display the latest backend data.

• Download Raw CSV (green tray/arrow icon): Exports the raw tabular data points into a .csv file.

• Settings (gear icon): Opens the configuration modal to modify data sources, rules, and filters.

• Duplicate (double box icon): Clones the widget tile with matching settings onto your active dashboard.

Best Practices and Considerations

• Chart Type Selection: Use Bar or Stacked Bar charts for discrete categories/lots, Line charts for time trends, and Pie/Doughnut charts for relative percentage distributions across small datasets.

• Point in Time Compatibility: When a global Point in Time anchor is active on the dashboard, relative time windows evaluate backward from that timestamp, and auto-refresh pauses automatically.

• Combine with List Widgets: Place a Graph widget side-by-side with a List Widget configured with the exact same data source and filters to provide a high-level visual chart alongside a granular record drill-down on a single screen.