The GUI Policy defines system-level settings for the LabVantage User Interface.

Property Name Description
Topbar Gizmos Defines the Gizmos displayed at the upper right of the Menu Bar.
Property Name Description
Id Internally-generated Property List Id for this Gizmo definition.
Gizmo Id Identifier of the Gizmo. Use these buttons:
Opens a lookup that lets you choose the Gizmo.
Opens the Gizmo for editing.
ShowYes/No shows/hides the Gizmo.
Default URL Logon URL to use by default when the application opens. This property applies only if the "Startup Page " User Profile property has not been set. If set, this overrides the User Profile. Use these buttons:
Opens a lookup that lets you choose the URL.
Opens the URL Gizmo for editing.
Default Menu Menu Gizmo to use by default in the Menu Bar when the application opens. This property applies only if the "Start Menu" User Profile property has not been set. If set, this overrides the User Profile. Use these buttons:
Opens a lookup that lets you choose the Menu Gizmo.
Opens the Menu Gizmo for editing.
Default Sidebar Group Group Gizmo to use in the Sidebar by default when the application opens. This property applies only if the "Start Sidebar" User Profile property has not been set. If set, this overrides the User Profile. Use these buttons:
Opens a lookup that lets you choose the Group Gizmo.
Opens the Group Gizmo for editing.
Sidebar style Determines the appearance of the Sidebar Groups. This can be overridden at the Group Gizmo level.
Property Name Shows:
Text Only Only text that identifies the Gizmo.
Large Icon64x64 icon with Group Items displayed in a text flyout onMouseOver.
Medium Icon32x32 icon with Group Items displayed in a text flyout onMouseOver.
Small Icon16x16 icon with text.
Button style Determines the default appearance of buttons if no style is set at the Toolbar level:
Property Name Shows:
Text Only Only the button text.
Image and TextButton image and button text.
Application title Title to display in browser tabs and window headers. We recommend you do not otherwise modify the visual appearance of the header.
Application Image Image displayed in the top left corner of the Layout. We recommend you do not otherwise modify the visual appearance of the header.
Status Bar Properties Determines the appearance and content of the Status Bar:
Property Name Description
Show Determines the position of the Status Bar within the Layout:
Property Name Position Within the Layout:
Bottom Bottom right corner.
TopTop right corner.
NoHides the Status Bar.
Session Text Determines the text displayed in the Status Bar. The following variables can be used to communicate session-specific information:
connectionid  departmentlist modulelist
currentjobtype deviceid rolelist
currentuser guimode sysuserid
databaseid jobtype timezone
dbms jobtypelist timezonedesc
dbserver language tool
defaultdepartment locale usertype

The OOB setting is [currentuser] [jobtype] ON [databaseid] TIME ZONE: [timezone].

Background ColorDetermines the background color of the Status Bar. This is useful if you want to visually identify the particuler login.
Text ColorDetermines the color of the text.
Navigation Bar Determines if the Navigation Bar is shown:
Property Name Description
Show Determines if the Navigation Bar is shown at the top of each page.
Mode Forces the Navigation Bar to function in a specific mode:
ModeDescription
Recent History Shows "Recent History" as described in LabVantage User Interface → Layout → Navigation Bar.
Related ItemsShows "Related Items" as described in LabVantage User Interface → Layout → Navigation Bar.
title OnlyShows only the page title.
User DefinedAllows the User to choose modes as shown in LabVantage User Interface → Layout → Navigation Bar. This is the default if the property is left blank.
NOTEThese properties override the "Show Navigation Bar" and "Navigation Bar Mode" properties in the "GUI Modes" collection (below).
JS Includes Collection of JavaScript includes. Includes at the Generic Layout level will be included into the navigation frame of the pages (not the top frame), whereas includes at the GUI Policy level will be included into the top frame of the page.
Property NameDescription
IdentifierUnique identifier for this property.
URLURL of the JavaScript (*.js) file.
stylesheets Collection of stylesheets to include. We recommend you do not modify the visual style of the components in the application. If styling is required, include it at the specific page level. style includes at the Generic Layout level will be included into the navigation frame (not the top frame), whereas these stylesheet includes will be pushed into the top layout frame.
Property Name Description
Identifier Unique identifier for this property.
URLURL of the styleSheet (*.css) file.
Menu Mode Determines how Menu Gizmos open and close:
Property Name Behavior
Click A click opens the Menu. While it is open, movement to another menu will drop it down without another click. This is the default.
MouseOverA click is not required to open the Menu. Only a hover is required. Note that this can be accidentally triggered when moving around the application.
Frame Buffering Yes/No enables/disables frame double buffering. The default is No (frame buffering is turned off). This gives the appearance of a page load between navigations, as in a typical Web application. If set to Yes (frame buffering on), the next page will be loaded off screen and pushed into place when loaded. The latter is more like an Ajax-type load and, although smoother and shows no difference in time to load, can give the impression that loading is taking longer (as the original content remains for a few fractions of a second).
Lock Groups Yes prevents Users from changing the Sidebar and Dashboard Gizmo Groups even if their Group Gizmo allows it (this can also be done at the Group Gizmo level).
Group Creation Role Role of the User who can create new Dashboards.
Hot Key to Log Off Yes/No enables/disables the CTRL + Q hot key, which is used to log off.
NOTE:  The "AltGR + Q" hot key can also enable logoff. For keyboards with the AltGR key, AltGR acts in a similar function to holding down Ctrl and Alt.
Confirm On Hot Key Log Off Yes issues a confirmation before logging off using the CTRL + Q hot key. "Hot Key to Log Off" (above) must be set to "Yes". The default is No (unless a save is required).
Hide Change Password Yes hides the "Change Password" menu item in the Profile Menu on the far right of the Menu Bar.
GUI Modes At logon, LabVantage uses these properties to automatically determine the type of device to which it is connecting (desktop, tablet, or phone) based on these properties. Each GUI Mode defined here is checked to determine the mode that best fits the connected device. After this determination has been made, all pages adjust their display characteristics according to the "Resolution Properties" defined for that device type in the Web Page Designer, assuming those properties have been defined (see Web Page Designer Advanced Operations → Adding Custom Properties → Property Definition Editor → Declaring Advanced Properties → Resolution Properties).

In the OOB configuration, criteria for each device is determined according to these assumptions:

If the browser does not support Touch, it is most likely a desktop PC.
If the browser supports Touch and has an iPad or Android OS, it is likely a tablet.
If the browser supports Touch, has an iPad or Android OS, and resolution is less than 700x400, it is likely a phone.

Custom configurations may require adjustment of these criteria in order to make the correct determination based on the specific devices connected.

Property NameDescription
IdDefines the device (Desktop, Tablet, or Phone). This becomes the identifier of the GUI Mode.
LabelReference Value defined in the GUIMode Reference Type (desktop, tablet, or phone).
EnabledWhen "No", hides and disables this GUI mode. If all GUI modes are hidden the default is the desktop with default settings.
IconImage to use as the device selector.
Is MobileSet this to "Yes" if the device is a tablet or phone.
Is TabletSet this to "Yes" if the device is a tablet.
Is PhoneSet this to "Yes" if the device is a phone.
Auto DetectSet this to "Yes" if you want the application to detect the device and switch to this GUI Mode at logon. This requires definition of "Resolution Properties" as discussed above.
Max WidthMaximum width of the GUI. If left blank or set to -1, no maximum width is set.
Max HeightMaximum height of the GUI. If left blank or set to -1, no maximum height is set.
Has TouchSet this to "Yes" if the device has Touch capability.
Operating System Operating Systems that, if detected, will identify this GUI Mode.
Property NameDescription
OSOperating System to be checked.
Web Browser Web Browsers that, if detected, will identify this GUI Mode.
Property NameDescription
BrowserWeb Browser to be checked.
Show SidebarYes/No shows/hides the Sidebar in this GUI Mode.
Start URLStartup URL for this GUI Mode.
Start MenuStart Menu for this GUI Mode.
Start SidebarStart Sidebar for this GUI Mode.
Show Navigation Bar Determines if the Navigation Bar is shown at the top of each page. If set to "No", the "Show" property in the Navigation Bar collection overrides this property.
Navigation Bar Mode Forces the Navigation Bar to function in a specific mode (see Navigation Bar for options). The "Mode" property in the Navigation Bar collection overrides this property.
Adapt For TouchYes/No enables/disables touch adaptations for touch-enabled devices.
Do Not Use Job Type Start URL When set to "No", the "Default Logon URL", "Default Menu", and "Default Sidebar" defined for Job Types are not used (see Concepts of LabVantage Security → Job Types → Configuration). In this case, Job Type defaults are determined by the GUI Policy ("Default URL", "Default Menu", and "Default Sidebar Group" above).
Use Full Unminified Includes Determines whether minified or unminified files are used for CSS and JavaScript includes. This allows unminified includes to be used on a production system, thus enabling easier debugging.
Navigation Refresh Specifies the number of times a user navigates through the application before a full refresh of the top frame occurs. A value of -1 (default) means to never refresh. A value of 0 results in a refresh on every navigation. Note that this may have performance implications.
Core Font style Specifies the default font style for the entire application. Change this only if a language requires a different font (such as to increase readability). The default is Open Sans.
Hide View Work Yes/No hides/shows the View My Work menu item in the User's Profile Menu.
Hide View Calendar Profile Item Yes/No hides/shows the View Calendar menu item in the User's Profile Menu.
Hide Change Profile Picture Item Yes/No hides/shows the Change Profile Picture menu item in the User's Profile Menu.
Hide Change Preferences Item Yes/No hides/shows the Change Preferences menu item in the User's Profile Menu.
Hide Set As Start Page Item Yes/No hides/shows the Set as Start Page menu item in the User's Profile Menu.
Hide Add To Sidebar Item Yes/No hides/shows the Add to Sidebar menu item in the User's Profile Menu.
Hide Log Off Profile Item Yes/No hides/shows the Log Off menu item in the User's Profile Menu.
Loading Panel Image (typically SVG) and Message displayed while a page is loading.