Keyboard

Generic client IME for East Asian languages

The Generic Client Input Method Editor (IME) feature enhances the input and display experience with Chinese, Japanese, and Korean (CJK) language characters. This feature allows you to compose CJK characters at the cursor position when you are in a session. The feature is available for the Windows VDA and Linux VDA environments.

Generally, IME displays user interface (UI) components such as a candidate window and a composition window. The composition window includes the composition characters and composition UI elements. For example, underline and background color. The candidate window displays the candidate list.

The composition window enables you to choose between the confirmed characters and the composed characters. The composition window and the candidate window move with the input cursor. As a result, the feature gives an enhanced input of characters at the cursor location in the composition window. Also, it gives an improved display in the composition and the candidate window.

Prerequisites:

• For Linux VDA, enable Client keyboard layout sync and IME improvement policy.
• For Windows VDA, enable Unicode Keyboard Layout Mapping, Client Keyboard Layout Sync, and IME Improvement policies.
• Use Citrix Linux VDA version 2012 and later. For Citrix Windows VDA, all the currently available Windows VDA versions support the generic client IME feature.
• The browser language must be Japanese, Chinese (Simplified), Chinese (Traditional), or Korean.
• Use Google Chrome, Mozilla Firefox, Apple Safari 13 or later, or Microsoft Edge.

Note:

• For macOS, iOS, and Android platforms, modify the system language of the devices to either of the CJK languages. The browser language gets updated automatically.
• For Windows, Linux, and ChromeOS platforms, modify the browser language to either of the CJK languages.

Configuration:

Starting with version 2105, the Generic Client IME feature is enabled by default. As an administrator, you can enable or disable the feature using the configuration.js file on the StoreFront server (C:\ProgramFiles\Citrix\Receiver StoreFront\HTML5Client).

To disable this feature for a browser language, edit the configuration.js file and set features.ime.mode.<languageID> to seamlessIme. If seamlessIme is set, the Generic Client IME feature is disabled.

configuration.js:

    var HTML5_CONFIG = {
       'features': {
        ime: {
            mode: {
                "ja": "seamlessIme",
                "zh": "seamlessIme",
                "ko": "seamlessIme"
            }
       }
    }
}

<!--NeedCopy-->

To enable this feature for a browser language, edit the configuration.js file and set features.ime.mode.<languageID> to ctxIme, or leave the mode property empty ({}), which is the default behavior.

configuration.js:

var HTML5_CONFIG = {
    'features': {
        ime: {
            mode: {
                "ja": "ctxIme",
                "zh": "ctxIme",
                "ko": "ctxIme"
            }
       }
    }
}

<!--NeedCopy-->

Feature Limitation:

Generic client IME is now supported when you use an extended screen with Citrix Workspace app for HTML5 on Windows, Mac, Linux, ChromeOS, iOS, and Android client platforms. However, for multi-monitor sessions that are not yet supported, you can use Server IME instead.

To enable the Server IME:

1.  Change the VDA or the server keyboard language to Chinese, Japanese or Korean (CJK) as required.
2.  Change the client device keyboard language to English.

Keyboard shortcuts

The default settings for Microsoft Windows logo key and other keyboard shortcuts are as follows:

HTML5_CONFIG > features > keyboard > captureAllKeys

The default value of captureAllKeys is set to true. To change the default settings, open the configuration.js file and set the attribute to false.

Support for Microsoft Windows logo key and other keyboard shortcuts

The following adds support for the key combinations with the Microsoft Windows logo key in your sessions that runs on Microsoft Windows.

• Windows + R
• Windows + D
• Windows + E
• Windows + M
• Windows + S
• Windows + CTRL + S
• Windows + T
• Windows + U
• Windows + Number
• Windows + X
• Windows + K

Also, we’re now supporting the following keyboard shortcuts in your sessions that run on Microsoft Windows:

• Alt + Tab
• Esc key
• Ctrl + N
• Ctrl + T
• Ctrl + W

For the sessions that run on macOS, we now support the following extra keyboard shortcuts:

• Esc Key
• Command + N
• Command + T
• Command + W
• Ctrl + N
• Ctrl + T
• Ctrl + W

Note:

• The shortcut keys work only in full-screen mode that is selected through the toolbar.

Scancode input mode

Citrix Workspace app allows you to use external physical keyboards to collaborate with the server-side keyboard layout on the VDA. When administrators enable Scancode mode, the end user might find themselves using the keyboard layout of the server instead of the client.

This feature enhances the user experience particularly when using an East-Asian language physical keyboard.

Notes:

• By default, this feature policy is disabled.
• On touch devices, when Scancode is enabled, the on-screen software keyboard doesn’t work from the Citrix Workspace app.

Configuration

You can configure the Scancode input method in the following way:

• Configuration.js

Configuration.js

Notes:

• Citrix recommends you back up the configuration.js file before making changes.
• Administrator-level credentials are required to edit the configuration.js file.
• The configuration.js file is located under the C:\Program Files\Citrix\Receiver StoreFront\HTML5Client folder.

To enable the Scancode support feature, do the following:

1. Navigate to the configuration.js file.

2. Edit the file and set the scancode attribute to true.

   The following is an example of JSON data:

   "features" : {
           "ime": {
                       "scancode": true,
   }
   }
   <!--NeedCopy-->
   

3. Save the changes.