A Line widget can display an Asset’s data in one of two Scopes: Aggregated Data or Raw Value. You select the Asset types display, which tags to display, determine the data to display, organize how the data is presented, and then customize the line appearance.
Note that you can include only a single line widget per dashboard. Each widget can display up to 4 lines of data.
After you drag & drop a widget onto the Canvas, the Wizard opens and leads you through the required steps.
Here you select the Asset Type, the Asset Properties, and the Tag Data you want to present in the widget.
You can select more than one Asset Type.
Note that this widget has three default Asset Properties: Asset ID, Asset Name, and Data Timestamp.
Under Tag data, note that if you select more than 4 tags, the user will be able to select 4 of those tags to view in the widget.
When you have finished, click Next to continue.
Select the widget Scope.
Scope determines which data is displayed, and how it will be displayed; available options depend on the widget type.
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, 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.
Tags and Asset properties you selected in Step 1 will be shown in Available Data.
This is where you determine:
Which tag data will be expressed as lines.
How that data will be filtered.
The behavior in this step depends on the Scope you have selected in Step 2.
You cannot add or delete properties, but
you can change the order by dragging the properties using the drag handle
.
Drag the data you want to show into the Data and Metrics field.
· Each tag becomes a line.
Note
that:
- The first tag you place here serves as the Y-axis in the widget.
- You can display up to 4 lines of data.
If you select more than 4 tags, the widget enables the end-user to select
which 4 tags will be displayed. If you select fewer than 4, in the next
step, Customize, you can enable the user to view each line individually.
· The order of the tags sets the order of the lines, and the tag name is automatically assigned to the line (you can assign an alias name in Customization).
· You can change the order by dragging your selections into a different order.
· The first tag serves as the Y-axis in the widget (you can select a different Y-Axis in Customization.)
Aggregated data only:
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.
Multiply or Divide by Factor
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.
Tip |
To learn more, see Multiply or Divide by Factor. |
You can filter your data to display it according to your selected parameters, such as time, date, or size.
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.
You can customize your widgets to effectively display your data, according to your dashboard requirements.
You can enter a Widget Name—a display name
for the title bar and customize the appearance of your widget, including
Lines, Axes, Tooltips, Legend, and more.
As you work, the Preview shows your changes.
· Line name: the default name is the Tag name; type in a Line name as an alias to display in the widget.
· Colors: click a color box and use the Color Picker to assign specific colors.
Show Y-Axis: click the drop-down arrow and select Left or Right to show this tag as a Y-Axis value.
Y-Axes name: the default name is the Tag name; type in text as an alias to display in the widget.
Decimal digits: enter the number of decimal places you want to display in the axis.
Y-axes Scale: click the drop-down arrow and select Manual to set the desired values. In the next image, you can see different values assigned to each axis.
In the next image:
- Pressure is selected as Y-Axis on the left, with Bar assigned
as the axis name, and the value scale set to Auto
- TEMPERATURE is selected as a Y-Axis on the right, with Temp C
assigned as the axis name, the scale is set to Manual, from 0 to 100.
If you select less than 4 tags, the option Allow tag selection is visible.
Check it to enable your user to select which tags to view.
If you have selected more than 4 tags, this option is not visible--the feature is automatically included
Brush Display is an additional feature that allows your users to select an area and zoom in. Note that in:
Raw Data: Brush Display is always on,
Aggregated Data: Brush Display is off by default, select it to enable it.
To zoom in with Brush Display, drag the margins edges to the areas you wish to display, then move the marked area to zoom into the desired section on the graph.
Subtitle: you can enter text and determine its position and color.
Legend: you can determine its position
and color.
Note that in Preview, you can click an item in the Legend to hide the
column; in the following image, TEMP average is hidden.
Tooltip: select Visible to show
a tooltip when you move your cursor over the widget; you can also
set a decimal place.
To show all of the items listed in the legend, select Show Axis Legend.
Data Labels: select Visible and set a color to display the value of each column on the column itself.
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.
Here you configure which dashboard UniCloud will display in response to user clicks. Navigation is not mandatory, and can be left undefined.
Tip |
To learn more, see the Dashboard Navigation guide. |
When you are done, click Finish to return to the Dashboard Canvas.
The widget you have just configured will be displayed at its default size and may be resized and repositioned.
Click to see how an end-user can select tags to view live, online in the widget.
Click to see how an end-user can select different Assets, delete tags and view two Assets simultaneously, and use Brush view to identify specific data points live, online in the widget.