Configure HistoricalTrendApp properties
- Last UpdatedOct 10, 2024
- 5 minute read
The HistoricalTrendApp shows two different types of properties in the Properties area of the Layout editor. The Run-Time Behavior properties are the native properties of the HistoricalTrendApp. This topic provides descriptions of these properties.
The remaining properties are from the underlying .NET trend control that are exposed and can be assigned values from the Layout editor or included in scripts. .NET property groups are identified by the TrendControl prefix in their titles that appear on the Properties page. For example, the TrendControl.Accessibility title appears immediately beneath the Run-Time Behavior group of properties.
Descriptions of .NET properties are accessible from the Microsoft Web site and are not described in System Platform documentation. For more information about the .NET properties that appear in the HistoricalTrendApp, see .NET property descriptions at the Microsoft web site.
A .NET control enables developers to include a description using the DescriptionAttribute, as shown in the following example.
[DescriptionAttribute("Represents a double-precision 64-bit number ")]
The text shown as part of the DescriptionAttribute appears in the Description area of the Properties tab in Layout and ViewApp editors.
To configure the properties of theHistoricalTrendApp
-
Open the Layout and show the items listed in the Toolbox tab.
-
Select the HistoricalTrendApp from the Toolbox list to show its preview thumbnail.
The Toolbox pathway to the Historical Trend App is:
_Default Content > 4. Apps > AVEVA OMI Apps > HistoricalTrendApp
-
Drag and drop the preview thumbnail onto a layout pane.
-
Select the preview thumbnail on the pane and select the Properties tab.
The Properties tab shows a list of HistoricalTrend app properties. Use the Layout editor search function to search for a property by name.
General properties show the name of the control, its content type, and the name of the pane in which the HistoricalTrendApp is placed.
-
Set values to the Run-Time Behavior properties.
Important: See Upgrading HistoricalTrend App Runtime Properties for information about the Run-Time Behavior properties of the HistoricalTrendApp after upgrading to System Platform 2020.
Most HistoricalTrendApp properties include a user control with a drop-down list of binding options to configure static or dynamic value based binding between the property and its associated reference.
Constant
Static binding to the specified property value. Enter a value in the property data entry field.
In
Dynamic property value with read only binding by the control to a reference.
Out
Dynamic property value with write only binding by the control to a reference.
InOut
Dynamic property value with read/write binding by the control to a reference.
Reset
Reset the property binding value to its default.
A check box to the right of some properties indicates the initial default value of a Boolean property. When the check box is selected, the property is set to true.
Run-Time Behavior Properties
|
Follow Current Context |
Boolean value that determines if the trend shows values of the attributes belonging to the selected asset. True (default value) shows the selected asset's attribute values on the trend. The historized tags are picked from the currently selected asset in alphabetical order. The number of tags that can be shown from an asset is set by the Max Content Tags to Show property. With the property set to true, trend pens are auto-discovered and loaded asynchronously. This can cause unpredictable results if you will use the ShowContent() method to place the Historical Trend control into a pane at run time, or if the Follow Current Context property can be dynamically modified at run time. In these cases, set Follow Current Context to FALSE. Note: If Follow Current Context is set to False, the Show Tag Picker property must be set to True. IMPORTANT: In prior releases, Historical Trend App properties were not exposed. System Platform exposes a number of configurable properties and sets some to a default value. For example, in Updates 1 and 2, the TagPicker was visible when you used the Historical Trend App. In Update 3, the TagPicker is not visible by default, since tags from the current context are shown when Follow Current Context is true. For more information about automatically selecting tags to show in the trend based on the selected asset from the navigation model, see Follow Current Context Property. |
|
Max Context Tags to Show |
The number of attribute values from the selected asset that can be shown on the trend when the Follow Current Context property is set to True. 10 is the default maximum number of tag values shown on a trend, and is the recommended maximum. If more than 10 tags are shown, performance may be affected. Note: When Follow Current Context is set to False, the Max Auto Content Tags to Show property is inactive. The entered number has no meaning. |
|
Pens |
The Pens property enables you to add specific tags to be shown in the view application at run time. Note that tag names are not validated. The tags you add are in addition to the Current Context tags. See Follow Current Context for more information.
|
