Saltar al contenido

Guía de conexión de Microsoft Dynamics 365 para Jitterbit App Builder

Descripción general

Esta guía describe los requisitos del sistema e instrucciones para conectar App Builder a un servidor de base de datos de Microsoft Dynamics 365 Business Central. Microsoft Business Central es un sistema contable que configuraremos con OAuth 2.0 para autenticar desde App Builder. Microsoft Azure se utilizará para configurar el flujo de autenticación OAuth.

Esta guía asume que tiene un sistema contable existente de Microsoft Dynamics 365 Business Central al que desea conectar App Builder.

Para los pasos de configuración que se realizan en Microsoft Azure y Dynamics 365 Business Central, esta guía proporcionará información a alto nivel.

Requisitos del sistema

Servidor de base de datos

  • Dynamics 365 Business Central

  • Microsoft Entra ID

Navegador web del cliente

  • Chrome: 84+

  • Firefox: 73+

  • Safari: 13.0.1+

  • Edge: 84+

Instrucciones de conexión

Registrar una aplicación en Microsoft Azure

El método utilizado para autenticar desde App Builder a Microsoft Business Central y Dynamics 365 es OAuth 2.0. Configuraremos el flujo OAuth utilizando Microsoft Azure.

  1. Navegue al portal del Centro de administración de Azure Active Directory

  2. En Administrar, seleccione Registros de aplicaciones > Nuevo registro

  3. Proporcione un Nombre. Este valor puede ser mostrado en ocasiones por los usuarios de la aplicación. Por ejemplo: App Builder Business Central

  4. Seleccione quién puede usar la aplicación

  5. Haga clic en Registrar

Cuando se complete el registro, el portal de Azure mostrará el registro de la aplicación en la pantalla de Descripción general, junto con el ID de aplicación (o cliente) que es un valor único que identifica la aplicación.

Agregar una URI de redirección

La URL de redirección representa la ubicación a donde Microsoft redirigirá al cliente del usuario y pasará

los tokens de seguridad después de la autenticación.

  1. Navegue a la aplicación registrada en Microsoft Entra ID

  2. Haz clic en Agregar un URI de redirección para ingresar el valor. Por ejemplo: http://localhost/auth-response

Agregar un secreto de cliente

Los secretos de cliente también se conocen como una contraseña de aplicación. La aplicación registrada en Microsoft Azure requiere que se cree un registro de secreto de cliente para cada entorno de App Builder en el que se esté utilizando la conexión. Si tu configuración de App Builder tiene un entorno de desarrollo, QA y producción, necesitarás 3 registros de secreto de cliente correspondientes.

Los secretos de cliente tienen una fecha de expiración asociada, y la longitud máxima para la que se pueden establecer es de 2 años.

Generar un registro de secreto de cliente te proporciona un Valor de secreto de cliente y un ID de secreto. El Valor está codificado y solo está disponible para copiar y usar una vez (de lo contrario, se necesitaría generar un nuevo token para capturar un nuevo Valor).

  1. Navega a la aplicación registrada en Microsoft Entra ID

  2. En Administrar, selecciona Certificados y secretos

  3. Haz clic en Nuevo secreto de cliente

  4. Proporciona una Descripción. Por ejemplo: Producción de App Builder

  5. Selecciona un valor de Expira. Por ejemplo: 730 días (24 meses)

  6. Haz clic en Agregar

  7. Toma nota del Valor ya que se codificará

Puntos finales de la aplicación

Después de que una aplicación ha sido registrada en Microsoft Azure, la pantalla de Puntos finales proporciona los valores de punto final requeridos para la autenticación OAuth 2.0. Al configurar el Proveedor de Seguridad en App Builder, necesitarás hacer referencia a algunos de estos valores de Punto final.

  1. Navega a la aplicación registrada en Microsoft Entra ID

  2. Haz clic en la pestaña Puntos finales. Los siguientes valores son requeridos en App Builder:

    1. Punto final de autenticación OAuth 2.0 (v2)

    2. Punto final de token OAuth 2.0 (v2)

Asignar permisos de API

La aplicación registrada en Microsoft Azure necesita permisos asignados a Business Central. Esto debe configurarse según cómo desees integrarlo con App Builder. Un método para configurar permisos es un flujo de tipo de usuario, donde te autenticas en Azure y tus permisos en Business Central dictan el mismo conjunto de permisos en App Builder.

  1. Navega a la aplicación registrada en Microsoft Entra ID

  2. En Administrar, selecciona Permisos de API

  3. Haz clic en Agregar un permiso

  4. Haz clic en Dynamics 365 Business Central

  5. Selecciona Permisos de aplicación

  6. Haz clic en Agregar un permiso y define los permisos según los requisitos de tu negocio

Para más detalles, consulta Guía rápida: Registrar una aplicación con la plataforma de identidad de Microsoft

Para este paso de configuración, debes tener el valor de ID de aplicación (cliente) de la aplicación registrada anteriormente copiado en un lugar accesible, como tu portapapeles. En Business Central también defines los permisos de aplicación.

  1. Navega a Dynamics 365 Business Central

  2. Ve a Aplicaciones de Microsoft Entra ID

  3. Haz clic en Nuevo

  4. Ingresa el valor de ID de cliente de la aplicación registrada. Este es el valor de ID de aplicación (cliente) en Microsoft Azure.

  5. Ingresa la Descripción. Por ejemplo: Integración de App Builder Business Central

  6. Selecciona el valor de Estado para indicar si la conexión está Habilitada o Deshabilitada

  7. Define cualquier Conjunto de permisos que la aplicación tenga en Business Central

Para más detalles, consulta Registrar Business Central On-Premises en Microsoft Entra ID para integrar con otros Servicios

Servicios web de Business Central

Dentro de Business Central, puedes aprovechar los Servicios Web para exponer datos adicionales si no están disponibles, o ya expuestos, por defecto. Servicios Web te permiten exponer una página o consulta en Business Central como un Endpoint, similar en concepto a una API. Cualquier limitación y restricción en Business Central se aplica a los datos recuperados de los Servicios Web. Los Servicios Web no pueden realizar callbacks.

  1. Navega a Dynamics 365 Business Central

  2. Ve a Servicios Web

  3. Haz clic en Nuevo

  4. Selecciona el Tipo de Objeto deseado. Por ejemplo: Página

  5. Selecciona el ID de Objeto deseado

  6. Asigna un Nombre de Servicio. Esto representa el Endpoint al que lo llamarías. Por ejemplo: PaymentTerms

  7. Marca Publicado

  8. El correspondiente URI OData V4 se puede usar para acceder a estos datos, una vez que la configuración adecuada esté en su lugar

Para más detalles, consulta Servicios Web de Business Central.

Crear un proveedor de seguridad OAuth en App Builder

  1. Navega al IDE de App Builder

  2. Desde el menú Conectar, haz clic en el botón Proveedores de Seguridad

  3. Haz clic en + Autenticación de Usuario

  4. Proporciona un Nombre. Por ejemplo: Business Central OAuth

  5. Selecciona Tipo como OAuth

  6. Confirma que Habilitado esté seleccionado

  7. Establece el Tipo de Autenticación en OAuth

  8. Establece el Concesión OAuth en Credenciales de Cliente

  9. Establece la Autenticación del Cliente OAuth en Parámetro

  10. Establece la Autenticación de Recursos OAuth en Bearer

  11. Establece el Propietario del Token en Cliente

  12. Haz clic en Guardar

    attachment

  13. A continuación, configura 2 Endpoints haciendo clic en + Endpoint:

    • Tipo = Endpoint de Autorización, URL = valor del portal de Azure Endpoints

    • Tipo = Endpoint de Token, URL = valor del portal de Azure Endpoints

  14. Haz clic en + Credencial

    • Tipo = Cliente

    • Nombre de Usuario = ID de Cliente del portal de Azure

    • Contraseña = Secreto del Cliente del portal de Azure

    • Haz clic en Guardar

  15. Haz clic en + Propiedad

    • Parámetro = Alcances, Valor = valor predeterminado de Business Central. Por ejemplo: https://api.businesscentral.dynamics.com/.default

Crear una fuente de datos en App Builder

  1. Navega al IDE de App Builder

  2. Desde el menú Conectar, haz clic en el botón Servidores de Datos

  3. Haz clic en + Servidor

  4. Asigna un Nombre del Servidor. Por ejemplo: Dynamics 365 Business Central

  5. Establece el Tipo como Dynamics 365 Business Central

  6. Proporciona la Url como la Url base para acceder a Dynamics 365 en Business Central (incluye el ID de inquilino en la cadena). Por ejemplo: https://api.businesscentral.dynamics.com/v1.0/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/ODataV4

    attachment

  7. Proporciona el Nombre de la Instancia a la que deseas conectarte. Esto representa la empresa en Business Central.

    • Business Central limita las conexiones a una empresa a la vez

    • Si se requiere conectar a múltiples empresas, se deben configurar múltiples conexiones de Servidor de Datos junto con la lógica de negocio desarrollada para cada conexión de Servidor de Datos única

  8. Haz clic en el botón Configuración Avanzada

    • Si es necesario, proporciona cualquier información adicional de conexión en el campo Avanzado

    • Haz clic en Guardar

    attachment

  9. En Configuraciones de Seguridad, establece el Proveedor de Seguridad al proveedor de Business Central configurado

  10. Haz clic en Guardar

Prueba la conexión

Bajo Pruebas, haz clic en el botón Probar Conexión y asegúrate de que la configuración esté funcionando como se espera.

Importar los datos del endpoint

Después de establecer la configuración, puedes importar cualquier dato de Endpoint deseado desde Business Central a App Builder. Una vez importados, puedes exponer, interactuar y manipular los datos como lo harías normalmente en App Builder; se aplicarán los permisos de Business Central.

  1. Navega a la IDE de App Builder

  2. Desde el menú Conectar, haz clic en el botón Servidores de Datos

  3. Localiza la conexión del servidor de datos de Dynamics 365 Business Central creada y selecciónala

  4. Haz clic en el botón Detalles de la entrada del servidor de datos de Dynamics 365 Business Central en el panel derecho

  5. Haga clic en el botón Importar

  6. Proporcione el valor de Endpoint de los Servicios Web en Patrón de Importación que desea coincidir. Por ejemplo: PaymentTerms

  7. Haga clic en el botón Importar. App Builder importará el esquema.

Solución de problemas

Si experimenta problemas con el servidor de Microsoft Dynamics 365 Business Central, se recomiendan los siguientes pasos de solución de problemas:

  1. Habilite el registro de datos para generar archivos de registro y datos, que puede descargar e inspeccionar.

  2. Consulte la documentación del Proveedor ADO.NET de CData para Microsoft Dynamics 365 Business Central para obtener información detallada.