Aproveche, integre y trabaje con los servicios en línea y locales de Microsoft Dynamics a través del modelo de datos de formulario.
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, contactos, posibles clientes, oportunidades y casos de clientes. Integración de datos de AEM Forms proporciona una configuración de servicio en la nube OData para integrar Forms con los servidores de Microsoft Dynamics tanto en línea como locales. Permite crear un modelo de datos de formulario basado en las entidades, atributos y servicios definidos en el servicio Microsoft Dynamics. El modelo de datos de formulario se puede utilizar para crear formularios adaptables que interactúen con el servidor de Microsoft Dynamics para habilitar flujos de trabajo empresariales. Por ejemplo:
El paquete de complementos de AEM Forms también incluye la configuración de OData de referencia que puede aprovechar para integrar rápidamente Microsoft Dynamics con AEM Forms.
Cuando se instala el paquete, las siguientes entidades y servicios están disponibles en la instancia de AEM Forms:
El Cloud Service OData y el modelo de datos de formulario con entidades y servicios preconfigurados de Microsoft Dynamics solo están disponibles en la instancia de AEM Forms si el modo de ejecución de la instancia de AEM está definido como samplecontent
(predeterminado). Para obtener más información sobre la configuración de los modos de ejecución de una instancia de AEM, consulte Modos de ejecución.
Antes de empezar a configurar Microsoft Dynamics, asegúrese de que:
Instalado el AEM paquete de complementos de Forms 6.4
Se ha configurado Microsoft Dynamics 365 en línea o se ha instalado una instancia de una de las siguientes versiones de Microsoft Dynamics:
Se registró la aplicación para el servicio en línea de Microsoft Dynamics con Microsoft Azure Active Directory. Tome nota de los valores del ID de cliente (también denominado ID de aplicación) y del secreto de cliente del servicio registrado. Estos valores se utilizan al configuración del servicio en la nube para el servicio Microsoft Dynamics.
Haga lo siguiente para establecer la URL de respuesta para la aplicación Microsoft Dynamics registrada:
Utilice este procedimiento solo al integrar AEM Forms con el servidor en línea de Microsoft Dynamics.
Vaya a la cuenta de Microsoft Azure Active Directory y agregue la siguiente URL de configuración del servicio de nube en URL de respuesta configuración de la aplicación registrada:
https://[server]:[port]/libs/fd/fdm/gui/components/admin/fdmcloudservice/createcloudconfigwizard/cloudservices.html
Guarde la configuración.
Microsoft Dynamics utiliza la autenticación basada en reclamaciones para proporcionar acceso a los datos del servidor Microsoft Dynamics CRM para usuarios externos. Para habilitarlo, haga lo siguiente para configurar Microsoft Dynamics para la implementación de cara a Internet (IFD) y para configurar las solicitudes.
Utilice este procedimiento solo al integrar AEM Forms con el servidor local de Microsoft Dynamics.
Configure la instancia local de Microsoft Dynamics para IFD como se describe en Configuración de IFD para Microsoft Dynamics.
Ejecute los siguientes comandos utilizando Windows PowerShell para configurar los parámetros de reclamación en Microsoft Dynamics habilitada 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.
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:
Utilice este procedimiento solo al integrar AEM Forms con el servidor local de Microsoft Dynamics.
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 Microsoft Dynamics OData en AEM Forms. El servicio de nube predeterminado instalado con el paquete AEM Forms se implementa en la siguiente URL:
http://[server]:[port]/libs/fd/fdm/gui/components/admin/fdmcloudservice/createcloudconfigwizard/cloudservices.html
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 dirección URL de la organización de Microsoft Dynamics.Microsoft Dynamics utiliza el protocolo HTTPS. Para invocar extremos de AD FS desde el servidor de Forms, instale el certificado de sitio de Microsoft Dynamics en el almacén de certificados de Java mediante el keytool
en el equipo que ejecuta AEM Forms.
La variable Cloud Service de MS Dynamics OData (servicio OData) viene con la configuración predeterminada de OData. Para configurarlo para que se conecte con el servicio de Microsoft Dynamics, haga lo siguiente.
Vaya a Herramientas > Cloud Services > Fuentes de datos y pulse el botón global
carpeta de configuración.
Select Cloud Service de MS Dynamics OData (servicio OData) configuración y toque Propiedades. Se abre el cuadro de diálogo de la propiedad de configuración del servicio de nube.
En la pestaña Configuración de autenticación:
Haga clic en Conectarse a OAuth. Se le redirige a la página de inicio de sesión de Microsoft Dynamics.
Inicie sesión con sus credenciales de Microsoft Dynamics y acepte para permitir que la configuración del servicio de nube se conecte al servicio Microsoft Dynamics. Es una tarea única establecer una conexión entre el servicio en la nube y el servicio.
A continuación, se le redirige a la página de configuración del servicio en la nube, que 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.
Al instalar el paquete de AEM Forms, un modelo de datos de formulario,Microsoft Dynamics FDM, se implementa en la instancia de AEM. De forma predeterminada, el modelo de datos de formulario utiliza el servicio Microsoft Dynamics configurado en el Cloud Service MS Dynamics OData (servicio OData) como su origen de datos.
Al abrir el modelo de datos de formulario por primera vez, se conecta al servicio configurado de Microsoft Dynamics y recupera entidades de la instancia de Microsoft Dynamics. Las entidades "contacto" y "posible cliente" de Microsoft Dynamics ya se han agregado en el modelo de datos de formulario.
Para revisar el modelo de datos de formulario, vaya a Forms > Integraciones de datos. Select Microsoft Dynamics FDM y haga clic en Editar para abrir el modelo de datos de formulario en modo de edición. También puede abrir el modelo de datos de formulario directamente desde la siguiente URL:
https://[*server*]:[*port*]/aem/fdm/editor.html/content/dam/formsanddocuments-fdm/ms-dynamics-fdm
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:
Se recomienda crear una copia del modelo de datos de formulario que se proporciona con el paquete AEM Forms y configurar los modelos y servicios de datos para adaptarlos a sus necesidades. Garantizará que las futuras actualizaciones del paquete no anulen el modelo de datos del formulario.
Para obtener más información sobre la creación y el uso del modelo de datos de formulario en flujos de trabajo empresariales, consulte Integración de datos.