Compartir a través de


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:

Pasos

Este tutorial contiene los pasos siguientes:

  1. Conectar al servidor de Microsoft Dynamics CRM

  2. Crear un configuración de extremo de servicio

  3. Configurar ACS

  4. Registrar un paso del extremo de servicio para un evento

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

  1. Ejecute la herramienta Plug-in Registration.

  2. Elija Crear nueva conexión.

  3. 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 en línea

    Ventana de inicio de sesión para una implementación local

    Formulario de inicio de sesión para una implementación local

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

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

  1. Seleccione la pestaña de la organización en la que desea registrar un extremo de servicio.

  2. En la barra de herramientas de la pestaña, elija Registrar y luego en Registrar nuevo extremo de servicio.

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

    Crear un extremo de servicio

    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.

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

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

    1. Inicie sesión en el portal Azure.

    2. En el panel izquierdo, elija Bus de servicio y, a continuación, seleccione el espacio de nombres de destino en la lista.

    3. En la parte inferior de la página, elija Información de conexión.

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

  2. Elija Configurar ACS. Se muestra un registro del proceso de configuración en el área de salida del formulario.

  3. Elija Cerrar.

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

  1. Seleccione el extremo de servicio que ha registrado previamente en la vista de árbol de la herramienta.

  2. Vaya al menú Registrar de y elija Registrar nuevo paso.

  3. Complete el cuadro de diálogo Registrar nuevo paso para un evento de crear cuenta como se muestra en la siguiente ilustración.

    Crear paso de extremo de servicio

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

  1. Abra la aplicación web Microsoft Dynamics 365 de la misma organización donde se ha registrado el extremo del servicio.

  2. Elija el botón CrearBotón Crear y a continuación, elija Cuenta.

  3. Escriba un nombre de cuenta, por ejemplo Adventure Works Cycle, en el campo Nombre de cuenta y, a continuación, elija Guardar.

  4. Espere unos 10 minutos hasta que se realice la publicación del Bus de servicio de Microsoft Azure.

  5. Elija Configuración > Trabajos del sistema.

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