Tutorial 3: Mostrar registros en la aplicación del agente

Este tutorial demuestra cómo mostrar registros en la aplicación del agente. En este tutorial, usted mostrará todos los registros de cuentas y contactos en la la aplicación basada 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: Cree una aplicación simple del agente. 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 sencilla de agentes

• Debe conocer lo siguiente en Unified Service Desk:

  • Los dos tipos de controles hospedados siguientes: Página de CRM 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 1: Cree el tipo de controles hospedados Página de CRM para mostrar registros de cuentas y de contactos

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 6: Pruebe la aplicación

Conclusión

Paso 1: Cree el tipo de controles hospedados Página de CRM para mostrar registros de cuentas y de contactos

En este paso, creará dos controles hospedados del tipo Página de CRM para mostrar los registros de cuentas y contactos respectivamente.

1. Inicie sesión en la instancia de Dynamics 365.

2. Vaya a Configuración>Unified Service Desk.

3. Haga clic en Controles hospedados.

4. Haga clic en Nueva.

5. 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 USD	Página de CRM
   Permitir varias páginas	No
   Tipo de hospedaje	WPF interno
   La aplicación es global	Activado
   Grupo de presentación	MainPanel

   

6. Haga clic en Guardar.

7. Haga clic en Nuevo para crear otro control hospedado para mostrar registros de contactos.

8. 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 USD	Página de CRM
   Permitir varias páginas	No
   Tipo de hospedaje	WPF interno
   La aplicación es global	Activado
   Grupo de presentación	MainPanel

   

9. Haga clic en 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.

1. Inicie sesión en la instancia de Dynamics 365.

2. Vaya a Configuración>Unified Service Desk.

3. Haga clic en Controles hospedados.

4. Haga clic en Nueva.

5. 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 USD	Contenedor de barra de herramientas
   Grupo de presentación	ToolbarPanel

   

6. Haga clic en 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.

1. Inicie sesión en la instancia de Dynamics 365.

2. Vaya a Configuración>Unified Service Desk.

3. Haga clic en Barras de herramientas.

4. Haga clic en Nueva.

5. En la página Nueva barra de herramientas, escriba Barra de herramientas principal de Contoso en el cuadro Nombre y haga clic en Guardar.

6. Adjunte la barra de herramientas al control hospedado contenedor de barra de herramientas creado en el paso 2. En la barra de navegación, haga clic en la flecha abajo junto a Barra de herramientas principal de Contoso y haga clic en Controles hospedados.

7. En la página siguiente, haga clic en Agregar control hospedado existente, escriba Contoso Main Toolbar Container en la barra de búsqueda y, a continuación, presione ENTRAR o haga clic en el icono de búsqueda.

8. En los resultados de la búsqueda, haga clic en Contenedor de barra de herramientas principal de Contoso para agregar.

9. Haga clic en Guardar.

Paso 4: Agregue botones de la barra de herramientas y llamadas a la acción para mostrar registros

En este paso, agregará botones en la barra de herramientas y adjuntará llamadas a la acción a los botones para que al hacer clic en 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 hacer clic en el botón se muestren los elementos de submenú de cuenta y contacto, y al hacer clic en un botón se muestren los registros correspondientes.

1. Después de guardar la barra de herramientas en el paso 3, el área Botones pasará a estar disponible. En el área Botones, haga clic en + en la esquina derecha para agregar un botón.

2. 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
   Orden	1

   

3. Haga clic en Guardar.

4. En la barra de navegación, haga clic en la flecha abajo junto a Botón Buscar de Contoso y haga clic en 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ú.

5. En la página siguiente, haga clic en Agregar nuevo botón de barra de herramientas.

6. 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.

   

7. Haga clic en Guardar.

8. 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, haga clic en + en la esquina derecha para agregar una llamada a la acción.

9. En el cuadro de búsqueda en el área Acciones, presione ENTRAR o haga clic en el icono de búsqueda.

10. En el cuadro de resultados de búsqueda, haga clic en Nueva en la esquina inferior derecha para crear una llamada a la acción para este botón de la barra de herramientas.

    

11. 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
    Acción	Find
    Datos	cuenta

    

12. Haga clic en Guardar. La nueva llamada a la acción se agrega al botón Botón Búsqueda de cuenta de Contoso.

13. 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. En el área Acciones, haga clic en + en la esquina derecha para agregar una llamada a la acción.

14. En el cuadro de resultados de búsqueda, haga clic en Nueva en la esquina inferior derecha para crear una llamada a la acción para este botón de la barra de herramientas.

15. En la página Nueva llamada a la acción, 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
    Acción	ShowTab
    Datos	Búsqueda de cuenta de Contoso

    

16. Haga clic en Guardar. La nueva llamada a la acción se agrega al botón Botón Búsqueda de cuenta de Contoso.

17. 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. En la barra de navegación, haga clic en la flecha abajo junto a Botón Buscar de Contoso y seleccione Botones de barra de herramientas.

18. En la página siguiente, haga clic en Agregar nuevo botón de barra de herramientas.

19. 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.

    

20. Haga clic en Guardar.

21. 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, haga clic en + en la esquina derecha para agregar una llamada a la acción.

22. En el cuadro de búsqueda en el área Acciones, presione ENTRAR o haga clic en el icono de búsqueda.

23. En el cuadro de resultados de búsqueda, haga clic en Nueva en la esquina inferior derecha para crear una llamada a la acción para este botón de la barra de herramientas.

24. 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
    Acción	Find
    Datos	contacto

    

25. Haga clic en Guardar. 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.

26. 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. En el área Acciones, haga clic en + en la esquina derecha para agregar una llamada a la acción.

27. En el cuadro de resultados de búsqueda, haga clic en Nueva en la esquina inferior derecha para crear una llamada a la acción para este botón de la barra de herramientas.

28. En la página Nueva llamada a la acción, 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
    Acción	ShowTab
    Datos	Búsqueda de contactos de Contoso

    

29. Haga clic en Guardar. 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.

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.

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:

1. Inicie sesión en la instancia de Dynamics 365.

2. Vaya a Configuración>Unified Service Desk.

3. Haga clic en Configuración.

4. Haga clic en Configuración de Contoso para abrir la definición.

5. En la barra de navegación, haga clic en la flecha abajo junto a Configuración de Contoso y seleccione Llamadas a la acción.

6. En la página siguiente, haga clic en Agregar llamada a la acción existente, escriba "Contoso Action Call" en la barra de búsqueda y, a continuación, presione ENTRAR o haga clic en el icono de búsqueda.

7. Las llamadas a la acción indicadas anteriormente se muestran en los resultados de la búsqueda. Agregue estas llamadas a la acción.

8. De forma similar, agregue los controles hospedados y la barra de herramientas haciendo clic en la flecha abajo junto a Configuración de Contoso y haciendo clic en EventosBarras de herramientas respectivamente.

9. Haga clic en 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 de aplicación 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 hacer clic en la flecha abajo.

Haga clic en Cuenta o Contacto en el botón BUSCAR para mostrar los registros respectivos de la instancia de Dataverse 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

Tutorial 1: Cree una aplicación simple del agente
Tutorial 2: Mostrar una página web externa en la aplicación del agente
Tutorial 4: Mostrar un registro en una sesión en la aplicación del agente
Tutorial 5: Mostrar información de sesión mejorada mostrando nombre de sesión y datos de información general
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
Tutoriales de configuración de Unified Service Desk