Tutorial 3: Mostrar registros de aplicaciones basada en modelo (aplicaciones de la Interfaz unificada) en la aplicación de agente
Este tutorial demuestra cómo mostrar registros de aplicaciones basadas en modelo en la aplicación del agente. En este tutorial, usted mostrará todos los registros de cuentas y contactos en las aplicaciones basadas en modelo. También creará un botón de búsqueda con los elementos de menú desplegable para mostrar cuentas y contactos en la aplicación del agente.
Requisitos previos
Debe haber completado Tutorial 1: Crear una aplicación de agente simple para aplicaciones de la Interfaz unificada. Las configuraciones que completó en el tutorial 1 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:
Los dos tipos de controles hospedados siguientes: Página de Interfaz unificada y Contenedor de barra de herramientas. Más información: Referencia de tipos de control hospedado y acciones/eventos
Llamada a la acción y cómo configurarla. Más información: Llamadas a la acció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 2: Cree un tipo de control hospedado Contenedor de barra de herramienta
Paso 3: Agregue una barra de herramientas y adjúntela al contenedor de barra de herramientas
Paso 4: Agregue botones de la barra de herramientas y llamadas a la acción para mostrar registros
Paso 5: Agregue los controles a la configuración
Paso 1: Cree el tipo de página de controles hospedados de Interfaz unificada para mostrar registros de cuentas y de contactos
En este paso, creará dos controles hospedados del tipo Página de Interfaz unificada para mostrar los registros de cuentas y contactos respectivamente.
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 Búsqueda de cuenta de Contoso Nombre para mostrar Contoso: Cuentas Tipo de componente de Unified Service Desk Página de Interfaz unificada Permitir varias páginas No Precargar datos Activado La aplicación es global Activado Grupo de presentación MainPanel Seleccione Guardar.
Seleccione + Nuevo para crear otro control hospedado para mostrar registros de contactos.
En la página Nuevo control hospedado, especifique los siguientes valores:
Campo Valor Nombre Búsqueda de contactos de Contoso Nombre para mostrar Contoso: Contactos Tipo de componente de Unified Service Desk Página de Interfaz unificada Permitir varias páginas No Precargar datos Activado La aplicación es global Activado Grupo de presentación MainPanel Seleccione Guardar.
Paso 2: Cree un tipo de control hospedado Contenedor de barra de herramienta
Los tipos de controles hospedados Contenedor de barra de herramientas se usan para contener y mostrar las barras de herramientas en Unified Service Desk. En esta sección, creará un tipo de control hospedado Contenedor de barra de herramientas que aparecerá en la parte superior de la aplicación cliente.
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 Contenedor de barra de herramientas principal de Contoso Tipo de componente de Unified Service Desk Contenedor de barra de herramientas Grupo de presentación ToolbarPanel Seleccione Guardar.
Paso 3: Agregue una barra de herramientas y adjúntela al contenedor de barra de herramientas
En este paso, creará una barra de herramientas y adjuntará barra de herramientas al control hospedado contenedor de barra de herramientas creado en el paso 2. Esto se realiza para mostrar la barra de herramientas en la aplicación del agente.
Inicie sesión en el Administrador de Unified Service Desk.
Seleccione Barras de herramientas en Configuración básica.
Seleccione + Nuevo.
En la página Nueva barra de herramientas, escriba Barra de herramientas principal de Contoso en el cuadro Nombre y seleccione Guardar.
Adjunte la barra de herramientas al control hospedado contenedor de barra de herramientas creado en el paso 2. Seleccione la pestaña Relacionado y luego Controles hospedados.
Seleccione Agregar control hospedado existente. Se muestra el panel Registros de búsqueda.
Escriba Contenedor de barra de herramientas principal de Contoso en el cuadro de búsqueda. Seleccione el registro de la lista y, a continuación, seleccione Agregar.
Seleccione Guardar.
Paso 4: Agregue botones de la barra de herramientas y llamadas a la acción para mostrar registros desde aplicaciones de la Interfaz unificada
En este paso, agregará botones en la barra de herramientas y adjuntará llamadas a la acción a los botones para que al seleccionar el botón, se muestren los registros correspondientes en los controles hospedados que creó en el paso 1. Configurará el botón búsqueda para que al seleccionar el botón se muestren los elementos de submenú de cuenta y contacto, y al seleccionar un botón se muestren los registros correspondientes.
Una vez que guarde la barra de herramientas en el paso 3, seleccione la pestaña General.
En el área Botones, seleccione + Nuevo botón de barra de herramientas.
En la página Nuevo botón de la barra de botones, especifique los siguientes valores:
Campo Valor Nombre Botón Buscar de Contoso Texto de botón BUSCAR Información sobre herramientas Buscar cuentas y contactos Pedido 1 Seleccione Guardar.
Seleccione la pestaña Relacionado y luego seleccione Botones de barra de herramientas.
Nota
Ahora está agregando botones de la barra de herramientas secundarios a un botón de la barra de herramientas existente para crear una estructura de submenú.
En la página siguiente, seleccione + Nuevo botón de barra de herramientas.
En la página Nuevo botón de la barra de botones, especifique los siguientes valores.
Campo Valor Nombre Botón Búsqueda de cuenta de Contoso Texto de botón Cuenta Pedido 1
El campo Orden define la posición de los botones en la barra de herramientas. Los botones están dispuestos de izquierda a derecha o de arriba a abajo en orden ascendente.Seleccione Guardar.
Ahora agregará dos llamadas a la acción: la primera para mostrar los registros de cuenta en el control hospedado creado en el paso 1 y la segunda en el control hospedado Administrador global de Contoso para mostrar el control hospedado de cuenta.
En el área Acciones, seleccione Agregar llamada a la acción existente. Se muestra el panel Registros de búsqueda.
Seleccione el icono de búsqueda y luego seleccione + Nueva llamada a la acción.
En la página Nueva llamada a la acción, especifique los siguientes valores:
Campo Valor Nombre Llamada a la acción de Contoso: Buscar cuenta Pedido 1 Control hospedado Búsqueda de cuenta de Contoso Para Find Datos account Seleccione Guardar. La nueva llamada a la acción se agrega al botón Botón Búsqueda de cuenta de Contoso.
Seleccione el botón atrás en el navegador para volver a la página Botón Búsqueda de cuenta de Contoso.
Agregará otra llamada a la acción al botón para establecer el enfoque en el control hospedado que muestra los registros de cuenta en la aplicación cliente.
Repita los pasos 9 a 11 y especifique los siguientes valores.
Campo Valor Nombre Llamada a la acción de Contoso: Mostrar búsqueda de cuenta Pedido 2 Control hospedado Administrador global de Contoso Para ShowTab Datos Búsqueda de cuenta de Contoso Seleccione Guardar.
Repita el paso 13 y luego seleccione Agregar llamada a la acción existente. Se muestra el panel Registros de búsqueda.
Escriba Llamada a la acción de Contoso en el cuadro de búsqueda. Seleccione la acción que creó en los pasos 11 y 14, y luego seleccione Agregar.
La nueva llamada a la acción se agrega al botón Botón Búsqueda de cuenta de Contoso.
Navegue hasta el botón de la barra de herramientas Botón Buscar de Contoso para agregar un botón secundario para buscar y mostrar contactos. Seleccione la pestaña Botones de barra de herramientas.
Seleccione Agregar nuevo botón de barra de herramientas.
En la página Nuevo botón de la barra de botones, especifique los siguientes valores:
Campo Valor Nombre Botón Búsqueda de contacto de Contoso Texto de botón Contacto Pedido 2
El campo Orden define la posición de los botones en la barra de herramientas. Los botones están dispuestos de izquierda a derecha o de arriba a abajo en orden ascendente.Seleccione Guardar.
Ahora agregará dos llamadas a la acción: la primera para mostrar los registros de contacto en el control hospedado creado en el paso 1 y la segunda en el control hospedado Administrador global de Contoso para mostrar el control hospedado de contactos.
En el área Acciones, seleccione Agregar llamada a la acción existente. Se muestra el panel Registros de búsqueda.
Seleccione el icono de búsqueda y luego seleccione + Nueva llamada a la acción.
En la página Nueva llamada a la acción, especifique los siguientes valores:
Campo Valor Nombre Llamada a la acción de Contoso: Buscar contacto Pedido 1 Control hospedado Búsqueda de contactos de Contoso Para Find Datos contacto Seleccione Guardar.
Seleccione el botón atrás en el navegador para volver al botón Botón Buscar de Contoso.
Agregará otra llamada a la acción al botón para establecer el enfoque en el control hospedado que muestra los registros de contacto en la aplicación cliente.
Repita los pasos 22 a 23 y especifique los siguientes valores.
Campo Valor Nombre Llamada a la acción de Contoso: Mostrar búsqueda de contacto Pedido 2 Control hospedado Administrador global de Contoso Para ShowTab Datos Búsqueda de contactos de Contoso Seleccione Guardar.
Seleccione el botón atrás en el navegador para volver al botón Botón Buscar de Contoso.
Seleccione Agregar llamada a la acción existente. Se muestra el panel Registros de búsqueda.
Se muestran las llamadas a la acción que creó. Seleccione las llamadas a la acción y luego seleccione Agregar.
La nueva llamada a la acción se agrega al botón de la barra de herramientas Botón Búsqueda de contacto de Contoso.
Seleccione Guardar.
Paso 5: Agregue los controles a la configuración
En este paso, agregará las llamadas a la acción, controles hospedados y la barra de herramientas que creó 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 |
|---|---|
| Llamada a la acción de Contoso: Buscar cuenta | Llamada a la acción |
| Llamada a la acción de Contoso: Mostrar búsqueda de cuenta | Llamada a la acción |
| Llamada a la acción de Contoso: Buscar contacto | Llamada a la acción |
| Llamada a la acción de Contoso: Mostrar búsqueda de contacto | Llamada a la acción |
| Búsqueda de cuenta de Contoso | Control hospedado |
| Búsqueda de contactos de Contoso | Control hospedado |
| Contenedor de barra de herramientas principal de Contoso | Control hospedado |
| Barra de herramientas principal de Contoso | Barra de herramientas |
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 Llamadas a la acción y luego seleccione Agregar llamada a la acción 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 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 del control hospedado mencionado en la tabla anterior en el cuadro de búsqueda. Los controles hospedados 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 Barras de herramientas, reglas de navegación de ventanas y búsquedas de entidades.
Seleccione los puntos suspensivos (...) en la sección Barras de herramientas y luego seleccione Agregar barra de herramientas existente. Se muestra el panel Registros de búsqueda.
Escriba Barra de herramientas principal de Contoso en el cuadro de búsqueda. Seleccione el registro de la lista y, a continuación, seleccione Agregar.
Seleccione Guardar.
Paso 6: 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 basada en modelo con el cliente de Unified Service Desk.
La aplicación del agente ahora tendrá un botón BUSCAR en el área de la barra de herramientas con dos botones secundarios (Cuenta y Contacto) que se muestran al seleccionar la flecha abajo.
Seleccione Cuenta o Contacto en el botón BUSCAR para mostrar los registros respectivos de su instancia en pestañas independientes en la aplicación cliente de Unified Service Desk.
Conclusión
En este tutorial, aprendió a mostrar registros de aplicaciones basadas en modelo en la aplicación cliente de Unified Service Desk. También aprendió a filtrar acceso a los controles de Unified Service Desk con la configuración.
Consulte también
Compatibilidad con aplicaciones de interfaz unificada en Unified Service Desk
Página de interfaz unificada (control hospedado)
Tutoriales de configuración de Unified Service Desk y la interfaz unificada
Tutorial 1: Cree una aplicación de agente simple para aplicaciones de la Interfaz unificada
Tutorial 2: Mostrar una página web externa en la aplicación del agente
Tutorial 6: Configurar el control hospedado Depurador en la aplicación del agente
Tutorial 7: configuración de scripts de agente en la aplicación del agente