Manage Options for Unified Service Desk

The Options setting in Unified Service Desk (Settings > Unified Service Desk > Options) lets you manage global name/value pairs that are used by the Unified Service Desk components. To manage the Unified Service Desk options:

  1. Sign in to Microsoft Dynamics CRM.

  2. Go to Settings > Unified Service Desk. (How do I get there?)

  3. Choose Options.

  4. On the Active UII Options page, click New.

  5. On the New Option page, type the option name and corresponding value.

    The following table lists global options for Unified Service Desk and its possible values along with the description.

    Option Name Value and Description

    HideSessionCloseButton

    Set the value to true to hide the close button on the session tabs. If you use this option, you should plan to provide a button or some other method to close a session. You may call the CloseSession action on the Session Tabs hosted control to close the session.

    CRM UI Base Url

    If the URL for accessing the CRM web services is different than the URL for accessing the web UI, you may need to use this option to specify an override. When a user logs in, the system uses the discovery server to determine the web services endpoints but can only imply the URL used for the UI. This option can be used to specify what the URL should be when accessing the GUI.

    AutoUseExternalBrowser

    If this is set to true, the system will use the embedded WPF WebBrowser control until the memory reaches a threshold, and then it will switch to launching the browser in an iexplorer.exe process and attach it to the window.

    Warning

    This method is known to have some issues with security. If you want to activate this mode, it should be thoroughly tested in the target environment. This mode is considered unsupported.

    MemoryLimit

    Specify the value in bytes. This specifies the memory limit that the process can use (working set), before the application refuses to allocate additional browser instances. If this value is specified:

    1. The OutOfMemoryThreshold option will be ignored.

    2. If the AutoUseExternalBrowser option is true, the value specified in the MemoryLimit option will be the memory limit that will trigger the application to launch the browser externally.

    OutOfMemoryThreshold

    This is a threshold value beyond which the application will refuse to allocate additional browser instances. This value is specified in bytes and is subtracted from the maxworkingset value to determine how much memory is allowed for the process. If the AutoUseExternalBrowser option is true, this will be the memory limit that will trigger the application to launch the browser externally.

    MaxReplacementParameterDepth

    Specifies the depth to which nesting of replacement parameters can be done in an expression. Specify an integer value for this option.

    Consider the following example, where you have the following replacement parameters:

    Str3 = "Level 3"

    Str2 = "Level 2 – [[Str3]v]"

    Str1 = "TopLevel – [[Str2]v]"

    If you consider, the following expression:

    Value = [[Str1]]

    Value would result in "TopLevel - Level 2 - Level 3".

    In the above expression, the depth of the nesting of the replacement parameters is 2.

    GenericListener

    Specify a custom URL for the generic listener port. More information: Change the port of generic listener

  6. Click Save.

Important

Apart from these, the Options setting is also used to configure auditing and client caching in Unified Service Desk. More information: TechNet: Configure auditing in Unified Service Desk and TechNet: Configure client caching in Unified Service Desk

See Also

Other Resources

Configure your agent application using Unified Service Desk
TechNet: Unified Service Desk Adminsitration Guide

Unified Service Desk
Send comments about this topic to Microsoft.
© 2015 Microsoft. All rights reserved.