Product Events Management

The Product Events page provides comprehensive management of product-related events within the calendar system. This page allows administrators to view, search, filter, and manage events that are specifically tied to products in your system. Product events are calendar entries that include product associations and can be filtered by date ranges, organizations, and users.

Quick Start

To get started: Use the search box to find specific events, adjust the date range to view events in different time periods, or click "Add" to create a new product event. Use the organization filter to narrow results by specific organizations. Select multiple events using checkboxes to perform bulk delete operations.

Page Overview

The Product Events management interface is organized into several key sections:

  • Header Bar: Shows current user, page title, and current date
  • Toolbar Section: Contains action buttons, search, filters, and date range controls
  • Results Table: Displays product events with sorting, pagination, and bulk actions
  • Calendar View: Optional iframe showing calendar visualization when search terms are used

Toolbar Functions

Primary Actions

Button Function Permission Required
+ Add Creates a new product event entry Calendars_Events_Add permission
â?쳌 Back Returns to previous page in browser history None
â?? Close Closes the current page or returns to Control Panel None
Show All Resets date filters to show all events None
UnDelete Switches to deleted events view for restoration None

Search and Filtering

The search functionality allows you to find events across multiple fields:

  • Search Box: Searches event names, descriptions, organizations, usernames, product names, and event IDs
  • User Filter: Dropdown to filter events by specific users (Admin sees all users, others see workgroup)
  • Organization Filter: Dropdown in table header to filter by organization
  • Date Range: Start and end date inputs to limit results to specific time periods
  • All Dates Checkbox: When checked, ignores date range and shows all events

Date Controls

The date range controls allow precise filtering of events:

  • Start Date: Beginning of date range (defaults to first day of current month)
  • End Date: End of date range (defaults to last day of current month)
  • Go Button: Applies the selected date range
  • All Dates Checkbox: Overrides date range to show all events regardless of date

Results Table

Table Columns

Column Description Sortable
Checkbox Selection checkbox for bulk operations No
Start Event start date in MMM-DD-YYYY format Yes
End Event end date in MMM-DD-YYYY format Yes
Product Event name with associated product name in parentheses Yes
Organization Organization associated with the event, includes filter dropdown Yes
User User alias or username who created the event Yes
Actions Action buttons for individual event operations No
ID Unique event identifier Yes

Row Color Coding

Table rows use color coding to indicate event status:

  • Green Background: Past events or events marked as "Done"
  • Blue Background: Events occurring today
  • Teal Background: Past events that are completed
  • White Background: Future events

Individual Actions

Each event row includes action buttons in the Actions column:

Action Function Permission Required
Edit Opens event editing interface Calendars_Events_Edit permission
Delete Soft deletes the event (can be restored) Calendars_Events_Delete permission
View Opens detailed event view in popup window None
Widget Creates widget for the event None
Copy Creates a copy of the event None
Restore Restores a soft-deleted event (only visible in deleted view) None

Bulk Operations

Selecting Multiple Events

Use the checkboxes to select events for bulk operations:

  1. Select All: Click the checkbox in the table header to select all visible events
  2. Individual Selection: Click individual checkboxes to select specific events
  3. Cross-Page Selection: Selections are maintained across DataTable pagination

Bulk Delete Operations

The bulk delete functionality varies depending on the current view:

Normal View (Active Events)

  • Delete Selected: Soft deletes selected events (sets active=2)
  • Deleted events can be restored later
  • Confirmation dialog appears before deletion

Deleted Events View

  • Un-Delete Selected: Restores selected events (sets active=1)
  • Permanently Delete: Hard deletes selected events (removes from database)
  • Permanent deletion cannot be undone
  • Separate confirmation dialogs for each operation

Permission System

Required Permissions

The page requires specific permissions for different operations:

Operation Permission Notes
Page Access Events Required to access the page
Add Events Calendars_Events_Add Admin (ID=1) bypasses this check
Edit Events Calendars_Events_Edit Admin (ID=1) bypasses this check
Delete Events Calendars_Events_Delete Admin (ID=1) bypasses this check

Data Visibility Rules

Event visibility depends on user role:

  • Admin Users (ID=1): Can see all product events from all users and organizations
  • Regular Users: Can see events they created plus events from users in their workgroup
  • Organization Filter: Available to all users to further narrow results
  • User Filter: Admin sees all users, others see workgroup members

Delete Workflows

Soft Delete Process

  1. Select events using checkboxes
  2. Click "Delete Selected" button
  3. Confirm deletion in dialog
  4. Events are marked as deleted (active=2) but remain in database
  5. Page redirects to show remaining active events

Undelete Process

  1. Click "UnDelete" button to switch to deleted events view
  2. Select deleted events using checkboxes
  3. Click "Un-Delete Selected" button
  4. Confirm restoration in dialog
  5. Events are restored (active=1) and become visible in normal view

Hard Delete Process

  1. Navigate to deleted events view
  2. Select events to permanently delete
  3. Click "Permanently Delete" button
  4. Confirm permanent deletion (warning about irreversibility)
  5. Events are completely removed from database

Deletion Tips

  • Always use soft delete first - hard deletion cannot be undone
  • Review deleted events periodically to determine if hard deletion is needed
  • Consider the impact on related records before permanent deletion
  • Bulk operations work across DataTable pages

DataTables Features

Pagination and Display

  • Default Page Size: 25 events per page
  • Page Size Options: 25, 50, 100, or All
  • State Saving: Table settings are remembered between sessions
  • Responsive Design: Table adapts to different screen sizes

Sorting and Searching

  • Column Sorting: Click column headers to sort (excludes checkbox and actions columns)
  • Multi-Column Sorting: Hold Shift while clicking for secondary sorts
  • Built-in Search: DataTables search box filters all visible columns
  • Search Highlighting: Search terms are highlighted in results

Table Controls

  • Length Menu: Dropdown to change number of events displayed
  • Info Display: Shows current page and total event counts
  • Pagination Controls: Navigate between pages of results
  • Export Options: Copy, print, or export table data (if enabled)

Calendar Integration

Calendar View

When search terms are entered, an additional calendar view appears below the table:

  • Visual Calendar: Shows events in traditional calendar format
  • Search Integration: Calendar is filtered to match search results
  • Interactive Interface: Click events in calendar for details
  • Embedded Display: Calendar loads in iframe for seamless integration

Calendar Features

  • Month Navigation: Browse different months and years
  • Event Details: Hover or click events for more information
  • Color Coding: Different event types may use different colors
  • Responsive Layout: Calendar adapts to container size

Advanced Workflows

Creating Product Events

  1. Click the "Add" button in the toolbar
  2. Fill out the event creation form with product association
  3. Set appropriate start and end dates
  4. Assign to organization and set visibility
  5. Save the event to return to the main listing

Bulk Event Management

  1. Use filters to narrow down to events needing similar changes
  2. Select multiple events using checkboxes
  3. Apply bulk operations (delete/restore) as needed
  4. Use date range filters to focus on specific time periods
  5. Combine with organization filters for targeted management

Reporting and Analysis

  1. Use date range controls to analyze events in specific periods
  2. Filter by organization to see departmental activity
  3. Sort by different columns to identify patterns
  4. Use search functionality to find events by keywords
  5. Export or print filtered results for external analysis

Troubleshooting

Common Issues

Issue Cause Solution
No events showing Date range too restrictive Check "All Dates" or adjust date range
Add button disabled Missing Calendars_Events_Add permission Contact administrator for permission
Limited event visibility Non-admin user restrictions Normal behavior - users see own + workgroup events
Bulk operations not working No events selected Select events using checkboxes first

Performance Considerations

  • Large Datasets: Use date range filters to limit results for better performance
  • Search Optimization: Specific search terms return faster than broad searches
  • Organization Filters: Narrow results by organization for faster loading
  • Page Size: Smaller page sizes improve initial load times

Summary

The Product Events management page provides comprehensive tools for managing calendar events associated with products. Use the search and filter capabilities to find specific events, the bulk operations for efficient management, and the permission system ensures appropriate access control. The integration with calendar views and DataTables functionality makes this a powerful tool for event administration. Remember that soft deletion allows for event recovery, while hard deletion is permanent and should be used with caution.