Tutorial: registrar un complemento basado en Azure con la herramienta de registro de complementos de CRM
Publicado: noviembre de 2016
Se aplica a: Dynamics CRM 2015
Este tutorial muestra cómo configurar Servicio de control de acceso (ACS) de Microsoft Azure Active Directory y registrar un paso del extremo de servicio con la herramienta de registro de complementos. Una vez que esté configurado Microsoft Dynamics CRM 2015 y Microsoft Dynamics CRM Online pueden publicar el contexto de ejecución de la operación actual un extremo de soluciones de Microsoft Azure. Para este tutorial, el paso se registra para publicar el contexto de ejecución del mensaje CreateRequest para una entidad Account en el Bus de servicio de Microsoft Azure.
Los siguientes requisitos previos se deben rellenar antes de iniciar este tutorial:
Acceso a la herramienta Plug-in Registration. Puede encontrar el archivo ejecutable de la herramienta en la carpeta Tools\PluginRegistration del SDK.Descargue el paquete de SDK de Microsoft Dynamics CRM.
Obtener una cuenta en Microsoft Dynamics CRM 2015 o Microsoft Dynamics CRM Online.
La cuenta de usuario del sistema debe tener el rol de administrador del sistema o personalizador del sistema. Para obtener más información, vea Cómo se puede usar la seguridad basada en roles para controlar el acceso a las entidades de Microsoft Dynamics CRM 2015.
Tener acceso a un espacio de nombres de servicio de plataforma de Microsoft Azure que use ACS versión 2, en la que Microsoft Dynamics 365 publicará un mensaje.Para obtener más información, vea: la creación de un espacio de nombres de ACS, vea Cree un nuevo espacio de nombres de servicio.
Si usa Microsoft Dynamics CRM 2015, el servidor debe configurarse para la integración de Microsoft Azure según las instrucciones del tema Configurar la integración de Azure con Microsoft Dynamics CRM 2015.
Debe haber una aplicación de escucha que escuche activamente el extremo de soluciones para que Microsoft Dynamics 365 publique correctamente en el Bus de servicio de Microsoft Azure. Para obtener más información, vea Escribir un agente de escucha para una solución de Microsoft Azure.
Pasos
Este tutorial contiene los pasos siguientes:
Conectar al servidor de Microsoft Dynamics CRM
Crear un configuración de extremo de servicio
Configurar ACS
Registrar un paso del extremo de servicio para un evento
Probar el registro del extremo
Conectar al servidor de Microsoft Dynamics CRM
Siga los pasos indicados abajo para conectarse con el servidor de Microsoft Dynamics 365 mediante la herramienta de registro de complementos.
Ejecute la herramienta Plug-in Registration.
Elija Crear nueva conexión.
En el diálogo Iniciar sesión, seleccione el botón de opción de tipo de implementación correspondiente al servidor de Microsoft Dynamics 365 en el que quiera registrar un extremo de servicio. El botón de opción Local incluye una implementación de IFD, el botón Online es para el proveedor Windows Live de Microsoft Dynamics CRM Online y el botón Office 365 es para el proveedor de Microsoft Online Services de Microsoft Dynamics CRM Online.
Formulario de inicio de sesión para una implementación en línea
Formulario de inicio de sesión para una implementación local
Si selecciona Mostrar siempre la lista de organizaciones disponibles, se le presentará una lista de las organizaciones a las que pertenece tras elegir Iniciar sesión. Esto le permite elegir la organización en la que desea registrar el extremo de servicio. De lo contrario, se usa la organización predeterminada.
Especifique la información indicada acerca de la cuenta de servidor y de inicio de sesión y, a continuación, elija Iniciar sesión.
Crear un configuración de extremo de servicio
Siga los pasos indicados abajo para registrar un extremo de servicio de Microsoft Azure.
Seleccione la pestaña de la organización en la que desea registrar un extremo de servicio.
En la barra de herramientas de la pestaña, elija Registrar y luego en Registrar nuevo extremo de servicio.
Rellene el cuadro de diálogo Registro de extremo de servicio con la información relacionada con la solución, tal como se muestra en la siguiente ilustración y se describe posteriormente en la tabla. Asegúrese de que el contrato que especifique sea el mismo contrato usado por la aplicación de escucha de la solución.
Elemento de la interfaz de usuario
description
Nombre (campo)
Un nombre para el registro del extremo de servicio.
Descripción (campo)
Descripción del registro de este extremo.
Espacio de nombres de solución (campo)
El nombre del espacio de nombres del servicio de la solución.
Ruta (campo)
La ruta del proyecto. Por ejemplo, dado una URL del extremo de servicio de https://crmsdkdemo-sb.accesscontrol.windows.net/TwoWayService/Demo, la ruta es TwoWayService/Demo.
Contrato (menú desplegable)
El contrato de extremo. Una aplicación de escucha debe usar este contrato para leer el mensaje publicado. Para obtener más información, vea Escribir un agente de escucha para una solución de Microsoft Azure.
Notificación (menú desplegable)
Las notificaciones para enviar a Microsoft Azure. Use Ninguna para la notificación estándar. Especifique UserId o UserInfo para enviar información adicional sobre el usuario que ha iniciado sesión.
Modo federado (casilla)
Seleccione este cuadro para usar el modo federado.
ID (campo)
Campo de solo lectura que se rellena automáticamente con el identificador de la configuración del extremo.
Guardar y configurar ACS (botón)
Permite guardar la configuración que ha especificado y automatizar el proceso de configuración de ACS. Proporciona una forma interactiva de lograr lo que se describe en el tema Tutorial: Configurar Microsoft Azure ACS para integración con Microsoft Dynamics CRM 2015.
Guardar y comprobar autenticación (botón)
Permite guardar la configuración que ha especificado y verificar que ACS está configurado correctamente.
Guardar (botón)
Permite guardar la configuración que ha especificado y cerrar el diálogo.
Si aún no ha configurado la integración de ACS con Microsoft Dynamics 365, y le gustaría que la herramienta de registro de complementos hiciera la configuración por usted, elija Guardar y configurar ACS y, a continuación siga las instrucciones de la siguiente sección de este tutorial. Si ha configurado ya ACS, elija Guardar y comprobar autenticación o Guardar y continúe con las instrucciones de Registrar un paso del extremo de servicio para un evento.
Configurar ACS
Siga estos pasos para configurar Servicio de control de acceso (ACS) de Microsoft Azure Active Directory.
Después de elegir Guardar y configurar ACS, aparece el cuadro de diálogo Configuración de ACS. Especifique los valores de datos adecuados en los campos del formulario, tal como se describe en la tabla siguiente.
Nombre de campo
Descripción
Clave de administración
Clave de administración de la solución. Puede obtener el valor de esta clave del Portal de administración de Azure.
Obtener una clave de administración de un espacio de nombres de bus de servicio
En el panel izquierdo, elija Bus de servicio y, a continuación, seleccione el espacio de nombres de destino en la lista.
En la parte inferior de la página, elija Información de conexión.
En el cuadro de diálogo Información de conexión de acceso, se muestra Clave predeterminada. Esta es la clave de administración.
Nota
Si ha modificado la clave simétrica, especifique esa clave en lugar de la clave predeterminada en el campo Clave de administración. Si no lo hace, puede recibir errores con una descripción como esta: "ACS50012: Error de autenticación".
Archivo de certificado
Archivo de certificado público utilizado en la configuración de Microsoft Dynamics 365 para la integración con Microsoft Azure.
Para Microsoft Dynamics CRM 2015 y actualización de Microsoft Dynamics CRM Online 2015, puede descargar este archivo de certificado del servidor. En la aplicación web de Microsoft Dynamics 365, elijaConfiguración > Personalizaciones y luego elija Recursos de desarrollador. Descargue y guarde el archivo de certificado usando el vínculo proporcionado debajo de Bus de servicio de Microsoft Azure Certificado de emisor.
Nombre del emisor
Nombre del emisor. Este nombre debe coincidir con el utilizado en la configuración de Microsoft Dynamics 365 para la integración de Microsoft Azure. El nombre del emisor se puede obtener de la página web Recursos de desarrollador mencionada en la descripción anterior.
Para obtener más información, vea Configurar la integración de Azure con Microsoft Dynamics CRM 2015.
Elija Configurar ACS. Se muestra un registro del proceso de configuración en el área de salida del formulario.
Elija Cerrar.
Elija Guardar y comprobar autenticación en el cuadro de diálogo Registro de extremo de servicio. Cuando finalice la verificación, podrá cerrar los cuadros de diálogo.
Registrar un paso del extremo de servicio para un evento
Siga los pasos indicados abajo para registrar un paso para un evento en el extremo de servicio.
Seleccione el extremo de servicio que ha registrado previamente en la vista de árbol de la herramienta.
Vaya al menú Registrar de y elija Registrar nuevo paso.
Complete el cuadro de diálogo Registrar nuevo paso para un evento de crear cuenta como se muestra en la siguiente ilustración.
Elija Registrar nuevo paso.
Microsoft Dynamics 365 publicará ahora el mensaje actual que contiene el contexto de ejecución para el bus de servicio cuando se crea una cuenta. La publicación se realiza asincrónicamente y no se ejecuta inmediatamente.
Probar el registro del extremo
Una vez registrado el extremo podrá probarlo. Debe haber un módulo de escucha ejecutándose o una cola disponible en el extremo de destino para que se produzca la publicación del bus de servicio desde el complemento.
Abra la aplicación web Microsoft Dynamics 365 de la misma organización donde se ha registrado el extremo del servicio.
Elija el botón Crear y a continuación, elija Cuenta.
Escriba un nombre de cuenta, por ejemplo Adventure Works Cycle, en el campo Nombre de cuenta y, a continuación, elija Guardar.
Espere unos 10 minutos hasta que se realice la publicación del Bus de servicio de Microsoft Azure.
Elija Configuración > Trabajos del sistema.
Abra el trabajo del sistema con el mismo nombre que el extremo del servicio. Compruebe el estado para ver si la publicación se realiza correctamente, está en espera o ha generado un error.
Ahora puede anular el registro del extremo, si así lo desea, seleccionándolo en la vista de árbol de la herramienta y eligiendo Anular registro.
Ver también
Extensiones de Azure para Microsoft Dynamics CRM 2015
Integración de Azure con Microsoft Dynamics CRM
Active Directory y autenticación basada en notificaciones
© 2017 Microsoft. Todos los derechos reservados. Copyright