Widgets enable you to display data from multiple Assets on your Dashboards.
Using widgets, you can display static images and text, dynamic values from a single tag, as well as geographic location and alarm status. You can display data tag values in tables and in graphic charts.
Widget options differ from widget to widget, but all widgets offer options to customize appearance, and all allow you to set up Navigation, allowing a user to jump to another Dashboard.
Widgets that display tag values and asset properties offer a Scope option. The following table shows the list of available widgets.
|
|
Scope |
||
Widget |
What you can display |
Aggregated |
Last |
Raw |
Assets’ Tag data in Table form, including timestamp & date, Asset Properties |
x |
x |
x |
|
Assets’ Alarm Status in Table form, including Alarm index, Active Status, Severity, timestamp & duration, Asset Properties |
x |
x |
x |
|
A fixed, uploaded image |
|
|
|
|
Images according to the current value of a single Boolean or Numeric tag. |
x |
x |
|
|
Fixed text |
|
|
|
|
Data from a single tag |
x |
x |
|
|
Data from a single tag is displayed according to the current value of the tag, displays values including icons, colors, and text assigned to a range. |
x |
x |
|
|
Update Asset widgets enable a dashboard user to directly access a controller and modify tag values, writing the new values to the controller memory. |
||||
A Switch widget enables a dashboard user to directly access a controller and click a button to modify a single Boolean tag value, changing the value in the controller memory. |
||||
Graphically express Assets’ Tag data, as a columns chart, along an X, Y axis, including timestamp & date, Asset Properties |
x |
x |
|
|
Graphically express data from a single tag, as a pie chart |
x |
x |
|
|
Graphically express data from a single tag, as a line. 1 line widget per dashboard |
x |
|
x |
|
Graphically express the data from a single tag as a radial gauge. |
x |
x |
|
|
Graphically express the data from a single tag as a linear gauge. |
x |
x |
|
|
Graphically display the current value of a single data tag in relation to a maximum value which you set in the widget |
x |
x |
|
|
Shows the Geographic location of one or more Assets on a map. When the user moves the cursor over the Asset on the map, a popup displays data according to tags you select in the widget |
||||
(UniStream only) Display a VNC window showing a specific Asset’s PLC. |
||||
(UniStream only) Display a window showing a specific Asset’s web pages |
To place a widget on the Dashboard Editor, click the a group on the widget carrousel, select the widget drag & drop it onto the canvas. The widget Wizard opens automatically to lead you through the steps of widget configuration.
When you are done, drag the widget to position, and drag the widget’s borders to resize it. You can toggle Show/Hide grid to aid you in positioning widgets.
Note that if you include the User Filters widget, it is automatically placed at the head of the Dashboard, and cannot be moved or resized.
1 |
Canvas |
This is the design area for the Dashboard. Note that if you include the User Filters widget, it is automatically placed at the head of the Dashboard, and cannot be moved or resized. |
2 |
User Filter |
Click to place a User Filter Widget at the top of the dashboard. |
3 |
Widget Carousel |
You can click a widget group to open it, then drag & drop it onto the canvas; the Wizard opens to walk you through the stages of configuring the widget. |
4 |
Grid |
Show/Hide Grid: use this to toggle the grid on/off when you are working on the Canvas. |
5 |
Clipboard |
To copy widgets: 1. Click the Copy icon on the widget; it will appear in the Clipboard. 2. Drag it from the Clipboard. 3. Drop it in the desired position; the Wizard will open automatically for you to make changes. Note that the widget remains on the clipboard, and can be used multiple times. It will remain on the Clipboard until you copy a different widget. |
|
The automatic Wizard is specific to each widget, and only shows you the available options. In the case of the:
Image Widget, the first step is to include the image you want to display.
Text Widget, the first step is to enter the text to display, and to customize the appearance.
All other widgets include the steps shown in the image in Step 1 below.
When you complete a step, the Next button on the bottom right becomes enabled; click it to continue to the nest one. You can click on the step numbers to navigate back and forth between completed step.
Select the Asset Type, the Asset
Properties, and the Tag Data for the widget.
Note that under Data, you can also select All Asset Types; this is useful,
for example, in the case of the Map widget as this easily enables the
Map to display all assets in the organization along with the selected
properties. When you select All assets, but Tag Data will be disabled.
Select the widget Scope.
Scope determines which data is displayed, and how it will be displayed.
Scope options depend on the widget type you select; UniCloud disables (greys out) any options that are not available.
Scope types include:
Aggregated Data
Enables you to collect data from specified tags over a specific time
period, and to automatically calculate and display the result of calculations
such as average, minimum, maximum, delta, sum, and count. You can
select how to sort and filter the displayed results.
Last Value
Select this to display the most recent value of the selected tags.
You can select how to sort and filter the displayed results.
Aggregate by Last Value
Enables you to take the most recent value of the selected tags and
to automatically calculate and display the result of calculations
such as average, minimum, maximum, delta, sum, and count. You can
select how to sort and filter the displayed results.
Raw Data
Enables you to view historical data--sequential raw data of up to 50k
records from the selected tags.
Make your selection, and click Next.
The Data Tags and Asset properties selected in Step 1 will be shown in under Available Data.
The options for Organization depend on the widget type, and also on the Scope you have selected for the widget.
All of the selections you make are reflected in the Preview window.
Not all widgets offer the Group By option;
in addition, some widgets do not offer it if Last Data is selected for
Scope. Where available, use the drag handle to
drag & drop your selections into the Group By field. In widgets
that allow multiple entries, you can drag your selections into a different
order.
Note that if a drop-down arrow is displayed, you can select a specific data property; in the following image Daily has been selected for Data Timestamp.
Drag the data you want to show into the Data and Metrics field. Note the drop-down arrows that enable you to perform calculations on the collected tag data.
After you drop a tag into the field, click the drop-down arrow and select the calculation, or calculations, to display; each selection becomes a column heading.
Calculations include Min, Max, Delta, Count, Sum, and Average.
In widgets that allow multiple data, you can drag your selections into a different order.
You can use Tag Calculations to build an expression that uses the values of tags you include in data and Metrics and provides a calculated result.
To build an expression:
Click the Tag Calculations drop-down; the tags you included in Data and Metrics will be listed there.
Click the Expression icon;
the Expression builder opens.
To build the Expression:
Click Add Tags and select the ones for your calculations.
Select arithmetical operators from the toolbar, or enter them using your keyboard.
Include numerals by typing them.
When you are done, click Save.
The Data Preview adjusts the values to show your changes.
Multiply (or Divide) by Factor (Update Asset Widget Only)
Note that Multiply (or
Divide) by Factor is available for the Update Asset Widget only.
Previous to June 2022, this feature was available for use in other widgets.
If this feature was used in dashboards created previous to June 2022,
the functionality remained, and was automatically replaced by Tag
Calculations.
In Update Asset Widgets, you can apply a factor to multiply or divide the
value of a numerical tag or aggregated data, in order to display the modified
values on Dashboards.
To apply a Factor:
Click the Multiply by Factor drop-down; the tags you included in Data and Metrics will be listed there.
Under Action, click and select Multiply or Divide.
Under Factor, click in the field and use the Up/Down arrows to select a value
As you edit your selections, the Data Preview will adjust the values to show your changes.
Not all widgets offer filtering.
Widget filtering will be limited by any Dashboard Filter setting, as well as by the User Filter Widget.
Use the available options to filter your data and display it according to your selected parameters, such as time, date, or size.
To filter data:
Drag elements from the Available Data into the Filters field.
Use the drop-downs to filter a specific element.
Create more complex filtering expressions by including multiple elements and conditions.
If a widget offers sorting you can use the options to display your data in a specific order.
To sort the data:
Drag elements from the Available Data into the Sort field.
Use the drop-downs to sort it.
You can customize your widgets to effectively display your data, according to your dashboard requirements. As you work, the Preview shows your changes.
You can:
Enter a Widget Name—a display name for the title bar.
Hide
the Widget Header and Border.
The next image shows how the same widget appears in a Dashboard, with
and without the Header and Boarder.
Other Customization options differ according to widget type;
Refer to the Overview topic of each widget type for details.
The color picker works on the same principles for all Dashboard elements.
Click a color square to open the Color Picker.
Select the Color in the selection bar.
Click the color field, and drag your cursor to the desired color.
Click OK; the element will take on the color of your selection.
The following image shows a shade of red being applied to a table row background.
All widgets offer Navigation.
Navigation enables you to configure which dashboard UniCloud will display in response when a user clicks on a widget.
Below, an image widget is set, when clicked, to jump to the Maintenance Dashboard.
You can also navigate to an external site. Select Open URL in a new tab;
this enables you to enter the address.
Multiple Asset Types
In the next image, a Table widget has been configured under Data to include two Asset types.
When a user clicks on an:
Asset that belongs to Asset Type “Demo Case”, UniCloud jumps to Dashboard ‘Water Flow Details’
Asset that belongs to Asset Type “Unitronics Pump System”, UniCloud jumps to Dashboard ‘Maintenance’
Navigate by Asset Type, Filter by Asset ID
In the next image, Navigation is mapped by Asset Type, and is also filtered by ID.
When a user clicks on an:
Asset that belongs to Asset Type “Demo Case”, UniCloud jumps to Dashboard ‘Water Flow Details’, but only shows the details for the specific Asset that the user clicked.
Asset that belongs to Asset Type “Unitronics Pump System”, UniCloud jumps to Dashboard ‘Maintenance’. but only shows the details for the specific Asset that the user clicked.
The widget you have just configured will be displayed at its default size.
You can drag it to reposition it on the dashboard Canvas, and drag the widget borders to resize it. Your screen may resemble the image below:
When you copy a widget and paste it, UniCloud opens a
popup, asking if you want to Replace Tags.
This allows you to swap the original
Asset/s for different Assets, while maintaining widget design.
Use it to replace the original Properties and Tags with other tags, tags
that belong to the new Asset.
Note that UniCloud will allow you to select only replacement tags that are the same type as the original, for example, Bit tag to Bit tag, Float to Float.
*Delete the property shown in the Replace column to enable the list
of compatible tags
**Edit
the widget where required (For example, Table column names)
Remember that you may need to edit the widget to suit the new Asset.
1. To begin:
- Click Confirm to open Replace Tags.
or
-If you select Don't Show Again, you can click Replace Tags on the upper
right of the screen to open it.
2. Click to
remove the original Asset.
3. Click on
the drop-down, and select the desired Asset or Assets.
4. Click the
Asset Properties drop-down.
5. Click to
remove the property you want to replace, then select the replacement property
from the drop-down.
6. Click to
close Asset Properties.
7. Select
Tag Data (you may have to scroll down to see the available tags)
Note that UniCloud will only show tags of the type that are eligible for
selection.
8. When you
have finished selecting replacement Properties and Tags, click Finish,
and continue to edit the widget according to your requirements..