Configuración de Microsoft Dynamics OData

integración de datos

Microsoft Dynamics es un software de administración de la relación con los clientes (CRM) y planificación de recursos empresariales (ERP) que proporciona soluciones empresariales para crear y administrar cuentas de clientes, contactos, posibles clientes, oportunidades y casos. La integración de datos de Experience Manager Forms proporciona una configuración de servicio en la nube de OData para integrar Forms con servidores de Microsoft Dynamics en línea y locales. Esto permite crear el modelo de datos de formulario en función de las entidades, atributos y servicios definidos en el servicio de Microsoft Dynamics. El modelo de datos de formulario se puede utilizar para crear formularios adaptables que interactúen con el servidor Microsoft Dynamics para habilitar los flujos de trabajo empresariales. Por ejemplo:

  • consultar datos en el servidor de Microsoft Dynamics y rellenar automáticamente formularios adaptables;
  • escribir datos en Microsoft Dynamics sobre el envío de formularios adaptables;
  • escribir datos en Microsoft Dynamics mediante entidades personalizadas definidas en el modelo de datos de formulario y viceversa.
MS Dynamics OData Cloud Service (OData Service) is available with all run modes. For more information on configuring run modes for an Experience Manager instance, see [Run Modes](/docs/experience-manager-cloud-service/implementing/deploying/overview.html?lang=es#runmodes).

Requisitos previos

Antes de comenzar a configurar Microsoft Dynamics, asegúrese de lo siguiente:

Establecer la URL de respuesta para la aplicación de Microsoft Dynamics registrada

Haga lo siguiente para establecer la URL de respuesta para la aplicación de Microsoft Dynamics registrada:

NOTA

Utilice este procedimiento solo mientras integra Experience Manager Forms con el servidor en línea de Microsoft Dynamics.

  1. Vaya a su cuenta de Microsoft Azure Active Directory y agregue la siguiente URL de configuración del servicio en la nube en la opción URL de respuesta de la aplicación registrada:

    https://[server]:[port]/libs/fd/fdm/gui/components/admin/fdmcloudservice/createcloudconfigwizard/cloudservices.html

    Azure Directory

  2. Guarde la configuración.

Configurar Microsoft Dynamics para IFD

Microsoft Dynamics utiliza la autenticación basada en notificaciones para proporcionar acceso a los datos del servidor de Microsoft Dynamics CRM a los usuarios externos. Para habilitar esta función, haga lo siguiente para configurar Microsoft Dynamics para la implementación con conexión a Internet (IFD) y configurar opciones de notificación.

NOTA

Utilice este procedimiento solo mientras integra Experience Manager Forms con el servidor local de Microsoft Dynamics.

  1. Configure la instancia local de Microsoft Dynamics para IFD, tal como se describe en Configuración de IFD para Microsoft Dynamics.

  2. Ejecute los siguientes comandos utilizando Windows PowerShell para configurar las opciones de notificación en Microsoft Dynamics para IFD:

    Add-PSSnapin Microsoft.Crm.PowerShell
     $ClaimsSettings = Get-CrmSetting -SettingType OAuthClaimsSettings
     $ClaimsSettings.Enabled = $true
     Set-CrmSetting -Setting $ClaimsSettings
    

    Consulte Registro de aplicaciones para CRM local (IFD) para obtener más información.

Configurar el cliente OAuth en el equipo AD FS

Haga lo siguiente para registrar un cliente de OAuth en el equipo de los Servicios de federación de Active Directory (AD FS) y conceder acceso desde él:

NOTA

Utilice este procedimiento solo mientras integra Experience Manager Forms con el servidor local de Microsoft Dynamics.

  1. Ejecute el siguiente comando:

    Add-AdfsClient -ClientId “<Client-ID>” -Name "<name>" -RedirectUri "<redirect-uri>" -GenerateClientSecret

    donde:

    • Client-ID es un ID de cliente que puede generar con cualquier generador GUID.
    • redirect-uri es la dirección URL del servicio en la nube de OData de Microsoft Dynamics en Experience Manager Forms. El servicio en la nube predeterminado instalado con Experience Manager Forms se implementa en la siguiente URL:
      https://'[server]:[port]'/libs/fd/fdm/gui/components/admin/fdmcloudservice/createcloudconfigwizard/cloudservices.html
  2. Ejecute el siguiente comando para conceder acceso desde el equipo AD FS:

    Grant-AdfsApplicationPermission -ClientRoleIdentifier “<Client-ID>” -ServerRoleIdentifier <resource> -ScopeNames openid

    donde:

    • resource es la URL de la organización de Microsoft Dynamics.
  3. Microsoft Dynamics utiliza el protocolo HTTPS. Para invocar extremos de AD FS desde el servidor de Forms, instale el certificado del sitio de Microsoft Dynamics en el almacén de certificados de Java mediante el comando keytool en el equipo en el que se ejecuta Experience Manager Forms.

Configurar el servicio en la nube para el servicio de Microsoft Dynamics

Un servicio OData se identifica mediante su URL raíz de servicio. Para configurar un servicio OData en Experience Manager as a Cloud Service, asegúrese de que tiene una URL raíz de servicio para el servicio y haga lo siguiente:

NOTA

Para obtener una guía paso a paso sobre la configuración de Microsoft Dynamics 365, en línea o de forma local, consulte Microsoft Dynamics Configuración de OData.

  1. Vaya a Herramientas > Cloud Services > Fuentes de datos. Pulse para seleccionar la carpeta en la que desea crear una configuración de nube.

    Consulte Configurar carpetas para configuraciones de servicios en la nube para obtener información sobre la creación y configuración de una carpeta para configuraciones de servicios en la nube.

  2. Pulse Crear para abrir el Asistente de configuración para crear fuentes de datos. Especifique un nombre y, opcionalmente, un título para la configuración, seleccione Servicio OData en la lista desplegable Tipo de servicio. También puede examinar y seleccionar una imagen en miniatura para la configuración y pulsar Siguiente. En la pestaña Configuración de autenticación:

    1. Introduzca el valor del campo Raíz del servicio. Vaya a la instancia de Dynamics y luego a Recursos para desarrolladores para ver el valor del campo Raíz del servicio. por ejemplo, https://<tenant-name>/api/data/v9.1/

    2. Seleccione OAuth 2.0 como el tipo de autenticación.

    3. Reemplace los valores predeterminados en los campos ID de cliente (también denominado ID de aplicación), Secreto de cliente, URL de OAuth, Actualizar URL del token, URL del token de acceso y Recurso con los valores de su configuración del servicio de Microsoft Dynamics. Es obligatorio especificar la URL de la instancia de Dynamics en el campo Recurso para configurar Microsoft Dynamics con un modelo de datos de formulario. Utilice la URL raíz del servicio para derivar la URL de la instancia de Dynamics. Por ejemplo, https://org.crm.dynamics.com.

    4. Especifique openid en el campo Ámbito de autorización para el proceso de autorización de Microsoft Dynamics.

      Configuración de autenticación
      Modelo de datos de formulario

  3. Haga clic en Conectarse a OAuth. Se le redirigirá a la página de inicio de sesión de Microsoft Dynamics.

  4. Inicie sesión con sus credenciales de Microsoft Dynamics y haga clic en Aceptar para permitir que la configuración del servicio en la nube se conecte al servicio de Microsoft Dynamics. Solo es necesario establecer el modelo de datos de formulario entre el servicio y el servicio una vez.

    Este es el modelo de datos de formulario de la página de configuración del servicio en la nube, la cual muestra un mensaje que indica que la configuración de OData se ha guardado correctamente.

El servicio en la nube MS Dynamics OData Cloud Service (servicio OData) está configurado y conectado con el servicio de Dynamics. Modelo de datos de formulario - Modelo de datos de formulario

Crear modelo de datos de formulario

Después de configurar el modelo de datos del servicio en la nube de OData de MS Dynamics, puede utilizar el servicio al crear modelos de datos de formulario. Para obtener más información, consulte Creación del modelo de datos de formulario.

A continuación, puede crear un formulario adaptable basado en el modelo de datos de formulario y utilizarlo en varios casos de uso de formularios adaptables, como los siguientes:

  • prerrellenar formularios adaptables consultando la información de las entidades y servicios de Microsoft Dynamics;
  • invocar operaciones del servidor de Microsoft Dynamics definidas en un modelo de datos de formulario que utiliza reglas de formularios adaptables;
  • escribir datos de formularios enviados en entidades de Microsoft Dynamics.

Para obtener más información sobre la creación y el uso de modelos de datos de formulario en flujos de trabajo empresariales, consulte Integración de datos.

En esta página