Product Documentation

User experience

May 19, 2017

Citrix Receiver for HTML5 integrates with Citrix Receiver for Web sites. To access their virtual desktops and hosted applications using Citrix Receiver for HTML5, users navigate to a Citrix Receiver for Web site using a compatible browser running on a supported operating system.

The user experience with Citrix Receiver for HTML5 is as follows:

  • If you did not configure the site to always use Citrix Receiver for HTML5, the site attempts to determine whether Citrix Receiver is installed locally on devices running Windows and Mac OS X. When Citrix Receiver cannot be detected, users are prompted to download and install the appropriate Citrix Receiver for their platform. For users who are unable to install Citrix Receiver, this happens every time they log on to the Citrix Receiver for Web site. Users who already have Citrix Receiver installed locally must use this version to access resources from the site and are not given the option to use Citrix Receiver for HTML5. When you configure the Citrix Receiver for Web site to always use Citrix Receiver for HTML5, all users must access resources from the site through Citrix Receiver for HTML5 regardless of whether they have a locally installed version of Citrix Receiver.
  • When users access a desktop or application through Citrix Receiver for HTML5, the resource starts in a new browser tab or window, according to the user's browser settings. You can configure Citrix Receiver for HTML5 so that resources are always started in the same tab as the Citrix Receiver for Web site. For more information, see To configure Citrix Receiver for HTML5 use of browser tabs.
  • When a user starts an additional application, Citrix Receiver for HTML5 checks whether the application can be started within an existing session before creating a new session. This enables users to access multiple applications over a single connection so that the available resources are used more efficiently.

File Transfer

By default, users can:

  • Upload files from a local download folder or attached peripheral and seamlessly access the data from a XenDesktop sessions.
  • Download files from a XenDesktop 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.
Requirements

  • XenDesktop 7.6 or XenApp 7.6, 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 virtual XenDesktop session and their devices.
  • Upload file to the desktop. Allows or prevents users from uploading files from their device to a virtual XenDesktop session.
  • Download file from desktop. Allows or prevents users from downloading files from a virtual XenDesktop session to their device.

Enhanced clipboard support

Prior to introducing this feature, Citrix Receiver 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.
Starting with Version 1.9, 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.

Configuring 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\Receiver StoreFront\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\Receiver StoreFront\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 Receiver 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.

localized 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.

Citrix Receiver for HTML5 logs

To assist with troubleshooting issues, you can view Citrix Receiver 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 Receiver for HTML5 logs by navigating to the log page:

  1. Log on to the Citrix Receiver for Web site.
  2. In another browser tab or window, navigate to siteurl/Clients/HTML5Client/src/ViewLog.html, where siteurl is the URL of the Citrix Receiver for Web site, typically http://server.domain/Citrix/StoreWeb.
  3. On the logging page, click Start Logging.
  4. On the Citrix Receiver for Web site, access a desktop or application using Citrix Receiver for HTML5.
The log file generated for the Citrix Receiver for HTML5 session is shown on the logging page. You can also download the log file for further analysis.
 
To view Citrix Receiver for HTML5 logs using the toolbar:
  1. Log on to the Citrix Receiver for Web.
  2. In the Citrix Receiver for Web, access a desktop or application.
  3. From the session toolbar, select Logging.
  4. Click Start Logging.