Project properties span several functional areas each containing settings applicable to that area. Scroll down to the Vision section.
When properties in a section have been updated but not saved yet, the section heading will change to italicized text. In the following example, changes have been made in the the Vision General, Permissions, and User Interface properties but they have not been saved or applied yet.
Vision Design Properties
This section of properties apply to the Vision Client in general.
|Window & Template Committing|
|Commit on Close||Prompt - Prompt whether the user wants to commit changes when closing a window or template.|
Always - Always commit changes when closing a window or template.
|Template Auto Commit||On - Always commit changes when switching to a different window or template.|
Off - Do not automatically commit changes when switching to a different window or template.
|Constrain to Parent Container Bounds||Disabling the constraint on parent bounds allows you to position components outside of their parents bounds, which can be helpful in advanced layouts.|
|Nudge Distance||The number in this box is the distance (in pixels) that a nudge moves (when using the arrow keys) or resizes a component.|
|Alt-Nudge Distance||The number in this box is the distance (in pixels) that an alt-nudge moves (when using the arrow keys plus the Alt key) or resizes a component.|
|Default Component Layout|
Relative - All newly created components will be configured with a Relative layout, further configured by the Relative Layout Options property.
|Relative Layout Options|
When the Layout Mode property is set to Relative, these options determine the layout options of new components. For more information, refer to Component Layout.
|Anchored Layout Options||When the Layout Mode property is set to Anchored, these options determine the layout options of new components. For more information, refer to Component Layout.|
|Default Color Mapping||The initial color mapping when configuring a new number-to-color binding.|
Vision General Properties
|Timezone Behavior||The Vision Client can emulate any timezone. By default, it will appear to be in the same timezone as the Gateway Timezone. This has the effect of all Clients behaving the same, regardless of the timezone setting on the Client's host operating system. Depending on your project's requirements, this may not be optimal. You can have the Client use the host's timezone by choosing the Client Timezone option, or you may specify any explicit timezone for all Clients to emulate.|
|Notify / Push||Updates sent to the Client when a designer Saves the projects can either Notify the user by showing an update banner at the top of the Client, or Push the the changes without warning the users. See Client Update Modes.|
|Touch Screen Mode Enabled||All Clients can operate in touch-screen mode. When enabled, clicking on editable numeric and text entry fields (i.e., Text Fields, Numeric Text Fields, etc.) will pop up on-screen keyboards that can be used for data entry. You can optionally set the width of any scrollbars (number of pixels wide/tall).|
|Touch Screen Mode Active on Startup||Configures the Clients to start up with the touch-screen mode active.|
More details can be found on the Using Touch Screen Mode page.
|Disable Tag History Data Cache||The Clients normally maintain a cache of data retrieved from Tags History, improving repeat operations on graphs and tables. When this option is disabled, no data is cached, and the full queries execute against the Gateway each time data is required.|
Vision Launching Properties
These properties affect the Vision Client's launching process.
|Gateway Launch Page|
|Default Launch Mode||Determines the mode for a Client launched from the Launch button that appears next to the project in the Client Launcher. Available modes are Windowed or Full Screen.|
|Windowed Button/Full Screen Button||Each launch mode can also be enabled individually, which allows that mode to appear in the Dropdown list next to the Launch button on the Gateway Home page.|
|Hide From Launch Page||This option hides the project from the Client Launcher.|
|Launch Icon||The image specified here is used to represent the project on the launch page and desktop shortcut. This needs to be a path to an image that has been uploaded to the Gateway. Use the browse button to choose or upload a new image.|
|Vendor||This property is displayed as the project is launching through Java Web Start, as well as in the JWS application manager.|
|Homepage||A URL that is displayed in the JWS application manager.|
|Width||The width of the Client window when launched in Windowed mode.|
|Height||The height of the Client window when launched in Windowed mode.|
|Screen Index||The number here is the index of the screen to use for Full Screen mode, it starts at 0. This property is not supported on all operating systems.|
|Start Maximized||If the box is selected, when the Client is launched in Windowed mode, it starts maximized. Note that this is not the same thing as Full Screen mode, which is only available when the Client is launched in Full Screen mode. In Full Screen mode, the width, height, and start maximized properties have no effect. When launched in Full Screen mode, the user is given an Exit button on the login screen by default. For terminals where the application should not be exited, this button can be removed by checking the Hide Exit Button box.|
|Start Centered||If the box is selected, when the Client is launched in Windowed mode, it starts centered.This property is ignored if Start Maximized is enabled.|
|Hide Exit Button||If the box is selected, when the Client is launched in Full Screen mode, the exit button is hidden to prevent the application from closing.|
|Initial||Governs how the Client use RAM resources on its host machine. The initial memory setting is how much memory the Client will require on startup. While this is typically left alone, boosting it a bit can improve performance somewhat.|
|Maximum||Governs how the Client use RAM resources on its host machine. The maximum memory setting sets a cap on how much memory the Java VM is allowed to use. When you launch a Client on a machine with plenty of RAM, you'll also need to boost this setting to allow the Client to use more RAM.|
|Welcome Message||The message that appears in the upper-left corner of the Login screen. If left blank, no message is displayed. (HTML formatting is allowed).|
The image that appears in the upper-left corner of the Login screen. If left blank, uses a default image.
Images are resized/forced to fit into a square format. If you use a more rectangular image, the scaling on the image will automatically be adjusted.
Click here to see an example of a Login Screen with welcome image...
|Username Text||The text that appears next to the username field.|
|Password Text||The text that appears next to the password field.|
|Login Button Text||The text that appears on the Login button.|
|Show Locale Selector||Determines if the Locale Selector should appear on the Login screen. This property interacts with Ignition's Localization system.|
By enabling auto-login, you can have the launched Client skip the login process. The Client will log in behind the scenes using the credentials supplied here. If they fail, the login screen will be presented.
See also Setting Up Auto Login.
|Enable SSO Login||Enable Single Sign-On for the project. The Project's default Authentication Profile must use Active Directory, and SSO must be enabled in the Profile. See Active Directory Authentication for more details.|
|Enable?||Determines if the Client has access to this category. If unselected, the category will be disabled in the Client for all users. If selected, the Required Client Roles text field will also be used to determine if the Client has access.|
|Required Client Roles|
A comma separated list of Managing Users and Roles and/or Security Zones that have access to the category while the Enabled checkbox is selected. While these fields have focus, the down arrow key on the keyboard may be pressed to make a list of available roles appear. There are several ways to use roles and zones in this field, and they can be used together in the comma separated list.
When creating a new project, all of these settings will be disabled by default.
The following is a list of the initial categories. Note that the categories you see in your Designer are dependent on which modules are installed on the Gateway. Additionally, third-party modules can add to this list.
Click here to see Vision Client Permissions Example
The image below contains the following configuration: Alarm Management is only available if the logged in users have the "Administrator" or the "Operator" role (regardless of their current zone), Datasource Management has been disabled for all users, and Device Management is available if the logged in user has the "Administrator" role and the Client is in the Security Zone named "Default".
|Polling Base Rate||The base rate, in milliseconds, for all polling bindings.|
The maximum amount of time to wait for connections to the Gateway to be established. Specified in milliseconds.
|Read Timeout||The maximum amount of time for socket connection to the Gateway to remain open. Specified in milliseconds.|
|OPC Browse Timeout||Maximum amount of time, in milliseconds, to wait for the response to a request. (default: 120,000)|
|Connection Concurrency||By default, Clients are not limited by the number of concurrent connections to the Gateway. These connections are used to send Tag writes, return database results, as well as any other action that requires information to be passed between the Gateway and the Client. Depending on what is running in the Client, your network's bandwidth could be hindered. Enabling this property will limit the amount of concurrent connections the Client can maintain. Note that this may negatively impact Client performance, but is usually preferable on busy networks.|
Typically, a Vision Client is designed to run on multiple different resolution and sizes of monitors. The various component layout features help design elastic screens, but sometimes you need to set a lower bound as to how small you'll allow the Client's usable area to shrink. This is what the Minimum Size settings are for. You can see these settings visually represented in the Designer as lines on the Vision workspace when the Root Container is smaller than the configured Minimum Size..
Whenever the usable space shrinks smaller than these bounds, scrollbars will appear, capping the Width and Height to these minimums. This defaults to 800 x 600. In the image below, the project was set to a minimum size of 400 x 300. Since the window is smaller, the outline is visible.
|Client Background Color||This option allows you to specify the color of the Vision workspace which will be visible when not obscured by windows.|
These options change the appearance of the Client Menu:
|Touch Screen Keyboard Width|
Determines how wide the Touch Screen Keyboard should appear in the Client. Percentage of the client window the touch screen keyboard displays.
Docked windows are locked to the edges of the Client and fill all the space on that edge. Docking options are: