Configure

Content Collaboration Service integration

This release introduces integration of Citrix Content Collaboration Service with Citrix Workspace app. Citrix Content Collaboration enables you to easily and securely exchange documents, send large documents by email, securely handle document transfers to third parties, and access a collaboration space. Citrix Content Collaboration provides many ways to work, including a web-based interface, mobile clients, desktop apps, and integration with Microsoft Outlook and Gmail.

You can access Citrix Content Collaboration functionality from the Citrix Workspace app using the Files tab displayed within Citrix Workspace app. You can view the Files tab only if Content Collaboration Service is enabled in the Workspace configuration in the Citrix Cloud console.

Note: Citrix Content Collaboration integration in Citrix Workspace app is not supported on Windows Server 2012 and Windows Server 2016 due to a security option set in the operating system.

The following image displays example contents of the Files tab of the new Citrix Workspace app:

Files tab

Limitations:

  • Resetting Citrix Workspace app does not cause Citrix Content Collaboration to log off.
  • Switching stores in Citrix Workspace app does not cause Citrix Content Collaboration to log off.

To enable users to access resources hosted on Citrix Virtual Apps and Desktops in their browsers, you must create a StoreFront store and enable Citrix Workspace app for HTML5. You must also enable WebSocket connections on Citrix Gateway, Citrix Virtual Apps, and Citrix Virtual Apps and Desktops, as required. Additionally, you can enhance the user experience by installing optional components on the machines providing the desktops and applications.

Multi-monitor display

Multi-monitor display lets you create a secondary window of the desktop or application session to which you are connected. You can then drag the secondary window to the secondary monitor.

Multi-monitor display is available for both desktop and application sessions.

To switch to multimonitor mode, click Multimonitor in the toolbar. Doing so creates a secondary window with a 1024x768 resolution. It also updates the server with the dual monitor information. You can drag and resize the secondary window and even go to full-screen mode on one or both monitors. Every time you resize the window, the secondary window resolution is updated on the server. To exit multi-monitor mode, close the secondary window.

Multimonitor image

Even though the resolution details of the secondary monitor are unknown to Citrix Workspace, multi-monitor mode gives you the flexibility of resizing to adjust to the resolution you prefer.

For the session to take focus, click Multimonitor in the toolbar.

This feature is enabled by default.

To disable the feature, edit the configuration.js file and set the value of the multiMonitor property to false.

    'ui' : {
          'toolbar' : {
              'multiMonitor' : true
      },

Using Citrix Virtual Desktops on dual monitors:

  1. Click Multimonitor in the toolbar.
  2. An extended window is created. Drag the window to the extended monitor.

    The screen is now extended to both the monitors.

Limitations:

  • This feature is supported on desktop browsers except for Internet Explorer and Edge.

  • On a Mac, the secondary window opens as a new tab in Chrome. When you drag this secondary window directly to the secondary monitor and resize it, the window might become invisible with an entry being shown in the Chrome taskbar.

    Workaround: Drag the window to the primary monitor and then back to the secondary monitor.

USB device redirection

Generic USB device redirection is supported on Chrome browsers (Version 61 and later) running on Chrome, Mac, and Linux operating systems. This feature is supported on sessions launched over secure HTTPS connections. This feature supports redirection of two USB devices simultaneously.

  1. Redirecting a USB device As a prerequisite, enable the USB redirection policy on the server. For more information, see Enabling USB redirection on the server.

  2. Connect the USB device to the machine.

  3. Click on the USB Devices icon available on the in-session toolbar.

    Toolbar

  4. In the USB Devices dialog box, click on Add.

    Add USB

    This action opens a Chrome dialog box that displays a list of devices.

    Connect

    Note:

    The Chrome dialog box displays USB devices that might not always be redirected through Citrix Workspace app for HTML5. The USB devices that can be redirected through Citrix Workspace app for HTML5 are displayed in the USB devices dialog box within the app.

  5. Select devices to be redirected and then click on Connect. After successful redirection, you are returned to the USB Devices dialog box, and the device appears as Connected.

    Release

  6. When you attempt to redirect a USB device that is not supported by Citrix Workspace app for HTML5, the following error message appears.

    Errormessageone

  7. Click Release to release a device from the remote session.

    Release

  8. If you launch more than one session, USB devices that are connected inside a different session show as Already is use. Click Transfer here to transfer the devices to the current session.

    Transfer here

  9. When you redirect more than one USB device to a session, click Release all devices to remove the devices from the session.

    Releasealldevices

  10. When you disconnect a redirected USB device from the machine without clicking Release, the following error message appears.

    Errormessagetwo

The USB device redirection feature is applicable only to USB devices for which the client operating systems (such as Mac and Chrome) does not load the device drivers by default. For example, the feature is applicable to Brother QL-580N Label Printer.

In case you are unable to redirect USB devices on a Linux operating system, try setting up the user accounts and providing permissions to open the USB devices as described in the Google developers’ document https://developers.google.com/web/fundamentals/native-hardware/build-for-webusb#linux.

Enabling USB redirection on the server

Perform the following step to enable the USB device redirection on the server:

  • Enable the policy for USB device redirection on the Domain Controller.

    Enabling USB

Configuring USB redirection for Citrix HTML5 client

By default, the USB device redirection feature is enabled on the client if the USB device redirection policy is enabled on the server.

To disable it, edit the configuration.js file and set the value of usb under toolbar to false. This setting is applicable to the StoreFront. The configuration.js file is located in C:\program Files\Citrixactual path\HTML5Client.

    'ui' : {
        'toolbar' : {
                'usb' : false
        },
    }

Behavior of Chrome browser

  • When you click on the padlock icon, the browser tab shows the Secure Connection dialog box. You can see the USB devices for which the browser tab has received user permission. Although there are multiple USB devices, only the devices that the Citrix HTML5 client can redirect appear in the Citrix USB Devices dialog box. Those devices can be used inside a remote session.

    Connection Secure

  • If you want to revoke access permissions granted to the browser tab, click on the x icon next to the USB device. As a result, the Reload button appears. If you click on Reload, the session closes. Relaunch the session for the changes to take effect.

    Reload

Limitations:

  • The USB device redirection feature is not applicable to some USB devices for which the client operating system such as Windows loads the device drivers by default.

  • Only USB Type A devices can be redirected to the session. But, you can connect Type A devices through a Type C connector.

  • Releasing a USB hub device might not result in releasing connected USB Type A devices.

  • HID devices, Mass Storage devices, and Web camera redirection might not work.

  • This feature has been tested and is supported on VDAs running on Windows 10.

  • This feature has been tested for up to two USB devices simultaneously.

DPI scaling

Citrix Workspace app for HTML5 supports DPI scaling for app and desktop sessions on a single monitor.

Citrix Workspace app for HTML5 lets you set the VDA resolution on the monitors that have a high pixel ratio. The DPI scaling feature is disabled by default for app and desktop sessions.

For Citrix Workspace app 1908 for HTML5 and earlier, go to the session toolbar and then select Toolbar > More > Preferences > Display Resolution to set the resolution for app and desktop sessions. The correct resolution is set on the VDA.

For Citrix Workspace app 1909 for HTML5 and later, go to the session toolbar and then select Toolbar > More > Display Resolution > Device Pixel Ratio Scaling to set the resolution for app and desktop sessions. The correct resolution is set on the VDA.

When you set the resolution correctly on the VDA, blurry text becomes crisper.

Limitations:

  • The High DPI scaling feature is disabled on touch screen devices.

Custom Cursor

Citrix Workspace app for HTML5 now supports custom cursors on the Microsoft Internet Explorer (IE). This enhancement ensures that you have a consistent browsing experience across browsers. By default, the custom cursor is enabled.

To disable the custom cursor in Microsoft IE or Edge using configuration.js

The configuration.js file is located in the HTML5Client folder. Edit this file to configure Citrix Workspace app for HTML5 by performing the following step:

Open the configuration.js file and set the value of ‘handleMouseCursorUsingDivForIE’ under ui to false.

‘ui’: { ‘handleMouseCursorUsingDivForIE’ : false }

Customer Experience Improvement Program

Note:

  • When CEIP is disabled, minimal information, containing the installed Citrix Workspace app for HTML5 version is uploaded; this happens weekly. This minimal information is valuable to Citrix because it provides the distribution of different versions used by customers.
  • When Citrix Workspace app for HTML5 is launched in a public session mode, CEIP data is not collected.

No user identifiable information is collected from the customer environment with CEIP; collected information includes:

  • System information details like the version of operating system installed version of Citrix Workspace, language, and the browser version.
  • Usage tracking details like statistics of application launch over the course of a week, monitor resolutions, graphics mode, decoder, renderer.
  • Critical to quality details like connection and launch failures and statistics on session connection time.
  • Configuration tracking details like datapoints tracking to check if a feature is enabled or disabled.

To disable CEIP using configuration.js

In Citrix Workspace app for HTML5, the configuration.js file is located in the HTML5Client folder. Edit this file to configure Citrix Workspace app for HTML5.

Note:

  • Citrix recommends that you back up the configuration.js file before making any changes to it.
  • Citrix recommends using this method only if Citrix Workspace for Chrome is repackaged for users.
  • Administrator-level credentials are required to edit the configuration.js file; after editing the file, repackage the app for the changes to take effect.

For Citrix Workspace app HTML5 versions 1905 and earlier, set the enabled attribute under ceip to false in the configuration.js file.

'ceip':{
    'enabled':false,
}

For Citrix Workspace app HTML5 versions 1906 and later, set the enabled attribute under analytics to false in the configuration.js file.

'analytics':{
    'enabled':false,
}

To disable CEIP using graphical user interface

Note:

You can modify the CEIP settings using graphical user interface only when the administrator has enabled it using configuration.js.

  1. Launch Citrix Workspace app for HTML5.
  2. From the toolbar, select Preferences.
  3. Uncheck Help improve Citrix Workspace by sending anonymous usage statistics.

Note:

Relaunch the session for the changes to take effect.

Selective H.264

Configuring selective H.264 using the configuration.js file

Note:

  • Citrix recommends that you back up the configuration.js file before making any changes to it.
  • Citrix recommends using this method only if Citrix Workspace app for HTML5 is repackaged for users.
  • Administrator-level credentials are required to edit the configuration.js file; after editing the file, repackage the app for the changes to take effect.

By default, selectiveH264 is set to true.

The configuration.js file is located under C:\program Files\Citrix<actual path>\HTML5Client. Edit this file and change selectiveH264 to false as shown below.

h264 snippet image

PDF printing

To configure PDF printing

The Citrix PDF Universal Printer driver enables users to print documents opened with hosted applications or applications running on virtual desktops delivered by XenApp and XenDesktop Version 7.6. When a user selects the Citrix PDF Printer option, the driver converts the file to PDF and transfers the PDF to the local device. The PDF is then opened in a new browser tab for viewing and printing from a locally attached printer.

If you want to enable users to print documents opened with hosted applications or applications running on virtual desktops delivered by XenDesktop 7.6 and XenApp 7.6, complete the following steps.

  1. Download the Citrix PDF Printing Feature Pack and install the Citrix PDF Universal Printer driver on each machine providing desktops or applications for Citrix Workspace app for HTML5 users. After installing the printer driver, restart the machine.
  2. In Citrix Studio, select the Policy node in the left pane and either create a new policy or edit an existing policy. For more information about configuring Citrix Virtual Apps and Desktops policies, see Policies.
  3. Set the Auto-create PDF Universal Printer policy setting to Enabled.

Enhanced PDF printing experience

In earlier releases, when attempting to print a PDF, a Continue print dialog appeared, prompting your confirmation to print.

With this release, the Print window appears within your Citrix Workspace session. You can directly print the document from the Print window.

This enhancement is fully supported and enabled by default in Chrome and Firefox. To disable it in Chrome and Firefox, set the value of supportedBrowsers to false in the configuration.js file. The configuration.js file is located under C:\program Files\Citrix<actual path>\HTML5Client.

This enhancement is partially supported in Internet Explorer 11 with some known limitations, and disabled by default. To enable this feature in Internet Explorer, set the value of IE to true in the configuraton.js file. The configuration.js file is located under C:\program Files\Citrix<actual path>\HTML5Client.

    'pdfPrinting' : {
                  'directPrint' : {


     'supportedBrowsers':true,


                                          'IE':false
                                       }
                                     }

Limitations:

  • In Internet Explorer, the content of a printed PDF is scaled down and does not fit the page.
  • In Internet Explorer, when printing a large file or a file with a large number of pages, the browser might stop responding or the print operation might fail intermittently.
  • This enhancement is not supported for sessions that are launched through the HTML5 HDX SDK.

To suppress the Continue print dialog

When the enhanced printing experience feature is disabled, you can print a PDF by suppressing the appearance of the Continue print dialog.

By default, the‘printDialog’ property of the ‘hide’ objectis set to false.

The configuration.js file is located under C:\program Files\Citrix<actual path>\HTML5Client.

To do this, set the ‘printDialog’ property of the ‘hide’ object to true.

Note:

  • Citrix recommends that you back up the configuration.js file before making any changes to it.
  • Citrix recommends using this method only if Citrix Workspace app for HTML5 is repackaged for users.
  • Administrator-level credentials are required to edit the configuration.js file; after editing the file, repackage the app for the changes to take effect.
    {


       'ui' : {


         "hide":{


            'printDialog': true


         }


       }


     }

Session reliability

With session reliability, the session remains active on the server. To indicate that connectivity is lost, the user’s display freezes until connectivity resumes on the other side of the tunnel. The user continues to access the display during the interruption and can resume interacting with the application when the network connection is restored. Session reliability reconnects users without reauthentication prompts.

Note:

Citrix Workspace app for HTML5 users cannot override the server setting.

You can use session reliability with Transport Layer Security (TLS).

Note:

TLS encrypts only the data sent between the user device and Citrix Gateway.

For more information on configuring session reliability, see Session reliability policy settings in Citrix Virtual Apps and Desktops documentation.

Mobility support

To enable the auto soft keyboard popup

To enable this feature, configure the automatic keyboard policy to display the soft keyboard when clicking any editable area:

  1. Open Citrix Studio on DDC.
  2. Select Policies.
  3. Click Create Policy.
  4. Search for Automatic Keyboard Display and select Allowed.

File Transfer

By default, users can:

  • Upload files from a local download folder or attached peripheral and seamlessly access the data from a Citrix Virtual Apps and Desktops sessions.
  • Download files from a Citrix Virtual Apps and Desktops session to a folder or peripheral on their user device.

Administrators can selectively enable or disable file transfer, uploads, or downloads through policies in Citrix Studio.

Citrix Workspace app for HTML5 supports downloading files on a MacBook using the Safari browser.

Requirements

  • XenApp and XenDesktop 7.6 or later, with:
    • Hotfix ICATS760WX64022.msp on server OS VDAs (Windows 2008 R2 or Windows 2012 R2)
    • Hotfix ICAWS760WX86022.msp or ICAWS760WX64022.msp on client OS VDAs (Windows 7 or Windows 8.1)
  • To change file transfer policies: Group Policy Management (GPM) hotfix GPMx240WX64002.msi or GPMx240WX86002.msi on machines running Citrix Studio

Limitations:

  • A user can upload or download a maximum of 10 files at a time.
  • Maximum file size:
    • For uploads: 2147483647 bytes (2 GB)
    • For downloads: 262144000 bytes (250 MB)

File Transfer policies

By default, file transfer is enabled. Use Citrix Studio to change these policies, located under User Setting < ICA\File Redirection. Consider the following when using file transfer policies:

  • Allow file transfer between desktop and client. Allows or prevents users from transferring files between a Citrix Virtual Apps and Desktops session and their devices.
  • Upload file to the desktop. Allows or prevents users from uploading files from their device to a Citrix Virtual Apps and Desktops session.
  • Download file from desktop. Allows or prevents users from downloading files from a Citrix Virtual Apps and Desktops session to their device.

Clipboard

Prior to introducing this feature, Citrix Workspace did not support copying and pasting HTML-formatted text from a local application to another application (for example, Microsoft Excel) using the Paste Special feature. As a result, the targeted app (in this case, Microsoft Excel) would not retain its HTML formatting characteristics.

Citrix Workspace app for HTML5 supports HTML format in addition to plain text between client and a session. This support is useful for Office apps and browsers. Enhanced clipboard support is only available on Chrome and Safari browsers. You can copy HTML content and retain formatting; when copying a link in Chrome, a <img> tag is added in HTML format, which effectively allows you to copy images as well as text. This feature is richer than plain text but does not work in all applications.

To configure clipboard support, add the following registry entry to the VDA:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\wfshell\Virtual Clipboard\Additional Formats\HTML Format “Name”=”HTML Format”

For additional information about the issues resolved by the introduction of this feature, see Knowledge center article CTX086028.

Warning:

Using Registry Editor incorrectly can cause serious problems that can require you to reinstall the operating system. Citrix cannot guarantee that problems resulting from incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk. Make sure you back up the registry before you edit it.

Enhanced clipboard experience

When you launch multiple Virtual Desktop hosted applications or desktops on Windows, Mac, or Chrome operating systems using the browser based Citrix Workspace app for HTML5, you might want to copy and paste text between the session and your client device. With this feature, you can use the Ctrl C and Ctrl V hotkeys (for Windows or Chrome operating systems) and CMD C and CMD V hotkeys (for Mac operating system) to copy and paste.

This feature is enabled by default.

On Firefox and Edge browsers, to copy the text from a remote session to a local device, press Ctrl C and then click Confirm.

Disable the copy confirmation dialog by selecting the Disable Copy Confirmation check box in Preferences on the toolbar. Clear the check box to enable the option again.

To disable the enhanced clipboard experience

To disable this feature, edit the configuration.js file located inside the HTML5Client folder (C:\Program Files\Citrix\Receiver StoreFront\HTML5Client) and set the value of directClipboard to false.

Limitations:

  • You can copy and paste only plain text and not images and files.
  • Does not support large data.
  • The Ctrl key might remain stuck in the down position. This issue occurs when you press the right Ctrl key for a long time and then press C to copy the text. As a workaround, click the right Ctrl key multiple times.
  • Copying text from a secondary monitor requires an extra click (through the Copy confirmation dialog) for Google Chrome and Safari browsers. For Edge and Firefox browsers, copying text from both, single and secondary monitors requires an extra click.
  • Use the Ctrl c or CMD C and Ctrl V or CMD V keys to copy and paste. Using the Edit menu or right-click option to copy the text might require an extra click using the Confirm dialog.

Toolbar

By default, the enhanced toolbar feature is enabled.

To hide the toolbar:

  1. While logged in as an administrator, access the configuration.js file in C:\ProgramFiles\Citrix<actual path>\HTML5Client.
  2. Search the configuration.js file to locate ‘menubar key.’
  3. In the configuration.js file, set “menubar”:false.

You can also hide an individual icon to prevent it from showing up in the toolbar. For example, to hide the ctrl+alt+del button in the toolbar:

  1. While logged in as an administrator, access the configuration.js file in C:\ProgramFiles\Citrix<actual path>\HTML5Client.
  2. Search the configuration.js file to locate ‘lock.’
  3. In the configuration.js file, set lock:false.

Session sharing

For session sharing to occur, the applications must be hosted on the same machine and must be configured in seamless window mode with the same settings for parameters such as window size, color depth, and encryption. Session sharing is enabled by default when a hosted application is made available.

If App Switcher is installed on the machine providing the applications, a taskbar appears at the bottom of the window. The taskbar displays all the applications currently running in the session, enabling users to switch between those applications. Users can configure the taskbar to auto-hide and switch to small icons to minimize the amount of space taken up by the taskbar.

A floating toolbar containing controls for Citrix Workspace app for HTML5 is displayed in the browser tab, as shown in the following figure. The clipboard button enables users to copy and paste Unicode plain text between the local clipboard on the device and the resource running in the browser. Users can use standard Windows shortcuts to copy data, including text, tables, and images, between hosted applications, both within the same session and between different sessions. Users can also send the CTRL+ALT+DELETE key combination to their desktops and applications using a button on the toolbar.

Chrome html5 toolbar image

When printing a document opened with a hosted application or an application running on a virtual desktop, the user is given the option to print the document to PDF. The PDF is then transferred to the local device for viewing and printing from a locally attached printer. The file is removed from the device when the user closes the PDF.

A user who clicks a link in a document opened using a hosted application is given the choice of whether to open the URL in a hosted browser application within the session or to use the browser on the local device.

HTML5 logs

Citrix Workspace app for HTML5 provides timestamps for the logs generated by the user device.

To assist with troubleshooting issues, you can view Citrix Workspace app for HTML5 session logs.

The log page allows users to:

  • Enable Logging: Enable logging to view the HMTL5 logs.
  • Disable Logging: Disable logging to stop logging in a session.
  • View logs: View the logs generated for a session.
  • Clear logs: Delete the log file generated in a session.
  • Download log file: Download the log file to a desired location.

To view Citrix Workspace app for HTML5 logs by navigating to the log page

  1. Log on to the Citrix Workspace or Web site.
  2. In another browser tab or window, navigate to siteurl/Clients/HTML5Client/src/ViewLog.html, where site url is the URL of the Citrix Workspace app for web site, typically <http://server.domain/Citrix/StoreWeb>.
  3. On the logging page, click Start Logging.
  4. On the Citrix Workspace for Web site, access a desktop or application using Citrix Workspace app for HTML5.

The log file generated for the Citrix Workspace app for HTML5 session is shown on the logging page. You can also download the log file for further analysis.

To view Citrix Workspace app for HTML5 logs using the toolbar

  1. Log on to the Citrix Workspace for Web.
  2. In the Citrix Workspace for Web, access a desktop or application.
  3. From the session toolbar, select Logging.
  4. Click Start Logging.