A dashboard provides a way for users to modify properties of a WebWidget
in a Px View in real-time, without needing to edit it manually through the Px Editor. It also allows those modifications to be saved so that the user always sees their personalized view whenever they are logged in.
Currently, there are two out-of-the-box dashboardable WebWidgets
: CircularGauge
and Chart
from the webChart
Palette.
These Widgets
both allow a user to dynamically drag and drop applicable Components onto them so the user can see new values instantly. You can combine this feature with a dashboard to allow a user to save the override ORD and show their preferred content by default.
They remove the need to manually edit or create new Px Views every time users want to see something different.
They remove the need to create multiple “redundant” variants of a single Px View just to represent different possible combinations of data.
They eliminate the cost of training end-users on using the relatively complex Px Editor to modify the WebWidget
data themselves, as well as removing the risk of inadvertent damage that accompanies that level of editing access.
They allow that personalized WebWidget
content to be automatically propagated to other views by embedding that same Px View with dashboards into other views (like a website header).
Verify DashboardService
exists under Config > Services. If not, add a DashboardService
to Config > Services from the dashboard
Palette.
In the Px Editor, add a DashboardPane
from the dashboard
Palette.
NOTE: To adjust the size of a dashboard, you must first select the DashboardPane
in the Widget Tree
. Clicking on the dashboard on the Px page directly interacts with the mounted Widget
.
The Component-first way is the easiest way to set up a dashboard. Drag a Component from the Nav Tree
and drop it into the Widget Tree
, directly onto the content
space under the DashboardPane
(dragging onto the dashboard itself does not work!). The Make Widget
dialog box will show, allowing you to select a WebWidget
from a Palette.
This automatically sets up the dragged Component as the default ORD for the dashboard.
Alternatively, you can drag a WebWidget
from a Palette and drop it into the the dashboard’s content
space, and then set the default ORD manually.
You can open the Widget
Properties by double clicking on the dashboard itself, or on WebWidget(Content)
under the DashboardPane
in the Widget Tree
. Then modify the ord
slot under Wb View Binding
to set the default value.
If you have a custom dashboardable Widget
that is not part of a Palette, you can still add it to a dashboard.
First, add a WebWidget
to the dashboard from the workbench
Palette. Then open up the Widget
Properties, and enter the ORD for the custom Widget
in the js
slot under Web Widget
. For example: view:myFirstModule:MyFirstWidget
.
To change the content, drag and drop a new point onto the Widget
.
To save changes so that your contents load next time you view this Widget
, click the Save icon in the top area of the dashboard.
To reset to default contents, click the Reset icon (X) in the top area of the dashboard.
This functionality works in both Workbench as well as in the HTML5 Hx profile.
Check out the bajaux Making your Widget Dashboardable tutorial, the third part in a series designed to introduce bajaux basics!
You can get a working dashboard demo from the docDeveloper
Palette, including JavaScript examples.
From the docDeveloper
Palette, drag the BajauxExamples
folder onto your Config
folder.
Expand BajauxExamples in the Nav Tree, and double-click DashboardWidget
.
Copyright © 2000-2019 Tridium Inc. All rights reserved.