| Table of Contents |
|---|
The Visualization Management App is the tool to set up logical visualization devices and link them to a project. Visualization access control configuration is also done here.
The app contains of five pages:
- Projects: the inventory of visualization projects related to the current server workspace.
- Devices: configured devices for visualization
- Users: assign users to visualization devices
- Groups: assign groups to visualization devices
- Configurations: set up specific permissions for layers and modules, set visualization workspace variables
Projects
Click the Projects button 
on the left-side menu of the Visualization Management App app to open the Projects page.
Toolbar functions
| Function | Description |
|---|---|
| Import an existing visualization project. Use the Select file button or drag-and-drop the file onto the dashed-bordered drop area. |
| Delete the selected project. |
| Switch to multi-select mode. |
| Deploy project to the web server. |
| Refresh the list of projects. |
...
| Column name | Description |
|---|---|
| Name | Name of the visualization project. |
| Devices | Number of devices that use this project. |
| Last received | Timestamp when the project was last sent by the Visualization Editor and received by the server or when the file has been uploaded. |
| Last deployed | Timestamp when the project was last deployed for web visualization. |
Devices
Click the Devices button 
on the left-side menu of the Visualization Management App app to open the Devices page.
Each project needs at least one device definition. Later on, user permissions are defined on devicesusers or groups can be assigned to a device and the permissions and access rights can be configured.
The list on the left hand side shows the device definitions for each project, containing the number of connections and the maximum number of connections. Devices can be enabled or disabled.Properties all defined devices. The form on the right hand side shows the properties for the selected device are shown on the right side. The number of client connections can be limited here..
Toolbar functions
| Function | Description |
|---|---|
| Add a device. |
| Copy device. |
| Delete device. |
| Switch to multi-select mode. |
| Shows details of a connected web client. The client can be disconnected.
|
| start the visualization. |
| Refresh page. |
List of devices
| Column name | Description |
|---|---|
| Name | Name of the device. |
| Project | Name of the project which is assigned to the device. |
| Connections | Shows the number of currently opened connections followed by the maximum number of connections. 1/3 means currently 1 connection and in total 3 connections are allowed. |
| Enabled | Devices can be set to enabled and disabled. If a device is disabled it is not accessible. |
Form of device
| Field | Description |
|---|---|
| Name * | Name of the device (mandatory). |
| Connection limit | "on": define the maximum number of currently connected devices. "off": the number of currently connected devices is not limited. |
| Project * | Name of the project for the device to be assigned to (mandatory). |
Users
Click the Users button 
on the left-side menu of the Visualization Management App app to open the Users page.
The list on the left hand side shows the all users defined in User Management. The list on the right hand side shows the defined devices.
To authorize a user for to access a project select one or more projects device select the device on the right side.
List of users
| Column name | Description |
|---|---|
| Name | Name of the user. |
| Connected devices | Names of the devices for the user to connect to. |
List of devices
| Column name | Description |
|---|---|
| Name | Name of the device. If the device name is shown italic, the device is diabled and not accessible. |
Groups
Click the Groups button 
on the left-side menu of the Visualization Management App app to open the Groups page.
The list on the left side shows the all groups defined in User Management. The list on the right hand side shows the defined devices.
To authorize a group for to access a project select one or more projects device select the device on the right side.
List of groups
| Column name | Description |
|---|---|
| Name | Name of the group. |
| Connected devices | Names of the devices for the user to connect to. |
List of devices
| Column name | Description |
|---|---|
| Name | Name of the device. If the device name is shown italic, the device is diabled and not accessible. |
Configurations
Click the Configurations button 
on the left-side menu of the Visualization Management App app to open the Configurations page.
The list on the left hand side shows configurations. A configuration can be done per project, per device and per user or group.
The A configuration is an extension to the device/user/project settings as described before. It is used to define access permissions granularly on layers and functions.
A configuration has to be unique per device, per user/group and per project. Note: only the project is mandatory, the device and user/group are optional.
The list on the left hand side shows configurations. The form on the right hand side shows the properties of the configuration.
Toolbar functions
| Function | Description |
|---|---|
| Add a configuration. |
| Duplicate configuration. |
| Delete configuration. |
| Switch to multi-select mode. |
List of configurations
| Column name | Description |
|---|---|
| Name | Name of the configuration. |
| Device | Names of the devices for the user to connect to. |
| User / Group | Name of the user or group. |
| Project | Name of the project. |
Form of configuration
| Name | Description |
|---|---|
| Name * | Name of configuration (mandatory). |
Device | List of devices defined on the Devices page. |
| User/Group | List of users/groups defined on the Users or Groups page. |
| Project * | List of projects defined on the Projects page. |
| Item Link File | csv file for item mapping. |
| Select File | csv file for item mapping. |
| Homepage | One Name of the page of the project can be defines used as homepage. |
Layers
Click the Layers button to open the list of available layers in the project.
Layers are will be defined in the Visualization Editor during the design phase of the project. Each GUI element is assigned exactly to one layer.
By default each project contains the layers Background, Background and Default and ReadOnly. Additional layers can be added in the Visualization Editor.
Here on the Configurations Configurations - Layers page the user's permissions can be defined for each layer.
List of layers
| Column name | Description |
|---|---|
| Layer | Name of the layer. |
| Permission | "full": full acccess to the visualization objects on that layer. "readonly": the visualization objects on that layer are displayed but can not be changed. "invisible": the visualization objects on that layer are not visible. |
Functions
Click the Functions button Functions button to open the list of available functions.
A function is part of an app from the dashboard. Functions are predefined and can not be added by the user.The picture shows the function alarmnotification from the Alarms App - the function is enabled for the current configuration
List of functions
| Column name | Description |
|---|---|
| Name | Name of the function. |
| Authorization | "true": allow access to the function.. "false": deny access to the function. |
Workspace variables
Click the Workspace variables button to open the list of available workspace variables.
...
As shown in the picture, the variable "WS Variable 1" gets the value "UserIsAdmin" - but this assignment is only valid for the current configuration.!
The value of the workspace variable will be evaluated in the visualization during runtime - e.g. for showing or hiding contents.
A workspace variable is available in the whole workspace of the project.
List of workspace variables
| Column name | Description |
|---|---|
| Name | Name of the workspace variable. |
| Value | Value of the workspace variable. |
Page variables
Click the Page variables button to open the list of available page variables. The button is only visible when the homepage of the project has a page variable defined.
...
The page variables definition is done in the Visualization Editor. The value of the page variable will be evaluated in the visualization during runtime - e.g. for selecting content.
List of page variables
| Column name | Description |
|---|---|
| Name | Name of the page variable. |
| Value | Value of the page variable. |