Tutorial 5: mostrar información de sesión mejorada

Artículo
01/22/2025

En el tutorial anterior, Tutorial 4: Mostrar un registro de aplicaciones en una sesión en la aplicación del agente, aprendió a mostrar el registro del cliente almacenado en una sesión en Unified Service Desk. Sin embargo, la experiencia mejoraría si pudiera identificar cada sesión con un nombre único junto con cierta información clave sobre el registro en una sesión.

Este tutorial demuestra cómo mostrar dinámicamente la información del nombre de sesión e información general de sesión para mejorar la experiencia de interacción del cliente para los agentes. Este tutorial se basa en el tutorial anterior, Tutorial 4: Muestre un registro de las aplicaciones de la Interfaz unificada en una sesión en la aplicación del agente.

Requisitos previos

Debe haber completado el Tutorial 1: Cree una aplicación simple del agente para aplicaciones de la Interfaz unificada y el Tutorial 4: Muestre un registro de las aplicaciones de la Interfaz unificada en una sesión de la aplicación del agente. Las configuraciones que completó en estos tutoriales son necesarias en este tutorial.
En este tutorial se da por sentado que usará las mismas credenciales de usuario que en el tutorial 1 para iniciar sesión en la aplicación del agente al final del tutorial para comprobar la aplicación. Si otro usuario comprobará la aplicación, debe asignar el usuario a Configuración de Contoso. Más información: Tutorial 1: Crear una aplicación de agente simple para aplicaciones de la Interfaz unificada
Debe conocer lo siguiente en Unified Service Desk:
- Líneas de sesión y tipo de Pestañas de sesión de control hospedado. Más información: Líneas de sesión (control hospedado) y Pestañas de sesión (control hospedado)
- Configure la información de nombre de sesión e información general de sesión. Más información: Configurar información de sesión
- Filtre el acceso utilizando la configuración de Unified Service Desk. Más información: Administrar el acceso utilizando la configuración de Unified Service Desk

En este tutorial

Paso 1: Cree un tipo de control hospedado de Líneas de sesión para mostrar información general de sesión

Paso 2: Defina información de nombre de sesión

Paso 3: Defina información general de sesión

Paso 4: Agregue los controles a la configuración

Paso 5: Pruebe la aplicación

Conclusión

Paso 1: Cree un tipo de control hospedado de Líneas de sesión para mostrar información general de sesión

Para mostrar información general de sesión en la aplicación del agente, cree una instancia de un tipo de control hospedado Líneas de sesión en la aplicación del agente.

Inicie sesión en el Administrador de Unified Service Desk.
Seleccione Controles hospedados en Configuración básica.
Seleccione + Nuevo.
En la página Nuevo control hospedado, especifique los siguientes valores:

Campo Valor

Nombre Información general de sesión de Contoso

Tipo de componente de USD Líneas de sesión

Grupo de presentación SessionExplorerPanel
Seleccione Guardar.

Campo	Valor
Nombre	Información general de sesión de Contoso
Tipo de componente de USD	Líneas de sesión
Grupo de presentación	SessionExplorerPanel

Paso 2: Defina información de nombre de sesión

Para mostrar dinámicamente el nombre de la pestaña de sesión, configurará una regla de líneas de sesión utilizando los parámetros de sustitución.

Inicie sesión en el Administrador de Unified Service Desk.
Seleccione Líneas de sesión bajo Configuración básica.
Seleccione + Nuevo.

En la página Información de nueva sesión, especifique los siguientes valores:

Campo	Valor
Pedido	Cualquier valor aleatorio; por ejemplo, 5
Nombre	Nombre de sesión de Contoso
Entidad seleccionada	cuenta
Tipo	Nombre de sesión
Pantalla	Sesión: [[account.name]] Estamos usando los parámetros de sustitución para definir el formato del nombre de la pestaña de sesión. En este caso el nombre de la sesión será Sesión: seguido del nombre del registro de la cuenta que se muestra en la sesión.

Seleccione Guardar.

Paso 3: Defina información general de sesión

Defina la información general de sesión para mostrar en el tipo de control hospedado de Líneas de sesión que ha configurado en el paso 1.

Inicie sesión en el Administrador de Unified Service Desk.
Seleccione Líneas de sesión bajo Configuración básica.
Seleccione + Nuevo.

En la página Información de nueva sesión, especifique los siguientes valores.

Orden: Cualquier valor aleatorio; por ejemplo, 6.
Nombre: Información general de sesión de Contoso
Entidad seleccionada: cuenta
Tipo: Información general de sesión

Visualización:

<Grid Margin="0"      xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"      xmlns:CCA="clr-namespace:Microsoft.Crm.UnifiedServiceDesk.Dynamics;assembly=Microsoft.Crm.UnifiedServiceDesk.Dynamics">  
  <Grid.RowDefinitions>  
    <RowDefinition Height="auto" />  
    <RowDefinition Height="auto" />  
    <RowDefinition Height="auto" />  
    <RowDefinition Height="auto" />  
    <RowDefinition Height="auto" />  
    <RowDefinition Height="auto" />  
  </Grid.RowDefinitions>  
  <Grid.ColumnDefinitions>  
    <ColumnDefinition Width="80"/>  
    <ColumnDefinition Width="*" />  
    <ColumnDefinition Width="auto" />  
  </Grid.ColumnDefinitions>  
  <TextBlock Margin="5,0,0,0" Grid.Row="0" TextWrapping="Wrap" Padding="3,0,0,3" Grid.ColumnSpan="3" FontFamily="Tohoma" FontSize="14" Style="{DynamicResource AutoCollapse}" Text="Primary Contact: [[account.primarycontactid.name]x]" />  
  <TextBlock Margin="5,0,0,0" Grid.Row="1" TextWrapping="Wrap" Padding="3,0,0,3" Grid.ColumnSpan="3" FontFamily="Tohoma" FontSize="14" Text="[[account.address1_line1]x]"/>  
  <TextBlock Margin="5,0,0,0" Grid.Row="2" TextWrapping="Wrap" Padding="3,0,0,3" Grid.ColumnSpan="3" FontFamily="Tohoma" FontSize="14" Style="{DynamicResource AutoCollapse}" Text="[[account.address1_line2]+x]" />  
  <TextBlock Margin="5,0,0,0" Grid.Row="3" TextWrapping="Wrap" Padding="3,0,0,3" Grid.ColumnSpan="3" FontFamily="Tohoma" FontSize="14" Style="{DynamicResource AutoCollapse}" Text="[[account.address1_line3]+x]" />  
  <TextBlock Margin="5,0,0,0" Grid.Row="4" TextWrapping="Wrap" Padding="3,0,0,3" Grid.ColumnSpan="3" FontFamily="Tohoma" FontSize="14" Style="{DynamicResource AutoCollapse}" Text="[[account.address1_city]x], [[account.address1_stateorprovince]x] [[account.address1_postalcode]x]" />  
  <TextBlock Margin="5,0,0,0" Grid.Row="5" TextWrapping="Wrap" Padding="3,0,0,3" Grid.ColumnSpan="3" FontFamily="Tohoma" FontSize="14" Style="{DynamicResource AutoCollapse}" Text="Phone: [[account.telephone1]x]" />  
</Grid>

Nota

Este ejemplo se usa XAML y parámetros de recambio para definir la información general de la sesión que muestra el contacto principal, dirección, y el número de teléfono de la cuenta actual en el área información general de la sesión.

Seleccione Guardar.

Paso 4: Agregue los controles a la configuración

En este paso, agregará el control hospedado y las reglas de línea de sesión que se configuraron en este tutorial a Configuración de Contoso para mostrar estos controles al usuario que está asignado a la configuración. Se creó una Configuración de Contoso en Tutorial 1: Cree una aplicación simple del agente para aplicaciones de la Interfaz unificada.

Agregue lo siguiente a Configuración de Contoso.

Nombre del control	Tipo de control
Información general de sesión de Contoso	Control hospedado
Nombre de sesión de Contoso	Línea de sesión
Información general de sesión de Contoso	Línea de sesión

Para agregar un control a la configuración:

Inicie sesión en el Administrador de Unified Service Desk.
Seleccione Configuración en Configuración avanzada.
Seleccione Configuración de Contoso para abrir la definición.
Seleccione la pestaña Controles hospedados, eventos y llamadas a la acción.
Seleccione los puntos suspensivos (...) en la sección Controles hospedados y luego seleccione Agregar control hospedado existente. Se muestra el panel Registros de búsqueda.
Escriba el nombre de la llamada a la acción mencionada en la tabla anterior en el cuadro de búsqueda. Las llamadas a la acción se muestran en los resultados de la búsqueda. Seleccione el registro de la lista y, a continuación, seleccione Agregar.
Seleccione la pestaña Líneas de sesión, scripts de agente y scriptlets.
Seleccione los puntos suspensivos (...) en la sección Líneas de sesión y luego seleccione Agregar línea de sesión existente. Se muestra el panel Registros de búsqueda.
Escriba el nombre de la línea de sesión mencionada en la tabla anterior en el cuadro de búsqueda. La línea de sesión se muestra en los resultados de búsqueda. Seleccione el registro de la lista y, a continuación, seleccione Agregar.
Seleccione Guardar.

Paso 5: Pruebe la aplicación

Inicie la aplicación cliente de Unified Service Desk e inicie sesión en la instancia de Dynamics 365 donde configuró Unified Service Desk mediante las mismas credenciales de usuario que asignó a la Configuración de Contoso en Tutorial 1: crear una aplicación simple de agente para aplicaciones de Interfaz unificada. Para obtener información sobre la conexión con una instancia de Dataverse utilizando la aplicación cliente de Unified Service Desk, vea Conectarse a una instancia de aplicación basada en modelo con el cliente de Unified Service Desk
Haga clic en la flecha hacia abajo junto al botón Buscar en la barra de herramientas, y luego haga clic en Cuenta para mostrar los registros de cuenta de la aplicación basada en modelo.
Haga clic en el ampliador para mostrar el panel izquierdo (SessionExplorerPanel).
Haga clic en cualquiera de los registros de cuenta para mostrar la información de cuenta respectiva en una sesión en la aplicación del agente. Tenga en cuenta que el nombre de la pestaña de sesión muestra automáticamente la palabra Sesión: seguido del nombre de la cuenta actual. El panel izquierdo muestra la información general de la sesión que se definió anteriormente.
Si abre otro registro de cuenta, se mostrará en otra sesión en la aplicación cliente. Para abrir otra cuenta, haga clic en la flecha abajo junto al botón Buscar, haga clic en Cuenta, y luego haga clic en un nombre de cuenta para mostrar la información de cuentas en otra sesión.

Conclusión

En este tutorial, aprendió a usar reglas de configuración de líneas de sesión para mostrar en contexto el nombre de la pestaña de sesión e información general clave sobre el registro en una sesión en la aplicación del agente. También aprendió a filtrar acceso a los controles de Unified Service Desk con la configuración.