User experience

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

The user experience with Citrix Workspace app for HTML5 is as follows:

  • If you did not configure the site to always use Citrix Workspace app for HTML5, the site attempts to determine whether Citrix Workspace is installed locally on devices running Windows and Mac OS X. When Citrix Workspace cannot be detected, users are prompted to download and install the appropriate Citrix Workspace for their platform. For users who are unable to install Citrix Workspace, this happens every time they log on to the Citrix Workspace app for Web site. Users who already have Citrix Workspace installed locally must use this version to access resources from the site and are not given the option to use Citrix Workspace app for HTML5. When you configure the Citrix Workspace for Web site to always use Citrix Workspace app for HTML5, all users must access resources from the site through Citrix Workspace app for HTML5 regardless of whether they have a locally installed version of Citrix Workspace.

  • When users access a desktop or application through Citrix Workspace app for HTML5, the resource starts in a new browser tab or window, according to the user’s browser settings. You can configure Citrix Workspace app for HTML5 so that resources are always started in the same tab as the Citrix Workspace for Web site.

  • When a user starts an additional application, Citrix Workspace app 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.

  • Citrix Workspace app for HTML5 supports displaying titles of the applications and desktops in parentheses (for example, VDA(1) and VDA(2)) in the browser tab. To enable this feature, select Launch applications in the same tab as Receiver for Web in StoreFront. For more information, see Configure.

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.

Enhanced clipboard support

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.

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

Citrix Workspace app for 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.