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 autenticarse desde App Builder. Microsoft Azure se utilizará para configurar el flujo de autenticación OAuth.

Esta guía presupone que ya tienes un sistema contable de Microsoft Dynamics 365 Business Central existente que deseas conectar a App Builder.

Para los pasos de configuración en Microsoft Azure y Dynamics 365 Business Central, esta guía proporciona información de 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 autenticarse desde App Builder a Microsoft Business Central y Dynamics 365 es OAuth 2.0. Configuraremos el flujo OAuth usando Microsoft Azure.

  1. Accede al portal del centro de administración de Azure Active Directory

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

  3. Proporciona un Nombre. Es posible que los usuarios de la aplicación vean este valor en algunas ocasiones. Por ejemplo: App Builder Business Central

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

  5. Haz clic en Registrar

Una vez completado el registro, el portal de Azure mostrará el registro de aplicaciones 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 un URI de redireccionamiento

La URL de redireccionamiento representa la ubicación a donde Microsoft redireccionará el cliente del usuario y pasará

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

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

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

Agregar un secreto de cliente

Los secretos de cliente también se conocen como 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 utilice la conexión. Si tu configuración de App Builder tiene un entorno de desarrollo, control de calidad y producción, necesitarás 3 registros de secreto de cliente correspondientes.

Los secretos de cliente tienen una fecha de vencimiento asociada, y la duración máxima para la que se pueden configurar 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, sería necesario generar un nuevo token para capturar un Valor nuevo).

  1. Accede 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: App Builder Producción

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

  6. Haz clic en Agregar

  7. Ten en cuenta el Valor ya que se codificará

Puntos de conexión de la aplicación

Una vez que se ha registrado una aplicación en Microsoft Azure, la pantalla Puntos de conexión proporciona valores de punto de conexión necesarios para la autenticación OAuth 2.0. Cuando configures el Proveedor de seguridad en App Builder, necesitarás hacer referencia a algunos de estos valores de Punto de conexión.

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

  2. Haz clic en la pestaña Puntos de conexión. Los siguientes valores se requieren en App Builder:

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

    2. Punto de conexión 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 en función de cómo desees integrarlo con App Builder. Un método para configurar permisos es un flujo de tipo 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 tus necesidades empresariales

Para obtener más información, consulta Inicio rápido: Registrar una aplicación con la plataforma de identidad de Microsoft

Para este paso de configuración, debes tener el valor de Identificador de aplicación (cliente) de la aplicación registrada anterior copiado en algún lugar a mano para usarlo, 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 Identificador de cliente de la aplicación registrada. Este es el valor de Identificador 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 tenga la aplicación en Business Central

Para obtener más información, consulta Registrar Business Central local en Microsoft Entra ID para integrar con otros servicios

Servicios web de Business Central

En Business Central, puedes aprovechar los Servicios web para exponer datos adicionales si no está disponible, o ya está expuesto, de forma predeterminada. Los Servicios web te permiten exponer una página o Consulta en Business Central como un Punto de acceso, similar en concepto a una API. Todas las limitaciones y restricciones en vigor en Business Central se trasladan a los datos recuperados de los Servicios web. Los Servicios web no pueden realizar devoluciones de llamada.

  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 Identificador de objeto deseado

  6. Asigna un Nombre de servicio. Esto representa el Punto de acceso al que lo llamarías. Por ejemplo: CondicionesDePago

  7. Marca la casilla Publicado

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

Para obtener más información, consulta Servicios web de Business Central.

Crea 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 + Proveedor de seguridad

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

  5. Selecciona Tipo como OAuth

  6. Confirma que Habilitado esté seleccionado

  7. Establece Tipo de autenticación en OAuth

  8. Establece Concesión de OAuth en Credenciales de cliente

  9. Establece Autenticación de cliente de OAuth en Parámetro

  10. Establece Autenticación de recurso de OAuth en Portador

  11. Establece Propietario de token en Cliente

  12. Haz clic en Guardar

    attachment

  13. A continuación, configura 2 Puntos de acceso haciendo clic en + Punto de acceso:

    • Tipo = Punto de acceso de autorización, URL = valor de los Puntos de acceso del portal de Azure

    • Tipo = Punto de acceso de token, URL = valor de los Puntos de acceso del portal de Azure

  14. Haz clic en + Credencial

    • Tipo = Cliente

    • Nombre de usuario = Identificador de cliente del portal de Azure

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

    • Haz clic en Guardar

  15. Haz clic en + Propiedad

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

Crea una fuente de datos en App Builder

  1. Navega al App Builder IDE

  2. En el menú Connect, haz clic en el botón Data Servers

  3. Haz clic en + Server

  4. Asigna un Server Name. Por ejemplo: Dynamics 365 Business Central

  5. Establece el Type 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 Instance Name al que conectarse. Este representa la empresa en Business Central.

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

    • Si se requiere conectarse a varias empresas, se deben configurar múltiples conexiones de Data Server junto con la lógica empresarial desarrollada para cada conexión de Data Server única

  8. Haz clic en el botón Advanced Settings

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

    • Haz clic en Save

    attachment

  9. En Security Settings, establece Security Provider al proveedor de Business Central configurado

  10. Haz clic en Save

Prueba la conexión

En Testing, haz clic en el botón Test Connection y asegúrate de que la configuración funcione según lo esperado.

Importa los datos del endpoint

Una vez que la configuración se ha establecido, puedes importar cualquier dato de Endpoint deseado desde Business Central a App Builder. Una vez importado, puedes exponer, interactuar y manipular los datos como lo harías normalmente en App Builder; se aplicarán todos los permisos de Business Central.

  1. Navega al App Builder IDE

  2. En el menú Connect, haz clic en el botón Data Servers

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

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

  5. Haz clic en el botón Import

  6. Proporciona el valor de Endpoint de Web Services en Import Pattern que deseas que coincida. Por ejemplo: PaymentTerms

  7. Haz clic en el botón Import. App Builder importará el esquema.

Solución de problemas

Si experimentas problemas con el servidor de Microsoft Dynamics 365 Business Central, se recomiendan estos pasos para la solución de problemas:

  1. Habilita el registro de datos para generar archivos de registro y datos, que puedes descargar e inspeccionar.

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