Steps to configure the InSightApp
- Last UpdatedJul 18, 2024
- 4 minute read
InSightApp instance level properties are evaluated only when the default values are changed and have a higher preference over chart configuration properties set with the InSight Global Editor.
Important: You must complete all user security or authentication tasks required to access data from the Historian Client Web server. For more information about security requirements, see InsightApp security requirements.
Configuring the InSightApp is a two-step process of validating the connection to the InSight server and setting app properties.
Chart configuration properties set by the Global Editor and properties set from the Layout or ViewApp editors may not be the same. Changing any property value from the InSight Global Editor does not appear at instance level during design time. Instance level properties continue to show default values at design time.
To configure the InSightApp
-
Open the System Platform IDE Visualization tab and locate the InSightApp in the AVEVA OMI Apps folder.
-
Double-click on the InSightApp to open the InSightApp dialog box.

The dialog box shows the default values assigned to the InSight Server URL, the chart duration, and tags recorded in an InSightApp chart.
Note: These same configuration properties can be specified after the InSightApp has been placed on a layout pane.
-
Test the connection to the InSight server and update the URL if necessary.
-
Change the chart duration and the monitored tags if you do not want to accept the default values.
-
Save your changes.
To configure InsightChartControl properties
-
Open the Layout or ViewApp Editor and show the items listed in the Toolbox tab.
-
Select InSightChartControl from the Toolbox list to show its preview thumbnail.
-
Drag and drop the thumbnail on a layout pane.
-
Select the InSightAppChartControl thumbnail in the pane and select the Properties grid.
The Properties grid shows the InSightChartControl properties.

The Content and Pane fields show the assigned content type and the name of the pane in which the InSightChartControl is placed.
-
Enter the URL in the Historian Insight Server URL field.
The default Historian Client Web server URL is http://localhost:32569. A static or dynamic URL can be configured. The type of control property /attribute binding can be specified by selecting a value from the drop-down list.
Constant
Static binding to the specified URL. Enter a value in the data entry field.
In
Dynamic URL with read only binding by the control to a reference.
Out
Dynamic URL with write only binding by the control to a reference.
InOut
Dynamic URL with read/write binding by the control to a reference.
Reset
Reset the current property to its default value.
Connection settings to the Historians are configured on the server side. This configuration is normally done when System Platform is installed. The connection can be configured to either favor or require an encrypted connection, regardless of the URL (encrypted or unencrypted) that you configure here.
-
Favor trusted connections, but permit untrusted connections. If this option has been configured, and if a trusted connection available, users will be prompted to select one of three options:
-
Always use the trusted connection
-
Use the trusted connection this time
-
Continue with the untrusted connection (not recommended)
-
-
Require trusted connections.
-
-
Enter a chart duration time as the value of the Chart Duration property.
The default chart duration is 180 minutes. Valid durations range from 1 minute to 5256000 (10 years). A static or dynamic Chart Duration property value can be configured and the type of app property /attribute binding can be specified with the property. Use the same switch settings shown for the Historian Client Web Server URL property to configure static or dynamic binding for the Chart Duration property.
-
Enter a comma delimited search string, which is used by Historian Client Web to show for Include Tags Containing property.
The default search string is PV,SP,CV.
The InSightApp uses this string to search for matching attributes. Attributes that match the search string appear in the InSight chart. This property cannot be empty. Valid property values can include numbers, alphabetic characters, and the following special characters $ # _ .
A static or dynamic Include Tags Containing property value can be configured and the type of app property /attribute binding can be specified with the property. Use the same switch settings shown for the Historian Client Web Server URL property to configure static or dynamic binding for the Include Tags Containing property.
-
If you want to create event handler scripts, select the Available Events data entry field to show a list of InsightApp events. For more information about creating event handler scripts, see Add an Event Handler Script.
-
Save your changes.