Session management in Unified Service Desk
Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016
Whenever you search for customer information in Unified Service Desk, the system fetches the information from Microsoft Dynamics 365, and stores it in a session. The information about the session and the fetched customer record is stored in the session context. You can view information about the session and the session context in the $Session and $Context parameters in the Debugger hosted control.
Each session in the Unified Service Desk client is displayed in a tab in the main screen, and you can identify a session using the session name displayed on the tab. An area of the screen just below the tab displays information related to the customer. This section is called the session overview area, and can contain XAML markup that displays UI elements such as text boxes, buttons, or links. Both of these areas can display any information from either the session context or data from displayed windows, CTI search results, or entity searches that have executed.
In This Topic
Session and context information
Session name
Session overview
Session and context information
Let us see how the session and context data is stored in Unified Service Desk when you search for customer information.
Start the Unified Service Desk client application, and sign in to Microsoft Dynamics 365.
Click Search in the toolbar, and then click an account name to search for it.
The customer information is displayed in a session tab. Open the Debugger hosted control by clicking the down arrow next to the settings option in the top-right corner, and selecting Debug.
Click the Data Parameters tab, and expand $Session to see the current session information.
.jpeg "Current session information")
Now, expand the $Context parameter to view information about the customer record such as the customer ID, address, and so on. You will also find information about the session.
.jpeg "Current session context information")
Session name
A session name is the label text that is displayed on the tab; it helps identify the session to the agent.
.jpeg "Session name in Unified Service Desk")
In this example, there are two session tabs with the following session names: Adventure Works (sample)-US and Thomas Andersen (sample) – Information.
The first session tab is for the account, and the second session tab is for the case. You can define the format of the text for the session name for an entity using the Session Lines configuration (Settings > Unified Service Desk > Session Lines) in Dynamics 365. For more information, see Configure the session tab name format.
Session overview
Session overview entries are unique in the fact that more than one may display in a stacking fashion in the user interface (UI) area. Each session overview entry that has all replacement parameters successfully replaced will display in the output window. For example, the following two session overview entries are available for the Adventure Works (sample)-US session tab: General and Social Info.
.jpeg "Session overview entries in Unified Service Desk")
These entries are not typically populated by a business user, however, a skilled business user may copy and paste existing entries and replace values that will meet their needs. This is because the entries are actually XAML markup often seen in Microsoft Silverlight or Windows Presentation Foundation (WPF) applications. They can be created with designer tools such as Blend for Visual Studio in a graphical fashion, or with a text editor. The XAML markup must be properly formatted for it to display correctly in Unified Service Desk.
You can define the session overview information for an entity using the Session Lines configuration (Settings > Unified Service Desk > Session Lines) in Dynamics 365. For more information, see Define session overview information.
See Also
Configure session information
Session Lines (Hosted Control)
Session Tabs (Hosted Control)
Debugger (Hosted Control)
Walkthrough 4: Display a Microsoft Dynamics 365 record in a session in your agent application
Walkthrough 5: Display enhanced session information by displaying session name and overview data
Unified Service Desk 2.0
© 2017 Microsoft. All rights reserved. Copyright