Dashboards

Dashboards view enables creating, viewing, managing, duplicating, and deleting dashboards with options for importing, customizing columns, and maximizing.

The Dashboards View enables users to create, view, manage, duplicate, and delete dashboards, depending on the status of the public link. Key actions include viewing (if the link is active), managing settings, duplicating dashboards (with name confirmation), and deleting dashboards (with a confirmation window). Additional controls include customizing column visibility, importing dashboards, and maximizing the view for easier management.

Key Elements of the Dashboards View

• Top Left Corner

  • The page is labelled "Dashboards View".

• Top Right Corner

  • A Create button is visible, allowing users to create a new dashboard.

"Create" Button

When the Create button is clicked, a new page titled "Create New Dashboard" opens, where users can fill in details to set up the new dashboard. Below are the fields and buttons available on this page.

Fields in the "Create New Dashboard" Page

Field	Mandatory	Description
1. Name*	Yes	Enter the name of the new dashboard (required).
2. Entity*	Yes	Select the entity associated with the dashboard (required).
3. Data Time Range*	Yes	Specify the data time range for the dashboard (required).
4. Dashboard Context	No	Optional context or description for the dashboard.
5. Upload Logo Image	No	Upload a logo for the dashboard (optional).
6. Chart Colour	No	Choose chart colour from a dropdown, or use the default option.

Bottom Right Corner Buttons

At the bottom of the page, you’ll see two action buttons.

Button	Description
Cancel	Discards the changes and navigates back to the Dashboards View.
Create	Saves the dashboard and adds it to the list of available dashboards.

Note: This setup is intuitive, providing users with the necessary fields and options to quickly configure and create a new dashboard. The table format for the create button options clarifies the functionality for end-users.

Additional Dashboard View Functionalities

• Filter Button: Directly below the "Dashboards View" heading, there is a filter field that allows users to search for specific dashboards based on their name or entity.

• Three Buttons in the Top Right Corner

  • 1. Column Visibility: Allows users to toggle the visibility of columns such as Entity, Name, and Public Link.

  • 2. Export: Exports the dashboard data in various formats.

  • 3. Maximize: Expands the table to a full-screen view for better visibility.

Dashboard Table

The main part of the Dashboards View consists of a table with the following columns

Column	Description
Entity	The entity associated with each dashboard.
Name	The name of the dashboard.
Public Link	The public link to view the dashboard if it is activated.
Actions	Options to manage the dashboard, including,
- View	View the dashboard (available if the link is activated).
- Manage	Manage settings and configurations of the dashboard.
- Duplicate	Create a copy of the dashboard.
- Delete	Permanently delete the dashboard.

• If the link is deactivated, the View option will not appear in the Actions column.

Actions Buttons Explained

1. View Button

Heading: Dashboard Name

• At the top of the page, the name of the dashboard is prominently displayed as the heading. This helps users easily identify which dashboard they are currently viewing.

Light/Dark Mode Toggle

• Positioned behind or near the heading is a light/dark mode switch.

• Light Mode: Displays the dashboard with a light background and colour scheme.

• Dark Mode: Switches the dashboard to a darker colour scheme, which may be preferred for night viewing or reduced eye strain.

Additional Information Below the Heading,

Date, Time, and Location

• Just below the heading and the light/dark mode switch, the Date and Time relevant to the data displayed in the dashboard is shown.

• The Location of the data being tracked is also visible (e.g., if the dashboard is for a specific location or entity, like a sensor hub or service centre).

Top Right Corner Buttons

In the top right corner of the page, there are three important buttons for interacting with the dashboard data:

Button	Description
AI Intelligence	Clicking this button provides AI-powered insights or recommendations based on the data displayed in the dashboard. This could include trends or alerts.
Download	Allows users to download the dashboard data or visualizations (such as charts or tables) in formats like CSV, PDF, or PNG.
View Date Navigation	This option lets users change the date range they are viewing. It includes buttons to move to the previous period or next period (e.g., previous/next day, week, month) based on the dashboard's data timeframe.

Main Content Area: Charts and Tables

Charts and Tables Display

• Below the date and time information, the main content area of the dashboard is populated with charts and tables.

• Dynamic Content: The specific charts and tables shown depend on the dashboard’s configuration, data sources, and purpose. These could include:

  • Line graphs, bar charts, or pie charts for visualizing trends.

  • Tables that present data in a tabular format for detailed analysis.

• This section updates automatically based on the selected date or data range chosen through the View Date Navigation buttons at the top.

Feature	Description
Light/Dark Mode	Toggle between light and dark display modes for the dashboard.
Date and Time	Displays the current date and time range for the dashboard's data.
Location	Shows the location or entity associated with the dashboard.
AI Intelligence	Provides AI-powered insights and analytics on the dashboard's data.
Download	Enables downloading dashboard data in various formats like CSV, PDF, etc.
View Date Navigation	Navigate between previous and next time periods for the dashboard's data (e.g., previous/next day or month).
Charts and Tables	Displays the visual representations and detailed data tables based on the dashboard's configuration. This content will dynamically change per dashboard.

2. Manage Button

The Manage button is more advanced and provides users with options to configure and manage the selected dashboard. When clicked, it navigates users to a detailed management page for the specific dashboard, allowing for customization and configuration of various settings.

Calendar Button : The Calendar Button is located in the top right corner of the Manage Dashboard page. This button, accompanied by left and right arrows, allows users to navigate through different date and time periods to view historical or forecasted data on the dashboard.

Here's a detailed breakdown of the Share Button functionalities on the below table.

Section	Description
Top Left Corner: Dashboard Name	The name of the dashboard is prominently displayed at the top left of the page, helping users easily identify which dashboard they are managing.
Top Right Corner: Action Buttons	The following four buttons are available in the top right corner:
Calendar Icon with Left/Right Arrows	- Navigate between different date and time periods for the data presented in the dashboard. - Use the left and right arrows to go backward or forward in time to review historical data or forecast future periods.
Share Button	Opens a new window titled "Publish this dashboard" with the following features:
Copy Link	Provides a shareable link that can be used outside the AlphaX platform.
Toggle Options	- Dark Mode: Switches the dashboard's appearance to dark mode. - Interaction: Enables or disables interaction features for external viewers. - Date Picker: Lets users adjust the date range of the data displayed on the shared dashboard.
Note	A message below the toggles stating: "Anyone with this link can see this dashboard. You can share this with anyone outside our AlphaX platform."
Activate/Deactivate Toggle	Users can enable or disable the dashboard (make it accessible or inaccessible).
Auto-Refresh Options	A dropdown menu with the following settings:
	- Disabled: Turns off auto-refresh. - Every 1 Minute: Refreshes the dashboard every minute. - Every 5 Minutes: Refreshes every 5 minutes. - Every 15 Minutes: Refreshes every 15 minutes. - Every 1 Hour: Refreshes every hour.
Time zone Selection	A dropdown for selecting the time zone to apply to the data shown in the dashboard.
Bottom Buttons	- Cancel: Discards any changes made in the "Publish this dashboard" window. - Save: Saves all changes to the dashboard’s sharing and interaction settings.

This version includes the Cancel and Save buttons, ensuring a complete breakdown of all features available in the Publish this dashboard window after clicking the Manage button.

Edit Button

Here is a detailed explanation of the Edit Dashboard view and its elements.

Element	Description
Name Field	This field allows users to edit the name of the dashboard. The name is mandatory, and the field is marked with an asterisk (*), indicating it is required for saving the changes.
Entity Field	A dropdown menu where the user can select or change the entity to which the dashboard belongs. The current entity is displayed, and users can change it if needed. Entities are usually organizational units or service centres.
Data Time Range Field	A dropdown where users can select the data time range to be displayed on the dashboard. Options include ranges such as "Last 7 Days", "Last 30 Days", etc. The chosen time range filters the data displayed on the dashboard.
Dashboard Context Field	A text box where users can provide a description or context for the dashboard. The description can be between 1 and 50 words. This field is optional but helps others understand the purpose or details of the dashboard.
Upload Logo Image	A section that allows users to upload a logo image for the dashboard. Users can drag and drop an image or select an image manually from their files. The image size is limited to 2MB.
Chart Colour	A toggle switch that allows users to change the colour theme of the charts in the dashboard. The default option is pre-selected, but users can change the chart colour scheme based on their preferences.
Cancel Button	Clicking this button will discard any changes made to the dashboard settings and return the user to the previous page without saving the modifications.
Save Button	The Save button commits and applies all changes made to the dashboard. Users must click this button to update the dashboard with the new settings. The button is disabled if required fields are incomplete.

Logs Button

Here’s the explanation of the Logs Button in the Dashboard View in the below table.

Section	Description
Purpose	The Logs button provides access to a detailed log of activities and events related to the dashboard, including updates, data refreshes, user interactions, and system-generated events.
Activity Tracking	User Actions: Tracks when users make changes to the dashboard (e.g., editing widgets, modifying data ranges, changing chart types). System Logs: Captures background processes like auto-refresh events, system alerts, and errors.
Date and Time Information	Each log entry is timestamped, allowing users to see exactly when a particular event or action took place. This helps with auditing and troubleshooting issues.
Filtering and Search	Logs can be filtered by date range or activity type, making it easier to find specific events. Users can also search for particular actions or keywords in the logs.
Error and Performance Monitoring	Logs provide insights into errors or data discrepancies. If a dashboard fails to load data correctly, logs may show system errors or timeouts that occurred, assisting in troubleshooting.
Security and Access Monitoring	Logs track who accessed or modified the dashboard, allowing administrators to monitor user activity. This is useful for maintaining security in shared environments.
Use Cases	Troubleshooting: Logs help identify errors during data refreshes or system processes. Audit Trails: Provides a detailed history of who made changes and when. System Monitoring: Identifies performance issues or inefficiencies.
Summary	The Logs button is a valuable tool for monitoring dashboard events and activities. It supports troubleshooting, auditing, and tracking user and system interactions, helping maintain the dashboard’s integrity and performance.

Charts Button

Chart Type	Description
Line	A line chart connects individual data points with a line, ideal for showing trends over time or continuous data. It is useful for tracking changes, such as occupancy rates.
Scatter	A scatter plot displays individual data points on two axes to show relationships or correlations between variables. Commonly used to spot patterns or anomalies.
Column	A column chart shows data in vertical bars, useful for comparing quantities across different categories, like the number of entries per floor.
Pie	A pie chart divides a circle into slices, where each slice represents a proportion of the total. This is good for showing percentage-based data like occupancy ratios.
Bar	Similar to column charts, bar charts display data in horizontal bars, making it easier to compare values across multiple categories, like people entering/exiting per floor.
Stacked	A stacked bar chart shows multiple data series stacked on top of each other, allowing for comparison between categories while also showing the total.
Prediction	Uses AI to predict future data trends based on historical data, providing insights like future occupancy rates based on past patterns.
Noise Removal	Filters out irrelevant or inaccurate data points to provide clearer and more accurate results in charts and visualizations.
Horizontal Bar	A horizontal bar chart is another variation of the bar chart but oriented horizontally, often used when category names are long or for easier comparison of values.
Area	An area chart is similar to a line chart, but the area under the line is filled in, making it useful for showing cumulative totals over time.
Pareto	A Pareto chart combines bars and a line graph, often used for identifying the most significant factors in a dataset based on the 80/20 rule.
Stick	A stick chart presents data as vertical sticks. This is often used for specific financial or categorical data points.
Heat	A heat map shows data through variations in colour, useful for identifying patterns or outliers, such as which areas in a service centre are most occupied.
Pyramid	A pyramid chart displays hierarchical data in a triangle, useful for visualizing proportions or steps in a process.
Tree Map	A tree map displays hierarchical data as nested rectangles. The size of each rectangle represents the size of the data point, ideal for showing part-to-whole relationships.
Funnel	A funnel chart shows stages in a process and highlights drop-offs, commonly used for sales funnels or monitoring conversion rates.
Donut	A variation of the pie chart where the centre is hollow. It is used for showing percentage-based data in a visually distinct way.

Tables Button

Option	Description	Use Cases	Data Displayed
Table	Inserts a standard table widget to display structured data in rows and columns.	Numerical data, raw records, summaries of data points.	User-defined columns and rows, displaying customized data.
Event Log	Inserts a table that logs historical and real-time events related to the dashboard.	Auditing user/system activity, tracking data refreshes or alerts.	Timestamps, event types (login, updates, errors).
Event Detail	Provides detailed information about specific events on the dashboard.	Reviewing specific actions or events (sensor triggers, user actions).	Detailed event information, including timestamps, event descriptions, and affected sensors/devices.
Sensor Status	Displays real-time data on the status of sensors.	Monitoring sensor health, detecting active/inactive sensors, troubleshooting sensor issues.	Sensor activity status (active/offline), battery level, error messages.
Sensor Condition	Monitors sensor performance and health over time.	Ensuring optimal sensor operation, tracking maintenance needs.	Sensor health metrics, uptime/downtime history, potential performance issues.

Info Box Button

Option	Description	Use Cases	Example
Standard	Displays general information or key metrics.	Showing total counts, such as people entries or exits, or general system performance.	Total entries, total exits.
Time	Displays time-related data.	Displaying time elapsed since an event, or current time metrics.	Time since last data refresh, current time.
Sensor Events	Shows how many times a sensor has been triggered.	Monitoring specific sensor activity.	Number of times a temperature sensor triggered an alert.
Event Count	Displays the number of times a specific alert has been triggered.	Tracking system alerts or security breach events.	Number of times an occupancy limit was exceeded.
Device	Monitors the status of devices connected to the system.	Tracking whether devices are online, active, or offline.	Status of a camera system or access control device.
Users	Shows data related to user activity.	Monitoring how many users are currently active or logged in.	Number of active users, user logins.
Sensor Data	Displays real-time data from sensors.	Monitoring sensor readings like temperature, occupancy, or other real-time environmental metrics.	Temperature readings, occupancy levels.
Messages	Displays system messages and alerts.	Keeping users informed about important system notifications or alerts that require action.	Low battery warnings, service outage alerts.
Services	Tracks and monitors the status of system services.	Ensuring services like system health checks or maintenance services are running properly.	Service uptime, maintenance schedules.

Here’s a detailed explanation of the Interactive Button in the AlphaX dashboard, along with its five widget options.

---

Interactive Button

Option	Description	Use Cases	Example
Heatmap	Visualizes data intensity or concentration using colour gradients.	Identifying high-traffic areas or zones with the most sensor activity.	Heatmap of most-used entrances or exits in a building, or showing areas with the highest sensor activity.
3D Model	Displays and interacts with 3D models of objects or spaces, allowing users to view from various angles.	Monitoring 3D spaces, equipment, or visualizing complex environments, especially useful for facility management.	3D model of a building’s interior, showing sensor placement or occupancy levels across different floors.
Map	Displays geographical data using a map interface, showing the location of various entities (e.g., sensors, users, assets).	Tracking the movement of people, assets, vehicles, or real-time activity across different geographical locations.	Map showing the real-time location of service centres with occupancy data, or tracking the movement of assets.
Alert Map	Highlights areas on a map where alerts or abnormal activities have been triggered.	Monitoring regions that need immediate attention, such as over-occupied zones, sensor malfunctions, or security breaches.	Map showing a specific floor where occupancy limits have been exceeded, or highlighting areas with sensor alerts.
Controls	Adds interactive controls (e.g., dropdowns, sliders, date pickers) that allow users to adjust what data is displayed in real-time.	Filtering data by specific parameters such as time, location, or sensor type, based on user-selected criteria.	Date picker that allows users to filter data by a specific time frame, or a dropdown to select and view a particular sensor.

More Button

Option	Description	Use Cases	Example
Image	Displays images on the dashboard.	Showing floor plans, data visualizations, or relevant photographs.	Uploading and displaying a chart or photo relevant to the data being monitored.
Text	Adds freeform text to provide detailed explanations or labels.	Adding descriptions, instructions, or labelling key data for user clarity.	Text explaining the data trend shown in a widget or providing context for a report.
Note	Inserts brief notes or reminders for quick reference.	Providing annotations, reminders, or brief descriptions.	A note highlighting an important metric or threshold for quick reference.
Link	Inserts hyperlinks to external resources.	Linking to external reports, documents, or other websites for additional information.	A link to an external performance report or documentation for further reading.
iFrame	Embeds external web content (such as live reports or websites) directly into the dashboard.	Integrating third-party web content like reports, data sources, or live video feeds.	Embedding a real-time weather report, live video feed, or external data source into the dashboard.

Data Visualization Section (Charts, Tables, Widgets)

This section includes various widgets displaying live data and metrics. Each widget has its own controls. This below table shows the actions buttons explanation of all charts and widgets.

Action Button	Description	Use Case
Aggregate Options	Final stage aggregation of data (e.g., sum, average).	Summarizing large datasets to show key statistics like totals or averages.
Manage Button -> Edit Widget Window	Opens the Edit Widget window with options in Default and Advanced tabs. Allows users to add/delete sensor data and configure widget settings.	Customizing how data is presented in the widget, including adding/removing sensors, adjusting precision, or changing colours.
Default Tab	Provides basic options for editing widget settings such as title, data source, and sensor data. Allows adding or removing sensor data and customizing the widget.	Modifying sensor data displayed and configuring the widget’s title and basic settings.
Advanced Tab	Contains advanced settings, including Precision and Colours. Allows detailed configuration of how the data is displayed, especially for Info Boxes.	Adjusting the level of precision of data (decimal points), adding colours, and inserting links to external documents or websites.
Precision Drop-down	Allows users to set the precision of displayed numerical data from 0 to 5 decimal places.	Setting decimal precision for data display (e.g., showing occupancy rates with two decimal points).
Insert Link (Info Boxes Only)	Adds a link to the widget that can direct users to an external page or document.	Embedding an external link in the widget to provide additional information or resources.
Colours (Info Boxes Only)	Allows customization of the widget’s colour scheme, including background and text colours.	Changing the widget’s appearance to match dashboard themes or improve visual distinction.
Cancel Button	Discards any changes made in the Edit Widget window.	Cancelling changes to widget settings.
Save Button	Saves any changes made in the Edit Widget window and applies them to the widget.	Saving updates to widget settings.
Maximize/Minimize Options	Maximize expands the widget to full-screen for focused analysis. Minimize restores the widget to its original size on the dashboard.	Maximizing widgets for presentations or detailed analysis, then minimizing them to fit back into the dashboard layout.
Close Widget (Delete)	Clicking Close opens a confirmation window asking the user if they want to remove the widget from the dashboard.	Removing a widget from the dashboard permanently.
Close Widget: Removal Confirmation	When a user clicks Close, a new window appears with the message: "Are you sure you want to remove this widget?" Buttons: No cancels, Confirm removes.	Ensuring that users are certain before they permanently delete a widget.

3.Duplicate Button

Clicking the Duplicate icon opens a confirmation popup, allowing users to duplicate a dashboard, modify the default name, and either confirm or cancel the duplication process.

Element	Description
Popup Title	Displays "Duplicate Dashboard" to clearly indicate the action being taken.
Message Text	"Are you sure you want to duplicate Dashboard [Dashboard Name]?" This ensures users understand the specific dashboard being duplicated.
Name Field	A field with the default value "Copy of [Dashboard Name]", allowing the user to modify the name of the duplicated dashboard.
Cancel Button	Cancels the duplication process and closes the popup. Located at the bottom-left in Gray.
Confirm Button	Finalizes the duplication process, creating a new dashboard with the specified name. Located at the bottom-right in blue.

4.Delete Button

In the AlphaX Dashboard, when you attempt to delete a dashboard, a Delete Confirmation Window appears to ensure that the action is intentional. This confirmation step prevents accidental deletion and gives users the option to either proceed with or cancel the action.

Element	Description
Delete Confirmation Popup	Appears at the centre of the screen when the Delete icon (trash bin) is clicked, ensuring users do not accidentally delete dashboards.
Message Text	Displays: "Are you sure you want to delete Dashboard [Dashboard Name]?", clearly identifying the dashboard to be deleted (e.g., "Are you sure you want to delete Dashboard Standard?").
No Button	Purpose: Cancels the deletion process and closes the confirmation window. Location: Bottom-left, Gray colour.
Confirm Button	Purpose: Finalizes the deletion and permanently removes the dashboard. Location: Bottom-right, red colour (indicating the severity of the action).
Confirmation of Deletion	Once confirmed, the dashboard is permanently deleted and removed from the list of available dashboards.

Navigation Buttons at the Bottom

Below the dashboard table, navigation buttons allow users to move through multiple pages of dashboards:

Button	Description
Previous	Navigates to the previous page of the dashboard list.
Page Numbers	Displays the current page and allows jumping to a specific page.
Next	Moves to the next page of dashboards.

Note : This design ensures that users can efficiently navigate through the dashboard listings, manage individual dashboards, and easily create new ones with the essential fields and customizable options.