About ViewApp previews at different stages
- Last UpdatedJul 29, 2024
- 4 minute read
When a builder requests a preview of the ViewApp open in the ViewApp editor, the initial preview shows the current content of the ViewApp's constituent components. The preview shows similar runtime data that would appear in a deployed ViewApp.
Initial Preview
The following list describes the components of a ViewApp that appear in an initial preview request.
-
Graphics
-
Graphics from the Visualization folder
-
Embedded graphics
-
Graphics currently placed in ViewApp panes
-
Graphics associated with objects
-
Data values associated with graphic custom properties, animations, or attributes.
-
-
Objects
-
Attributes assigned to an object
-
Graphics associated with an object
-
Hierarchy of objects in the navigation model.
-
-
Screen Profile associated with the ViewApp
-
Layout associated with the ViewApp
-
Alarms
-
Active alarms from any runtime node.
-
Alarm severity and acknowledgement status
-
-
Apps
-
Standard apps placed in ViewApp panes
-
Custom apps placed in ViewApp panes
-
-
Current selected item of the ViewApp's navigation model
-
Current values assigned to the ViewApp namespace
-
Navigation security by assigned Access Levels and and content types.
-
Galaxy Styles
-
element styles
-
Format Styles
-
Quality and Status Overrides
-
-
ViewApp language
-
Historical playback
-
Displays real-time data from attributes whose data is stored in the Historian.
-
Playback controls can be modified by the user from the preview session.
-
Displays historical data from the period set by the playback controls.
Preview Updates
-
After editing changes have been made to ViewApp content, the running preview updates to show the changes in the ViewApp after the changes have been saved. Not all changes to a ViewApp necessarily update the preview session.
If a preview session is open, then the following types of editing changes will not appear until the ViewApp editor is closed and opened again.
-
Change in language settings
-
Change to a Screen-Profile
-
Change in Asset hierarchy
-
Change to an alias-name
-
Change to the object order in the hierarchy shown by the Model view
The remainder of this topic describes the supported updates to a preview session by the various components that can be included as ViewApp content.
Graphics
-
Visual or functional changes to embedded graphics.
-
Changes to the content type or Access Level assigned to the pane in which the graphic is placed.
Apps
A preview session updates when the following changes are made to apps or controls embedded in a ViewApp.
-
Change the properties of apps embedded in a ViewApp.
-
Rename an app.
-
Delete an app
Note: After renaming or deleting an app, all preview sessions show a popup dialog that indicates the preview session needs to be shutdown or restarted.
-
Import an aaPKG file containing one or more new apps and place the imported apps on a layout pane.
-
Delete and import an app with updated versions of DLL files with the same name as the original deleted app.
-
Change the global configuration values of the InSightApp, Historical TrendApp, and the AlarmApp controls.
ViewApp Navigation
A preview session updates content rendering when the following changes are made to a ViewApp navigation model:
-
Change the autofill mode of a navigation item.
-
Add or remove custom navigation items.
-
Change the position of a custom navigation item in the hierarchy of the navigation model.
-
Change the reference that navigation item points to
-
Change the property of the navigation item
-
Add or remove the content of a navigation item.
-
Change the current selected navigation item
ViewApp Layout
A preview session updates when the following changes are made to one or more layouts associated with a ViewApp:
-
Delete a layout
-
Rename a layout
-
Add, delete, merge, or resize a layout pane.
Note: An updated preview shows any panes that have been added or deleted. A message appears when a pane is deleted indicating the content associated with the deleted pane cannot be found.
-
Change layout properties.
-
Change the properties of a pane within a layout.
-
Add or delete a pane from a layout.
-
Change the content associated with a layout pane.
-
Change properties of content associated with a layout pane.
ViewApp Namespace
A preview session updates when changes are made to a ViewApp Namespace or the attributes associated with it:
-
Add, delete, or modify attributes associated with a ViewApp Namespace.
-
Rename a ViewApp Namespace.
Historical Playback
A preview updates to show real-time or historical data when the playback controls are adjusted by the user.
Global Styles
Changes to a ViewApp's assigned Galaxy Styles (element styles, Format Styles, and Quality and Status Overrides) will be updated automatically If the WinPlatform is deployed at the IDE node. The ViewApp editor must be closed and reopened again if the WinPlatform is not deployed to show any changes to Global Styles in the preview session.
Alarms
A running preview updates to show the following alarms changes if the computer hosting the preview has its WinPlatform deployed. For more information about the requirements to see historical and alarm data in a preview, see Preview a ViewApp.
-
Active alarm monitoring from any runtime node.
-
Alarms can be acknowledged or shelved in an active preview session.
Import aaPKG File
A preview session does not refresh during the period when an aaPKG file is being imported. After the import is completed, the preview session refreshes with the changes in the Galaxy.