Trend actions
Used for Live Data Trends and Historical Trends Widget.
RefreshTrend
Refreshes the Trend window.
It can be used in any Trends/Graphs widgets. Specify the widget as a parameter for the action.
ScrollLeftTrend
Scrolls the Trend window to the left side, by one-tenth (1/10) of the page duration.
Note: with the real-time trends pause the trend using the PauseTrend action, or the window will be continuously shifted to the current value.
ScrollRightTrend
Scrolls the Trend window to the right side, by one-tenth (1/10) of the page duration.
Note: with the real-time trends pause the trend using the PauseTrend action, or the window will be continuously shifted to the current value.
PageLeftTrend
Scrolls the Trend window by one-page. For example, if the page size is 10 minutes, then use the PageLeftTrend action to scroll the trend left for 10 minutes.
PageRightTrend
Scrolls the Trend window by one-page. For example, if the page size is 10 minutes, then use the PageRightTrend action to scroll the trend right for 10 minutes.
ScrollUpTrend
Scroll the trend window up by 1/10 of the period.
ScrollDownTrend
Scroll the trend window down by 1/10 of the time period.
PageUpTrend
Scroll up the trend window page by page.
PageUpTrend
Scroll up the trend window page by page.
PageDurationTrend
Sets the page duration of the Trend window.
Define trend name and page duration.
Note: you can set page duration at runtime using a combo box widget.
ZoomInTrend
Reduces page duration.
ZoomOutTrend
Extends page duration.
ZoomResetTrend
Reset the zoom level back to the original zoom level.
ZoomInYAxisTrend
Reduces Y Axis.
ZoomOutYAxisTrend
Extends Y Axis.
ZoomResetYAxisTrend
Reset the Y Axis zoom level back to the original zoom level.
PauseTrend
Stops plotting the trend curves in the Trend window.
When used with real time trend the plotting stops when the curve reaches the right border of the graph. This action does not stop trend logging.
ResumeTrend
Resumes trend plotting if paused.
ShowTrendCursor
Shows value of the curve at a given point on the X axis.
It activates the trend cursor. A cursor (vertical line) will be displayed in the trend widget.
When the graphic cursor is enabled, the scrolling of the trend is stopped.
The ScrollCursor action moves the graphic cursor over the curves, or over the entire Trend window.
ScrollTrendCursor
Scrolls the trend cursor backward or forward.
The Y cursor value will display the trend value at the point of the cursor. Scrolling percentage can be set at 1% or 10%. The percentage is calculated on the trend window duration.
| Parameter | Description |
|---|---|
| Trend Name | Select the trend widget ID. |
| Scroll Direction | Sets the scroll direction. |
| Scroll Unit | Sets the scrolling as a percentage of the displayed area or as a unit of time. |
| Scroll Percentage | Set the scroll rate as a percentage of the displayed area (used when Scroll Unit = Percentage) |
| Scroll Timesample | Set the scroll rate as time in seconds (used when Scroll Unit = Timesample) |
SetTrendView
Use this macro to change the axis ranges of the trend view.
When both Min X=0 and Max X=0, the static values defined inside the properties of widget are used. The same for the Y axe.
ScrollTrendToTime
Scrolls the Trend window to a specified point in time.
Use this action when you need to scroll to a specific position in a trend window when a specific event occurred.
| Parameter | Description |
|---|---|
| Trend Name | Select the trend widget ID. |
| Scroll To Position |
Reference position for scrolling the trend window
|
| Scroll Trend to Time | Time where move the trend window |
Example
- Configure an action for an event (for example, an alarm) that executes a data transfer of the system time into a tag.
- Select that tag as ScrollTrendtoTime parameter: the trend windows will be centered at the time when the event was triggered.
ConsumptionMeterPageScroll
Scrolls the page backward or forward in a Consumption Meter widget.
| Parameter | Description |
|---|---|
| Trend Name | Trend widget ID (for example, TrendWindow3) |
| Page Scroll Direction | Direction of page scrolling (Forward/backward) |
RefreshTrendTable
Update the trend table.
| Parameter | Description |
|---|---|
| Data Source | The data source of the trend table to refresh |
ScrollTrendTableBackward
Scroll the trend table backward.
| Parameter | Description |
|---|---|
| Data Source | The data source of the trend table to scroll backward |
ScrollTrendTableForward
Scrolls the trend table forward.
| Parameter | Description |
|---|---|
| Data Source | The data source of the trend table to scroll forward |