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.

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.

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.