Using web.settings.js

The web.settings.js file is distributed as part of the Thinfinity® Workspace installation and is available in the installation directory (C:\Program Files\Thinfinity\Workspace ). This JavaScript file is read by the client’s browser when they access Thinfinity Workspace, facilitating communication with Thinfinity Workspace components to relay various parameters, such as toolbar settings. You can open this file in any text editor, like Notepad, to customize its contents.

The Settings variable within the web.settings.js uses the JSON format to define a collection of attribute/value pairs with special parameters that are not available in the profile settings.

CAUTION! This is a powerful tool that needs to be used carefully. The configurations you set through the web.settings.js file will apply to ALL Thinfinity Workspace connections, regardless of the session, and will override settings made through the SDK connect method. Therefore, we recommended that you use web.settings.js exclusively to set the special parameters mentioned below, or when you need a centralized configuration to be shared by all access profiles.

Remember: defining configurations for each access profile is always safer, as well as clearer. To fine-tune specific toolbar settings for specific access profiles, we recommend that you use the SDK library. For more information, refer to the sections on customizing the toolbar using customsettings.js and the connect method.

Here are the initial values:

Attribute	Default value	Description
createToolbar	true	Enables the toolbar creation. Setting it to false will result in a connection without a toolbar, which can be useful for restricting user access to toolbar options entirely.
toolbarVisible	false	Defines the initial toolbar visibility. If set to true, the toolbar will appear expanded when the connection is established. If set to false, the toolbar will start collapsed.
checkBeforeWindowClose	true	When set to false, bypasses the confirmation popup triggered in the onBeforeUnload event.
noSsnDialog	false	Disables the share session popup dialog display.
toolbarRestrictions		An array that lists the full names of all the toolbar options you wish to restrict. When connecting to an application, you might want to restrict users from accessing certain features, such as the Task Manager (triggered by [CTRL]+[SHIFT]+[ESC]). Or, you may want to enable file transfers without granting access to the file manager. For these scenarios, you can use this parameter to programmatically define the specific toolbar options to exclude. For details, see the example below.

This collection can be extended with any other attribute of the connect JSON parameter, except for those that are relative to the connection —user, password and computer.

When extending the collection, the overrideDefault attribute must be set to true, as specified in the Using the SDK connect Method.

// GetThinRDP(serverURL, runRemote)
// Creates a new ThinRDP instance
// serverURL: substitute with the ThinRDP server URL (http[s]://[URL - IP]:port/)
// runRemote: use to set ThinRDP mode
// -- false-> local (renders into this page)
// -- true-> remote (posts connection data to postPage ("connection.html" as default)
 mythinrdp = GetThinRDP("", true);
 mythinrdp.connect({
 targetWindow: "rdpwindow",
 centered: true,
 overrideDefaults: true,
 ...
 ...
 ...
 }

When starting a connection, Thinfinity Workspace reads the values in Settings and merges its parameter list with the access profile settings, overriding the access profile attributes with the Settings variable values. Values set in the SDK connect method will also be overridden.

Example of customSettings

var customSettings = {
"createToolbar": true,
var customSettings = {
    "createToolbar": true,  // Enables Thinfinity® Workspace toolbar
    "toolbarVisible": false // Starts toolbar in a collapsed state
};

Example of toolbarRestrictions

var customSettings = {
 "createToolbar": true,    // Enables Thinfinity® Workspace toolbar
 "toolbarVisible": false,  // Starts toolbar in a collapsed state
 "toolbarRestrictions": [
"actionsMenuBtn",                                //"Actions" menu
"actionsMenuBtn.refresh",                        //"Refresh" button
"actionsMenuBtn.ssnShareBtn",                    //"Share session" button
"actionsMenuBtn.sendKeysBtn",                    //"Send Keys" button
"actionsMenuBtn.sendKeysBtn.ctrlAltDelBtn",      //"Ctrl + Alt + Del" button
"actionsMenuBtn.sendKeysBtn.ctrlEscBtn",         //"Ctrl + Esc" button
"actionsMenuBtn.sendKeysBtn.shiftCtrlEscBtn",    //"Shift + Ctrl + Esc" button
"actionsMenuBtn.sendKeysBtn.windowsExplorerBtn", //"Shell Explorer" button
"actionsMenuBtn.sendKeysBtn.runBtn",             //"Run" button
"actionsMenuBtn.sendKeysBtn.altTabBtn",          //"Alt + Tab" button
"actionsMenuBtn.sendKeysBtn.altShiftTabBtn",     //"Alt + Shift + Tab" button
"actionsMenuBtn.sendKeysBtn.altEscBtn",          //"Alt + Esc" button
"actionsMenuBtn.sendKeysBtn.leftWinBtn",         //"Left Win Key" button
"actionsMenuBtn.sendKeysBtn.rightWinBtn",        //"Right Win Key" button
"actionsMenuBtn.takeScreenshotBtn",              //"Take Screenshot" button
"fileMenuBtn",                                   //"File transfer" button
"fileMenuBtn.fileManBtn",                        //"File Manager" button
"fileMenuBtn.uploadBtn",                         //"Upload" button
"fileMenuBtn.downloadBtn",                       //"Download" button
"optionsMenuBtn",                                //"Options" button
"optionsMenuBtn.scaleBtn",                       //"Scale" button
"optionsMenuBtn.imgQualityBtn",                  //"Image Quality" dropdown
"optionsMenuBtn.imgQualityBtn.imgQHighestBtn",   //"Highest" option   
"optionsMenuBtn.imgQualityBtn.imgQOptimumBtn",   //"Optimum" option
"optionsMenuBtn.imgQualityBtn.imgQGoodBtn",      //"Good" option
"optionsMenuBtn.imgQualityBtn.imgQFastestBtn",   //"Fastest" option
"optionsMenuBtn.keyboardMode",                   //"Disable Shortcuts"
"optionsMenuBtn.fullScreen",                     //"Full Screen"
"disconnectBtn",                                 //"Disconnect"
 ]
};