Tutorial 3: Mostrar registros de Microsoft Dynamics 365 en la aplicación del agente

Publicado: noviembre de 2016

Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

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

• Debería conocer lo siguiente en Unified Service Desk:

  • Los dos tipos de controles hospedados siguientes: Página de Dynamics 365 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

  • Acceso a filtros mediante la configuración de Unified Service Desk.Más información:TechNet: 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 Dynamics 365 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 de Dynamics 365

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 Dynamics 365 para mostrar registros de cuentas y de contactos

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

1. Inicie sesión en Microsoft Dynamics 365.

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

3. Haga clic en Controles hospedados.

4. Haga clic en Nuevo.

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 Dynamics 365
   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 Dynamics 365
   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

El tipo de controles hospedados Contenedor de barra de herramientas se usa 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 Microsoft Dynamics 365.

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

3. Haga clic en Controles hospedados.

4. Haga clic en Nuevo.

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 Microsoft Dynamics 365.

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

3. Haga clic en Barras de herramientas.

4. Haga clic en Nuevo.

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 de Dynamics 365

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 de Dynamics 365 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 de Dynamics 365.

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ó de la barra de botones, especifique los siguientes valores:

   Campo	Valor
   Nombre	Botón Buscar de Contoso
   Texto de botón	BÚSQUEDA
   Información sobre herramientas	Busque cuentas y contactos de Dynamics 365
   Pedido	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ó 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 Nota 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.

   .jpeg "Cree un botón de la barra de herramientas para el submenú Cuenta")

   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	Buscar
       Datos	account

       

   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ó 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 Nota 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.

       .jpeg "Crear un botón de la barra de herramientas para la búsqueda de contactos")

       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	Buscar
           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.Configuración de Contoso se creó 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 Microsoft 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: Cree una aplicación simple del agente. Para obtener información sobre la conexión con una instancia de Dynamics 365 utilizando la aplicación cliente de Unified Service Desk, vea TechNet: Conectarse a la instancia CRM 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 Dynamics 365 en pestañas independientes en la aplicación cliente de Unified Service Desk.

       

       Conclusión

       En este tutorial, aprendió a mostrar registros de Dynamics 365 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.

       Ver 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: Muestre un registro de Microsoft Dynamics 365 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: Configure scripts de agente en la aplicación del agente
       Tutoriales de configuración de Servicios unificados

       Unified Service Desk 2.0

       © 2017 Microsoft. Todos los derechos reservados. Copyright