Extend the Thinfinity® Workspace Toolbar

To extend the toolbar with new Send Key options, you have to use the toolbar JSON structure. It contains a JavaScript object array named shortcuts where each object represents a Send Key option and has two fields:

• text: Option caption text (String).

• keys: Object array where each element contains a keyboard action.

Action name	Associated Field	Meaning
down	key	It represents a keydown (just the key down, without the key release).
stroke	key	It represents the complete keystroke sequence action, from the keydown to the keyup (i.e.: when pressing and releasing a key).
up	key	It represents a keyup (key release).
type	text	Send text.

Value field	Meaning
key	Numeric code for the key.
text	A text to be remotely typed.

Adding New Toolbar Options

To add new toolbar options, use one of the following methods:

custom.Settings.js

Using customSettings.js to extend the Thinfinity Workspace toolbar

The customSettings global variable is a JSON object defined in the customSettings.js file found in the Thinfinity Workspace installation web folder. This variable, a JavaScript object, contains attributes to set or modify connection features, including those related to the toolbar. By default, it doesn’t have attributes enabled in the source code and looks like this:

var customSettings = {
  /*
  "createToolbar": true, // Creates the ThinRDP toolbar
  "toolbarVisible": false, // ThinRDP toolbar starts expanded (visible)
  "checkBeforeWindowClose": true, // When false, skips user confirmation popup of onBeforeUnload event
  "noSsnDialog": false, // Avoids the share session popup dialog
  "noShowPopupsOnClose": false // When true, skips session closed message popup
  */
};

To add the toolbar.shortcuts structure to customSettings, do the following:

  var customSettings = {
  ...
    "toolbar": {
    "shortcuts": [ ... ]
  }
}

Example of Actions and Values

Here’s an example of the toolbar configuration with actions and values:

"toolbar": {
  "shortcuts": [
    {
      "text": "Help (F1)",
      "keys": [
        { "action": "stroke", "key": 0x70 } // F1
      ]
    },
    {
      "text": "Find",
      "keys": [
        { "action": "down", "key": 0x11 }, // CTRL
        { "action": "stroke", "key": 0x46 }, // F
        { "action": "up", "key": 0x11 } // CTRL
      ]
    },
    {
      "text": "Type 'Hello'",
      "keys": [
        { "action": "type", "text": "Hello" }
      ]
    },
    {
      "text": "Find 'Hello'",
      "keys": [
        { "action": "down", "key": 0x11 }, // CTRL
        { "action": "stroke", "key": 0x46 }, // F
        { "action": "up", "key": 0x11 }, // CTRL
        { "action": "type", "text": "Hello" },
        { "action": "stroke", "key": 0x0D } // ENTER
      ]
    }
  ]
}

In this example:

• The first shortcut sends an F1 key press.

• The second triggers a find/search command ([CTRL]+F).

• The third types “Hello.”

• The fourth combines the second and third examples to find “Hello.”

SDK Custom Connection

Modifying Parameters in an SDK Custom Connection

If you are using the Thinfinity® Workspace SDK and prefer not to change the toolbar for all users or wish to modify it conditionally (e.g., based on user identification or profile), you can add the toolbar.shortcuts structure to the connection parameters. This change will only affect SDK users, and you can optionally add this data conditionally.

Adding the toolbar.shortcuts structure to connection parameters for all SDK users:

var mythinrdp = null;
$(document).ready(function () {
  mythinrdp = GetThinRDP("", false);
  mythinrdp.connect({
    targetWindow: "myiframe",
    centered: true,
    ...
    // Custom shortcuts (Toolbar Actions/Send Keys...)
    "toolbar": {
      "shortcuts": [ ... ]
    }
  });
});

For a selective addition of toolbar.shortcuts:

var mythinrdp = null;
$(document).ready(function () {
  var params = {
    targetWindow: "myiframe",
    centered: true,
    ...
  };
  // Hypothetical functions created by you
  if (userProfile(CurrentUser()).hasExtendsSendKeys) {
    params["toolbar"] = { "shortcuts": [ ... ] };
  }
  mythinrdp = GetThinRDP("", false);
  mythinrdp.connect(params);
});

This approach allows you to tailor the toolbar shortcuts based on specific user profiles while maintaining flexibility in your Thinfinity Workspace integration.