Starting the Control
To start the control click on the “Assets” button in the upper left corner of the PI Vision display.
In the upper part select “weruStackedBar” by clicking on it.
Afterwards the desired attribute from the asset tree could be added to the display via drag and drop. The StackedBar control appears on the display and can be used.
Adding additional Attributes
When the control is already present on the display, it is possible to add more attributes by dragging and dropping them on the control.
Configuration
With a right click on the control it is possible to press "Configure". Thereby the configuration tile appears.
With Group By it is possible to select how the Data should be grouped. So it is possible to get values for the following selections:
Days
Weeks
Months
Years
Quarters
Category-Tag
With Category-Tag you can set a PI-Tag that will be used to Categorise your data.
(This Option is only shown and used when Category-Tag was choosen in the option Group By)
With Data Mode the aggregation function can be determined. The following functions are available for selection:
Sum
Minimum
Maximum
Average
Average (Event Based)
First value
Last value
With Decimal Places it is possibile to set how many decimal places should be shown.
Offset Data makes it possible to artificially show a time range one time unit before the current PI-Vision time.
Tag Configuration
The “Tags” section in the configuration pane allows to rearrange, rename and remove individual tags and attributes that have been assigned to the symbol.
Rearrange
The list in the upper part contains all signals which are used by the symbol. To order can be adjusted by selecting a signal in the list with the left mouse button and pressing the arrow buttons underneath to shift the signal upwards or downwards in the list.
Rename
The display name of a PI-Tag or attribute can be changed by selecting the signal in the list and then clicking on the name in the lower part of the configuration. This provides the possibility to choose between
Element | Attribute Name
Element
Attribute Name
A custom name
For PI-Tags it is only possible to choose the PI-Tag name or a custom one.
Remove
A signal can be removed by selecting it in the list and then clicking on the trashcan icon in the lower left corner.
Coloring
Every Signal gets a color assigned by default. The assigned color can be adjusted through the configuration pane by selecting the signal in the list and then using the color picker in the lower right corner to select a new one. The changes are applied as soon as the user closes the dialog.
Legend Configuration
The Legend Section in the configuration pane allows to specify how the legend of the symbol should be displayed.
Legend Mode
Allows to set the overall appearance of the legend in three modes:
Normal: Names of signals are displayed from left to right. If there is not enough space, the legend expands over multiple rows.
Scroll: Names of signals are displayed from left to right. If there is not enough space, they are paginated and the user can scroll from left to right to see all.
Off: The legend is turned off and not visible.
Space for Legend
If the legend interferes with the chart, the user has the possibility to specify an offset in pixels to adjust the height of the legend. Needs to be a whole number.
Show Units
Can be deactivated to not show the Unit of Measure to the user.
Text Configuration
The Text section in the configuration pane allows the user to configure a variety of settings with regards to text, like title, font sizes and text colors.
Font Size
The Font Size can be adjusted by setting a whole number.
Text Color
The text color is set automatically by default. depending on the background color of the display. If the background color is bright, the text color is set to black, if the background color is dark, the text color is white.
By disabling the checkbox “Use Automatic Text Color” a new color picker pops up below the checkbox allowing the user to specify a custom text color.
Title
The checkbox “Show Title” can be checked to enable the title and set further options:
Title: The title that is shown in the symbol
Title Font Size: The font size of the title
Title Color: Only available, if “Use Automatic Text Color” is disabled. Allows to set a custom text color for the title
Change the Size of the Control
In a first step you need to go into edit mode (Icon in the upper right corner) and in a second step to click on the control. The eight appearing dots around the control can be used to adjust the size that everything is visible.
Removing the Control
Before removing the control it is necessary to switch into edit mode (Icon in the upper right corner). Thereafter it is possible to click on the control and press the delete key to remove the control.