Citrix Workspace For Html5



When launching Application/Desktop using HTML5 receiver/workspace app, new tab to launch the app opens with 'Starting AppName' and then disappears in a few seconds. Looking at the VDA we could see events inside System event viewer Source 'TDICA' 'ICA transport driver connection closed'. As opposed to existing as a separate process, Citrix Workspace App for HTML5 operates within the frame and process space of the browser itself. As such the browser has the ability to enforce certain security parameters.

Type Definitions¶

connectionParams¶

Configuration options to create the session.

Type¶

  • Object

Properties:¶

NameTypeDescription
connectionParamsObject
Properties
NameTypeAttributesDescription
launchTypeString <optional>
Takes 'newtab' or 'embed' as value. Defaults to 'newtab'.
'newtab' - launches the session in a new tab.
'embed' - Opens the session in an Iframe.
containerObjectSpecifies the ID and the type of container for the session when launchType is embed.
Properties
NameTypeDescription
idStringID of the iframe element to embed the session. Mandatory parameter when launchType is embed.
typeStringType of the element to embed the session. Should be set to 'iframe'.
boundsObject <optional>
Sets a fixed width and height to the session.
Properties
NameTypeDescription
autoresizebooleanShould be set to false to give fixed width and height to session. By default, this value is set to true in which case the session is resized to match the size of iframe element or the tab.
widthNumberWidth of the session specified in pixels. This value will be set only when autoresize is set to false.
heightNumberHeight of the session specified in pixels. This value will be set only when autoresize is set to false.
closeOptionsObject <optional>
Action on disconnecting the session. Defaults to type='close'.
Properties
NameTypeDescription
typeStringSpecifies the type of action.
type=”redirectUrl” would redirect the tab to the URL specified in value.
type=”close” would set the iframe src to 'about:blank' when launchType is 'embed' and closes the tab when launchType is 'newtab'.
valueStringSpecifies the URL to be redirected. When type is set to 'close',this value would be ignored.
showDisconnectAlertbooleanA prompt would be shown to the user to stay/leave the current page when the session is about to disconnect due to the actions like close/reload of the tab.
If the value is set to true then the prompt is displayed otherwise prompt won't be shown.
Default value is true.
preferredLangString <optional>
Specifies the preferred language code to be used inside the session. If the language code specified is either invalid or unsupported then it falls back to 'en'.
Supported language codes : en, de, es, fr, ja, ko, ru, zh, zh-cn, zh-tw
If the value is unspecified then the browser's language code is used.
preferencesObject <optional>
JSON to hide/show toolbar or individual toolbar items, suppressing the FTU, URLRedirection and error dialog.
Refer to the example below.

Example¶

Listener to handle the events.

Parameters¶

NameTypeDescription
eventObjectObject as appropriate to the eventType registered.

Properties¶

NameTypeDescription
event.idStringId of the session object.
event.typeStringEvent Type triggered.
event.dataObjectData as appropriate to the event triggered.
- onConnection
- onConnectionClosed
- onURLRedirection
- onError
- onResize

onSessionCreated(sessionObject)¶

Callback having the session object created.

Parameters¶

NameTypeDescription
sessionObjectSessionSession object to interact with the session like register and handle events, start and disconnect.

Example¶

downloadWhy can't I download this file?
  • Receiver for Chrome Client logs

  • Receiver for Chrome Console logs

  • Receiver for HTML5 Client logs

  • Receiver for HTML5 Console logs

  • Instructions

    Instructions to collect Receiver for Chrome Client logs

    Complete the following steps to collect Receiver for Chrome client logs:

    1. Click on “Settings” button at the right bottom corner of the Receiver logon screen.

    2. Click “Start Logging” button to enable logging from the “Account” dialog.
      Notice, the button changes to “Stop Logging”. This indicates logging is enabled.

    3. Close the “Account” dialog.

    4. Launch your XenDesktop/XenApp session on which the problem is reproducible.
      Continue to work on the session to reproduce the issue.

    5. Once the problem is reproduced, close the session.

    6. Click the “Settings” button again to open the “Account” dialog.

    7. The “Account” dialog shows the list of log files captured.

    8. Moving the mouse on top of the file shows small arrow at the right

    9. Click on the button to download and save the file.

    10. Save all the log files listed under “Log Files” and share it with the administrator or Citrix support engineer.

    11. Click on “Stop Logging”

    Note: In case of Kiosk mode, files can be saved to a “USB removable device”.

    Instructions to collect Receiver for Chrome console logs

    Citrix Html5 Video

    Complete the following steps to collect Receiver for Chrome console logs:

    1. Open “chrome://inspect” page in chrome browser.

    2. Go to Apps tab.

    3. Click on “inspect” on all windows related to Citrix receiver : SessionWindow.html, Main.html (and its child nodes).

    4. Click on “console” in opened developer tool.

    5. Save the log via right click “save as” option to a file.

    Instructions to collect Receiver for HTML5 client logs

    1. Log on to the Receiver for Web site.
    2. For Citrix Workspace app HTML5 versions 1908 and later, open a new tab and navigate to siteurl/Clients/HTML5Client/src/SessionWindow.html#engineType=log, where siteurl is the URL of the Receiver for Web site (http://server.domain/Citrix/StoreWeb).
    For Citrix Workspace app HTML5 versions 1907 and earlier, open a new tab and navigate to siteurl/Clients/HTML5Client/src/ViewLog.html, where site url is the URL of the Citrix Receiver for Web site (http://server.domain/Citrix/StoreWeb).
    3. On the logging page, click Start Logging
    4. On the Receiver for Web site, access a desktop or application using Receiver for HTML5
    5. The log file generated for the Receiver for HTML5 session is shown on the logging page. You can also download the log file for further analysis.

    Notes

    1. Logging will be enabled for subsequent session launches, and not for the current active session (if any)
    2. For Receiver for HTML5 version 2.2 and above a tool bar menu “Logging” has been added to enable and view the logs for Receiver for HTML5

    Instructions to collect Receiver for HTML5 console logs

    1. Open Developer tools on the browser tab where session is running. For example, on chrome browser Developer tools can be found under “More Tools” option.
    2. Click on “console” in opened developer tool.
    3. Save the log via right click “save as” or by copying text.
    Citrix workspace for apple

    For USB redirection related issues:

    Workspace for Chrome (formerly known as Receiver for Chrome)

    1. Before collecting the Workspace for Chrome (formerly known as Receiver for Chrome) logs, Please enable moreLogs for USB by adding the moreLogs configuration key in chromeAppPreferences in web.config file on the storefront.
    • chromeAppPreferences ='{'moreLogs':{'usb':true}}'
    2. Please share the logs from chrome://device-log as well

    Workspace for HTML5 (formerly known as Receiver for HTML5)

    1. Before collecting the Workspace for HTML5 (formerly known as Receiver for HTML5) logs, Please enable moreLogs for USB by adding the moreLogs configuration key in configuration.js file 'moreLogs':

    Citrix Workspace App For Html5 Download

    {
    'usb': true

    Citrix Workspace Html5 Error

    }
    2. Please share the logs from chrome://device-log as well