Product Documentation

UI Agent Personalization

Mar 27, 2018

These options allow you to personalize the look and feel of the Citrix Workspace Environment Management session agent in UI mode, as well as help desk and self-service facilities.

Note

These options apply to the session agent in UI mode only. They do not apply to the session agent in CMD mode.

UI Agent Options

These settings let you customize the appearance of the session agent (in UI mode only) in the user's environment.

Custom Background Image Path. If entered, will display a custom image when the session agent launches/refreshes, rather than the Citrix Workspace Environment Management logo. The image used must be accessible from the user environment. It is recommended you use a 400*200px .bmp file.

Loading Circle Color. Allows you to modify the color of the loading circle to fit your custom background.

Text Label Color. Allows you to modify the color of the loading text to fit your custom background.

UI Agent Skin. Allows you to select a preconfigured skin to use for dialogs and self service forms (printers/applications). Note: This does not change the splash screen.

Hide Agent Splashscreen. If enabled, hides the splash screen when the session agent is loading/refreshing. This takes effect after the session agent has refreshed while the setting is enabled.

Hide Agent Icon in Published Applications. If enabled, published applications do not show the Citrix Workspace Environment Management session agent.

Hide Agent Splashscreen in Published Applications. If enabled, hides the session agent splash screen for published apps running through it.

Only Admins Can Close Agent. If enabled,  only administrators can shut down the Citrix Workspace Environment Management session agent.

Allow Users to Manage Printers. If enabled, users can access the Citrix Workspace Environment Management session agent Manage Printers menu to assign a default printer and modify print preferences.

Allow Users to Manage Applications. If enabled, users can access the Citrix Workspace Environment Management session agent Manage Applications menu to manage where their application shortcuts are created. Shortcuts created in self-healing mode cannot be deleted using this menu.

Prevent Admins to Close Agent. If enabled, administrators cannot shut down the Citrix Workspace Environment Management session agent.

Enable Applications Shortcuts. If enabled, users can run applications from the Manage Applications menu.

Disable Administrative Refresh Feedback. When Administrators force a session agent to refresh from the Administration Console, this options prevents a notification tooltip appearing in the user environment.

Helpdesk Options

These options control the Agent Host's help desk functionalities.

Help Link Action. This field controls what happens when the user clicks on the Help command in the Citrix Workspace Environment Management Agent Host.

Custom Link Action. This field controls what happens when the user clicks on the Support command in the Citrix Workspace Environment Management Agent Host.

Enable Screen Capture. If enabled, users are given the option to open a screen capture utility. This allows the user to screenshot any errors in their environment, which they can then send to your support staff.

Enable Send to Support Option. If enabled, the user is able to send screenshots and log files directly to the nominated support email address, with the specified template. This requires a working, configured email client.

Custom Subject. If enabled, the support email generated by the Citrix Workspace Environment Management Agent Host screen capture utility is sent with the specified subject.

Email Template. This field allows you to specify a template for the support email generated by the Citrix Workspace Environment Management Agent Host screen capture utility. Note You must configure the email template to include useful information.

See Dynamic tokens for a list of hash-tags which can be used in the email template. Note Users are only presented with the option to enter a comment if the ##UserScreenCaptureComment## hash-tag is included in the email template.

Use SMTP to Send Email. If enabled, this will send the support email using SMTP instead of MAPI.

Test SMTP. Tests your SMTP settings as entered above to verify that they are correct.

Power Saving

Shut Down At Specified Time. If enabled, the Agent Host will automatically shut off the environment it is running in at the specified local time.

Shut Down When Idle. If enabled, the Agent Host will automatically shut off the environment it is running in after running idle (no user input) for the specified length of time.