Overview
The Events page provides a comprehensive log of all activities across your parking facility. Track entries, exits, payments, errors, warnings, and informational events in real-time. With powerful filtering and search capabilities, you can quickly find specific events, analyze patterns, and generate detailed reports for operations, compliance, and troubleshooting.
Key Features:
- Complete Event Log: Track all facility activities including entries, exits, payments, and system events
- Full-Text Search: Search across event descriptions, device names, customer names, and more
- Advanced Filtering: 10+ filter criteria including event type, entity type, dates, devices, users, customers, businesses, access cards, tags, and zones
- Search suggestions: Find users, customers, businesses and access cards as you type
- Event Categorization: Filter by event category (Access, Entry, Device, User, Customer, System, Transaction, Validation, Company, Role, Schedule)
- Export Capabilities: Download filtered event data to Excel for analysis (permission-based)
- Responsive Design: Card view on mobile/tablet, table view on desktop
- Pagination Control: Customize rows per page (10, 25, 50, 100) with preference persistence
- Date Caching: Optimized performance with pre-parsed event dates
Interface Layout
The Events page is organized for efficient event tracking and analysis.
Header Section
- Page Title: "Events" with event note icon
- Description: "Event History" subtitle
- Search Bar: Quick search across all event fields
- Action Buttons: Export (permission-based), Refresh, and Filters toggle (permission-based)
Mobile: Elements stack vertically
Desktop/Tablet: Horizontal row with right-aligned actions
Filter Panel (Right Sidebar)
- Filter panel: Opens on the right side of the page
- Width: 340px fixed width with vertical scroll
- Sections: Event Type, Entity Type, Period, Users, Customers, Devices, Access Cards, Businesses, Tags, Zones
- Actions: Reset and Apply buttons at bottom
- Permission: Requires canFilterEvents() permission
Event List & Pagination
- Desktop View: Data table (width > 1024px)
- Mobile/Tablet View: Card layout (width ≤ 1024px)
- Pagination Bar: Bottom bar with counter, rows per page selector, and page navigation
- Max Pages: Supports up to 99,999,999 pages
Search & Quick Filters
Quickly locate events using the search bar or open the filter panel for advanced filtering.
Search Bar Functionality
- Searchable Fields: Event descriptions, device names, customer names, user names, event messages
- Real-Time Search: Results update automatically as you type
- Case Insensitive: Search works regardless of letter casing
- Partial Matching: Find events with incomplete information
Examples: "entry" for entries, "payment failed" for errors, "Terminal 2" for device events
Action Buttons
- Export: Download filtered results to Excel (requires canExportReports permission)
- Refresh: Reload event data to see latest activities
- Filters: Toggle advanced filter panel (requires canFilterEvents permission)
Desktop: Text buttons with icons | Mobile/Tablet: Icon-only buttons
Event Type Filters
Filter events by their type to focus on specific activity categories.
Available Event Categories
- ● Access: Access card operations (card created, updated, deleted, lost ticket)
- ● Entry: Entry/exit events (vehicle entered, vehicle exited, customer entered, guest entered)
- ● Device: Device status changes (connected, disconnected, error, barrier state changes, printer status)
- ● User: User account events (login success/failure, password changed, MFA enabled, account locked)
- ● Customer: Customer operations (created, updated, deleted)
- ● System: System-level events (backup created, configuration changed, software updated)
- ● Transaction: Payment events (payment created, refunded, voided)
- ● Validation: Access validation (access granted, denied, expired, max entrances reached, zone blocked, time restriction)
- ● Company: Business operations (company created, updated, deleted)
- ● Role: Role management (role created, updated, deleted)
- ● Schedule: Schedule changes (schedule created, updated, deleted)
Multi-Select: Select multiple event categories simultaneously to view combined results.
Use Cases by Event Category
- Entry: Track facility traffic flow and occupancy patterns for entries and exits
- Transaction: Monitor payment activity, refunds, and revenue generation
- Device: Identify and troubleshoot hardware and connectivity issues
- Validation: Review access granted/denied events and diagnose access control issues
- User: Audit user login activity, password changes, and MFA events
- System: Monitor system-level operations like backups and configuration changes
Entity Type Filters
Filter events by the type of entity (person/account) involved in the event.
Entity Type Categories
- ● Customer: Registered customers with accounts and subscriptions
- ● User: System users (staff, administrators, operators)
- ● Guest: Unregistered visitors or anonymous users
Date Range Filter
- Start Date: Beginning of date range (inclusive)
- End Date: End of date range (inclusive)
- Date Picker: Calendar interface for easy selection
- Range: From 2020 to current date
- Display Format: DD/MM/YYYY
Common Filtering Scenarios
- Customer + Entry: Track registered customer arrivals
- Guest + Paid: Monitor guest payment transactions
- User + Error: Review staff-related system issues
- All Types + Date Range: Generate daily/weekly/monthly activity reports
Advanced Filters
Use advanced filters to narrow down events by users, customers, devices, businesses, access cards, tags, and zones.
Search filters
Start typing in a filter field, then select a matching record:
- Users: Search system users by name (minimum 2 characters)
- Customers: Search registered customers by name (minimum 2 characters)
- Access Cards: Search access cards by username (minimum 2 characters)
- Businesses: Search companies/organizations by name (minimum 2 characters)
How It Works:
- Type at least 2 characters in the search field
- Pause briefly after typing to view matching results
- Loading indicator appears during search
- Results populate automatically (max 25 items)
- Select one or multiple items
- Selected items appear as chips with remove option
Multi-Select Dropdown Filters
- Devices: Select from all available devices (pre-loaded, max 1000)
- Tags: Select custom tags with color indicators
- Zones: Select parking zones with color indicators
All dropdown filters support multi-selection and display selected items as removable chips.
Filter Combinations
Combine multiple filters for precise event analysis:
- Device + Error Type: Troubleshoot specific device issues
- Customer + Entry/Exit: Track individual customer activity
- Zone + Date Range: Analyze zone-specific traffic patterns
- Business + Paid Events: Generate company billing reports
- Access Card + Entry: Audit access card usage
- Tag + Any Event Type: Track events by custom categories
Event List Views
Events display differently based on screen size for optimal viewing experience.
Desktop Table View (width > 1024px)
Full data table with columns for comprehensive event information:
| Column | Description |
|---|---|
| Date/Time | Event timestamp |
| Event Type | Category (Entry, Exit, Paid, Error, etc.) |
| Entity Type | Customer, User, or Guest |
| Entity Name | Customer/User name or "Guest" |
| Device | Device that generated the event |
| Description | Event message and details |
| Zone/Tags | Associated zone and tags |
| Actions | View details, related records |
Mobile/Tablet Card View (width ≤ 1024px)
Events displayed as cards for touch-friendly navigation:
- Card Header: Event type icon with color coding and timestamp
- Entity Info: Entity type badge and name
- Device Badge: Device name with icon
- Description: Event message text
- Zone/Tags: Color-coded chips for zones and tags
- Tap to Expand: View full details and available actions
Loading & Empty States
- Loading State: Progress indicator with "Loading events..." message
- Empty State: Helpful message when no events match filters
- Error State: Clear error message with retry option
- Date Cache: Pre-parsed dates improve filter performance on large datasets
Export Data to Excel
Export filtered event data to Excel for external analysis, reporting, and record-keeping.
Export Process
- Apply desired filters to narrow down event set (optional)
- Click the "Export" button in the header area
- System generates Excel file with all current filters applied
- Excel save dialog appears with download progress
- Choose location and save file to your computer
File Format: .xlsx (Excel 2007+)
Naming: events_export_[timestamp].xlsx
Permission: Requires canExportReports() permission
Exported Data Columns
- Event ID
- Date & Time
- Event Category (Access, Entry, Device, User, Customer, System, Transaction, Validation, Company, Role, Schedule)
- Entity Type (Customer, User, Guest)
- Entity Name
- Customer ID (if applicable)
- User ID (if applicable)
- Device Name
- Device ID
- Access Card Username
- Access Card ID
- Business/Company Name
- Zone Name
- Tags (comma-separated)
- Event Description
- Additional Details
Export Best Practices
- Filter Before Export: Apply filters to get exactly the data you need
- Date Range Limits: Use reasonable date ranges to manage file size
- Event Type Focus: Export specific event types for targeted analysis
- Regular Backups: Export daily/weekly event logs for compliance
- Device Reports: Export device-specific events for maintenance logs
- Customer Reports: Export customer events for billing and support
Pagination Controls
Navigate through large event sets efficiently with pagination controls at the bottom of the page.
Rows Per Page
- Options: 10, 25, 50, or 100 events per page
- Persistence: Selection saved to preferences automatically
- Performance: Larger page sizes may load slower on older devices
Page Navigation
- First Page: Jump to page 1 (|◄)
- Previous: Go back one page (◄)
- Page Numbers: Click specific page to jump directly
- Next: Advance one page (►)
- Last Page: Jump to final page (►|)
- Max Pages: Supports up to 99,999,999 pages
Event Counter
Format: "Showing X-Y of Z events"
- X: First event number on current page
- Y: Last event number on current page
- Z: Total events matching current filters
Best Practices & Tips
Daily Event Monitoring
- Review error and warning events each morning
- Check entry/exit ratios to ensure proper gate operation
- Monitor payment events for transaction failures
- Use date filter set to "Today" for current day activity
- Export daily event logs for compliance records
Troubleshooting with Events
- Filter by device + error type to isolate hardware issues
- Use customer filter to investigate specific complaints
- Check warning events before they escalate to errors
- Compare entry/exit events to identify gate malfunctions
- Review access card events for security auditing
Analytics and Reporting
- Export entry events by zone to analyze traffic patterns
- Filter by customer + paid events for billing reconciliation
- Use business filter to generate company-specific reports
- Combine zone + date range for occupancy analysis
- Track user events for staff activity monitoring
Search Optimization
- Use specific search terms for faster autocomplete results
- Apply filters before searching to narrow result sets
- Remember autocomplete requires minimum 2 characters
- Pause briefly after typing to view matching results
- Use device dropdown instead of search for faster selection
Performance Tips
- Always use date range filters for large datasets
- System caches parsed dates for faster filtering
- Limit autocomplete searches to 2-5 characters for best results
- Export large datasets rather than paginating through many pages
- Close filter panel when not in use for better screen space
- Refresh page periodically to see latest events