Functional explanation
TrendObject displays live trends for one or more variables. It is used on operator pages where recent process values must be compared over time.
The object is useful when the user needs to see recent process history directly on the page. It is a display object rather than a simple shape and usually combines multiple variables, scaling, and time range controls. The history of each pen is read from the history source of its variable; see the History Sources article. When the history of a pen cannot be read, the chart shows the reason as its tooltip.
Use TrendObject for immediate operational visibility. Use Trend Analyst when the user needs deeper historical analysis and reusable trend configurations.
Object name
Set the object name shown in the trend decorator context.
| Setting | Description | Example | Units |
|---|---|---|---|
| Object Name | Name used to identify the Trend object. | ProcessTrend | Text |
No rows match the filter.
Settings
Configure the trend title, time range, global display options, and line styling.
| Setting | Description | Example | Units |
|---|---|---|---|
| Title | Trend title text. | Process Trend | Text |
| Time Span | Time range shown by the trend. | 8h | Text |
| Editable | Allows the trend settings to be edited by the operator at runtime. | false | Boolean |
| Display X Axis | Shows the X axis when enabled. | true | Boolean |
| Display Title | Shows the title when enabled. | true | Boolean |
| Display Legend | Shows the legend when enabled. | true | Boolean |
| Line Width | Line width used for the trend series. | 2 | px |
| Point Width | Point width used for the trend series. | 6 | px |
| Point Radius | Point radius used for the trend series. | 3 | px |
| Background Color | Background color used for the trend panel. A gradient can be used here as well as a single color; see the Gradients section of the Color Library article. | #FFFFFF | Color |
| Text Color | Text color used for the trend labels. | #212529 | Color |
| Y Axis Color | Tick label color of the Y axis. Applies to the scales of all series. | #333333 | Color |
| X Axis Color | Tick label color of the X axis. | #333333 | Color |
| Grid Horizontal Color | Color of the grid lines belonging to the X axis. Defaults to white, so set it explicitly on a dark page. | #e0e0e0 | Color |
| Grid Vertical Color | Color of the grid lines belonging to the Y axis. Defaults to white, so set it explicitly on a dark page. | #e0e0e0 | Color |
| Tooltip Background Color | Tooltip background color. | rgba(0,0,0,0.8) | Color |
| Tooltip Text Color | Tooltip text color. | #ffffff | Color |
No rows match the filter.
Series
Configure the trend series. Each series has its own variable, colors, scale, and display options. Settings with a number suffix (2, 3, 4) apply to the corresponding series.
Four series are drawn on the chart. The designer also stores Variable 5 to Variable 8, which are reserved for a future extension and stay off the chart. Place a second Trend on the page to show more than four series.
| Setting | Description | Example | Units |
|---|---|---|---|
| Variable 1-4 | Variable or expression for the series. Variable 5 to Variable 8 are stored by the designer and stay off the chart. When the series is one variable with a Format, the tooltip shows the value with that Format. | PLC1.Temperature | Expression |
| Description | Optional legend text for the series, shown in the legend and the tooltip instead of the variable name. When empty, the variable name is shown. The text is collected by the Project Language Texts export on the Parameters page and shown in the user's language at runtime. | Inlet temperature | Text |
| Line Color | Line color for the series. | #0d6efd | Color |
| Dot Color | Dot border color for the series. | #0d6efd | Color |
| Dot Background Color | Dot fill color for the series. | #FFFFFF | Color |
| Scale Min | Minimum Y-axis scale for the series. | 0 | Value |
| Scale Max | Maximum Y-axis scale for the series. | 100 | Value |
| Scale Position | Y-axis position for the series scale. | left | Enum |
| Hide Scale | Hides the Y-axis scale for the series. | false | Boolean |
| Stepped | Uses stepped line interpolation for the series. | false | Boolean |
| Filled | Fills the area under the line for the series. | false | Boolean |
| Hide Point | Hides the data points for the series. | false | Boolean |
No rows match the filter.
Position / Size
Configure the position and size of the Trend object.
| Setting | Description | Example | Units |
|---|---|---|---|
| Top | Top position of the object. | 100 | px |
| Left | Left position of the object. | 220 | px |
| Width | Width of the object. | 600 | px |
| Height | Height of the object. | 300 | px |
| Z-index | Layer order of the object. Higher values appear in front of lower values. | 10 | Number |
No rows match the filter.
Visibility
Configure the runtime visibility and blinking behavior for the Trend object.
| Setting | Description | Example | Units |
|---|---|---|---|
| Visibility | Expression controlling whether the object is visible. | PLC1.TrendVisible | Expression |
| Blink | Expression or boolean controlling trend blinking. | PLC1.AlarmActive | Boolean or expression |
| Blink Speed | Blink speed used during runtime. | 500 | ms |
| Blink Offset | Blink offset used to stagger blinking between objects. | false | Boolean |
No rows match the filter.