Product Documentation

User experience

May 17, 2017

After installing and configuring Citrix Receiver for Chrome, select the Citrix Receiver icon in the Chrome apps list to start Receiver for Chrome, as shown in the following figure. To remove Citrix Receiver for Chrome from their devices, right-click the Citrix Receiver icon in the Chrome apps list and select Uninstall.

localized image

Desktops and applications appear after logging in. You can search for resources and click an icon to start a desktop or application in a new window.

When you start an additional application, Citrix Receiver for Chrome checks if the application can be launched in an existing session before creating a new session. This enables you to access multiple applications in a single session.

For session sharing, 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.

By default, session sharing is enabled when a hosted application is made available.

You 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. Only Unicode plain text can be copied and pasted between hosted applications and the local clipboard on the device.

Users can use standard Windows keyboard shortcuts with Citrix Receiver for Chrome because these shortcuts are passed from Chrome OS to hosted applications. Similarly, shortcuts specific to particular applications can also be used, provided they do not conflict with any Chrome OS shortcuts. However, note that the Windows key must also be pressed for function keys to be recognized, so an external keyboard is required. For more information about using Windows keyboards with Chrome OS, see https://support.google.com/chromebook/answer/1047364. Citrix-specific shortcuts, such as those for switching between sessions and windows, cannot be used with Citrix Receiver for Chrome.

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 or Google Cloud Print. The file is not stored in Citrix Receiver for Chrome.

Enable logging 

To assist with troubleshooting connection issues, logs can be generated on both the user device and the machines providing desktops and applications,

To enable logging on user devices

  1. On the user device, select the button with a settings image on it in the bottom-right corner of the Citrix Receiver for Chrome login page.
  2. In the Settings dialog , select Start Logging.

    Details of the collected log files are listed in the Settings dialog.

  3. Select Stop Logging to end the collection of logs on the user device.

Separate icons in Chrome OS task bar

Applications and desktops configured using XenApp and XenDesktop in an active session are displayed as separate apps in the taskbar (shelf) on a Chrome device. This feature applies to published applications and desktops. The functionality and behavior of this feature is similar to the taskbar experience that is provided by the Windows Operating system.

By default, this feature is disabled and can be enabled by administrators only.

Configuring task bar icons using Google Admin policy

Note

Citrix recommends using this method only when Citrix Receiver for Chrome is repackaged for users.

Log on to the Google Admin Console.

Go to Device management > Chrome Management > User Settings.

Add the below strings to the policy.txt file.

localized image

Click Save and close the file.

Configuring taskbar icons using the Web.config in StoreFront

Note

Citrix recommends that you use the web.config file method for configuration purposes only when a store version of Citrix Receiver for Chrome is being used.

  1. Open the web.config file for the Citrix Receiver for Website. This file is typically located in C:\inetpub\wwwroot\Citrix\<Storename>Web, where Store name is the name specified for the Store when it was created.
  2. Locate the chromeAppPreferences field and set its value with the configuration as a JSON string.

For example:

Code Copy

chromeAppPreferences='{"seamless":{"showInShelf":true}}

Configuring taskbar icons using the configuration.js file

The configuration.js file is located in the ChromeApp root folder. Access this file directly to make changes to Citrix Receiver for Chrome.

Note: Administrator-level credentials are required to edit the configuration.js file; after editing the file, repackage the app for the changes to take effect.

To change the Chrome OS taskbar using the configuration.js file:

  1. Open the configuration.js file and set the showInShelf attribute to true.

For example:

localized image
Limitations:
  1. When more than one instance of the same application is launched, the app icon is not stacked and appears as two separate icons. For example, two instances of notepad display two icons of notepad in the taskbar.
  2. When users hover over an app in the shelf entry, the tooltip indicates the name of the main app from where the app is launched.
  3. App pinning is not supported.

Configuring CEIP

Note

  1. When CEIP is disabled, minimal information, containing the installed Receiver for Chrome version is uploaded; this happens weekly. This minimal information is valuable to Citrix because it provides the distribution of different versions used by customers. 
  2. When Citrix Receiver for Chrome 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 Receiver, language, and the browser version.
  • Usage tracking details like statistics of application launch over the course of a week, monitor resolutions, graphics mode, decoder, and renderer.
  • Critical to quality details like connection and launch failures and statistics on session connection time.
  • Configuration tracking details like data points tracking to check if a feature is enabled or disabled.

To disable CEIP using Google Admin Policy

Note: Administrator-level credentials are required to perform this procedure

  1. Log on to the Google Admin Console.
  2. Go to Device management > Chrome Management > User Settings.
  3. Add the below strings under the engine_settings key to the policy.txt file.
  4. Click Save.

For more information on google policy, see Knowledge Center article CTX141844.

localized image

To disable CEIP using configuration.js

The configuration.js file is located in the ChromeApp root folder. Edit this file to configure Citrix Receiver for Chrome.

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 Receiver 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.
  1. Open the configuration.js file and set the enabled attribute under ceip to false.
    For example:  
localized image

To disable CEIP using graphical user interface 

Note

You can modify the CEIP settings using GUI only when the administrator has enabled it using any of the above methods. 

  1. Launch Citrix Receiver for Chrome.
  2. Select Settings > General
  3. Uncheck Help improve Receiver by sending anonymous usage statistics.

Relaunch the session for the changes to take effect.

To disable CEIP using configuration.js using the web.config file

  1. Open the web.config file for Citrix Receiver for website.
    This file is typically located in the C:\inetpub\wwwroot\Citrix\<Storename>Web folder, where Storename is the name specified for the store when it was created.
  2. Locate the chromeAppPreferences field and set its value with the configuration as a JSON string.
    For example:
Code Copy

chromeAppPreferences='{"ceip":{" enabled":false}}

Redesigned toolbar

Citrix Receiver for Chrome provides a redesigned toolbar to improve the user experience. This enhancement provides new options that are accessible from the toolbar to facilitate common tasks, such as:

  • switching to full-screen mode
  • upload or download a file
  • copy content from an active session to the clipboard to enable sharing between sessions
  • access additional options
localized image

Configuring redesigned toolbar

By default, the enhanced toolbar is enabled.

To hide the toolbar configuration using the configuration.js file:

The configuration.js file is located in the ChromeApp root folder. Edit this file directly to make changes to Citrix Receiver for Chrome.

  1. Open the configuration.js file and set the menubar attribute to false.

You can also hide an individual icon to prevent it from displaying in the toolbar. For example, to hide the Ctrl+Alt+Del button in the toolbar:

  1. Open the configuration.js file and set the lock attribute to false.

Note

  • Citrix recommends that you back up the configuration.js file before making any changes to it.
  • Administrator- level credentials are required to edit the configuration.js file; after editing the file, repackage the app for the changes to take effect.

Connection Center

Connection Center facilitates application management in seamless sessions. This is done by providing a taskbar that lists all opened applications.

To launch the Connection Center, right- click the Citrix Receiver icon and then select Connection Center.

localized image

Using Connection Center, you can select an application and:

  1. Display devices.
  2. Send a Crtl+Alt+Del command.
  3. Disconnect from a session.
  4. Logoff from the session.
localized image

You can also terminate an app using the Connection Center by selecting the radio button of the corresponding application and clicking Terminate.

Seamless window integration

Citrix Receiver for Chrome improves the user experience by adding seamless integration of multiple apps hosted in separate windows within an active session. Using this functionality, Citrix Receiver for Chrome enables you to launch applications in an independent user interface compared as opposed to launching all apps for a session in a single window.

Seamless applications can be hosted in separate windows; with this functionality, remote applications are run natively on the client device.

localized image

Limitations

  • Extra entries appear in the Chrome task bar; click any of these to bring the selected session to the front.
  • All opened apps in an active session run in a single window; focusing on one app in an active session brings that window into focus along with all other apps belonging to that session.
Use the seamless session taskbar to quickly move between apps:
localized image

Tip

All apps in one session run in a single window. When moving an app to a second monitor, all apps that are part of that session move to the second monitor.

Reload store URL button

In Citrix Receiver for Chrome window,a button is added for reload operation. By clicking the button, the cookies of the store get cleared and the store page is reloaded.