Saltar al contenido

Guía de Conexión a Microsoft Dynamics 365

Descripción General

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

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

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

Requisitos del Sistema

Servidor de Base de Datos

  • Dynamics 365 Business Central

  • Active Directory de Azure

Navegador Web del Cliente

  • Chrome: 84+

  • Firefox: 73+

  • Safari: 13.0.1+

  • Ventaja: 84+

Instrucciones de Conexión

Registrar una Aplicación en Microsoft Azure

El método utilizado para autenticarse desde App Builder para Microsoft Business Central y Dynamics 365 se utiliza OAuth 2.0. Configuraremos el flujo de OAuth mediante Microsoft Azure.

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

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

  3. Proporcione un Nombre. Los usuarios de la aplicación pueden mostrar este valor en ocasiones. Por ejemplo: App Builder central de negocios

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

  5. Haga clic en Registrarse

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

Agregar una URL de Redireccionamiento

La * URL de redireccionamiento* representa la ubicación donde Microsoft redirigirá al cliente del usuario y lo pasará

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

  1. Navegue hasta la aplicación registrada en Azure Active Directory

  2. Haga clic en Agregar una URL 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 aplicación. App Builder ambiente en el que se utiliza la conexión. Si su App Builder la configuración tiene un ambiente de desarrollo, control de calidad y producción, necesitará 3 registros secretos de cliente correspondientes.

Los secretos de cliente tienen una fecha de vencimiento asociada y la duración máxima que se puede establecer es de 2 años.

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

  1. Navegue hasta la aplicación registrada en Azure Active Directory

  2. En Administrar, seleccione Certificados y secretos

  3. Haga clic en Nuevo secreto de cliente

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

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

  6. Haga clic en Agregar

  7. Anote el Valor, ya que se codificará

Extremos de la Aplicación

Una vez que se haya registrado una aplicación en Microsoft Azure, la pantalla Extremos proporciona los valores de extremo necesarios para la autenticación OAuth 2.0. Al configurar el proveedor de seguridad en App Builder será necesario hacer referencia a algunos de estos valores de Extremo.

  1. Navegue hasta la aplicación registrada en Azure Active Directory

  2. Haga clic en la pestaña Extremos. Los siguientes valores son obligatorios en App Builder:

    1. extremo de autenticación OAuth 2.0 (v2)

    2. extremo del 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 desea integrarla con App Builder un método para configurar permisos es un flujo de tipo de usuario, donde usted se autentica en Azure y sus permisos en Business Central dictan los mismos permisos establecidos en App Builder.

  1. Navegue hasta la aplicación registrada en Azure Active Directory

  2. En Administrar, seleccione Permisos de API

  3. Haga clic en Agregar un permiso

  4. Haga clic en Dynamics 365 Business Central

  5. Seleccione Permisos de la aplicación

  6. Haga clic en Agregar un permiso y defina los permisos según los requisitos de su negocio.

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

Para este paso de configuración, debe tener el valor de ID de aplicación (cliente) de la aplicación registrada anteriormente copiado en algún lugar a mano para su uso, como el portapapeles. En Business Central también se definen los permisos de la aplicación.

  1. Vaya a Dynamics 365 Business Central

  2. Vaya a Aplicaciones de Azure Active Directory

  3. Haga clic en Nuevo

  4. Ingrese 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. Ingrese la Descripción. Por ejemplo: App Builder integración de Business Central

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

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

Para obtener más detalles, consulte Registrar Business Central local en Azure AD para integrarlo con otros Servicios

Servicios Web Centrales para Empresas

Dentro de Business Central, puedes aprovechar los Servicios web para exponer datos adicionales si no están disponibles o si ya están expuestos de forma predeterminada. Los Servicios web te permiten exponer una página o consulta en Business Central como un Extremo, un concepto similar al de una API. Las limitaciones y restricciones que se aplican en Business Central se trasladan a los datos recuperados de los Servicios web. Los Servicios web no pueden realizar devoluciones de llamadas.

  1. Vaya a Dynamics 365 Business Central

  2. Vaya a Servicios web

  3. Haga clic en Nuevo

  4. Seleccione el Tipo de objeto deseado. Por ejemplo: Página

  5. Seleccione el ID de objeto deseado

  6. Asigna un Nombre de servicio. Esto representa el Extremo en el que lo llamarías. Por ejemplo: PaymentTerms

  7. Marque la casilla Publicado

  8. Se puede utilizar la URI OData V4 correspondiente para acceder a estos datos, una vez que se haya realizado la configuración adecuada.

Para obtener más detalles, consulte Servicios web de Business Central.

Cree un Proveedor de Seguridad OAuth en App Builder

  1. Navegue hasta App Builder IDE

  2. En el menú Conectar, haga clic en el botón Proveedores de seguridad

  3. Haga clic en + Autenticación de usuario

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

  5. Seleccione Tipo como OAuth

  6. Confirme que Habilitado esté seleccionado

  7. Establezca Tipo de autenticación en OAuth

  8. Establezca Concesión OAuth en Credenciales del cliente

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

  10. Establezca Autenticación de recurso OAuth en Portador

  11. Establezca Propietario del token en Cliente

  12. Haga clic en Guardar

    adjunto

  13. A continuación, configure 2 Extremos haciendo clic en + Extremo:

    • Tipo = Extremo de autorización, URL = valor de los Extremos del portal de Azure

    • Tipo = Extremo del token, URL = valor de los Extremos del portal de Azure

  14. Haga clic en + Credencial

    • Tipo = Cliente

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

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

    • Haga clic en Guardar

  15. Haga clic en + Propiedad

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

Crear una Fuente de Datos en App Builder

  1. Navegue hasta App Builder IDE

  2. Desde el menú Conectar, haga clic en el botón Servidores de datos

  3. Haga clic en + Servidor

  4. Asigna un Nombre de servidor. Por ejemplo: Dynamics 365 Business Central

  5. Establezca el Tipo como Dynamics 365 Business Central

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

    archivo adjunto

  7. Proporcione el Nombre de instancia al que conectarse. Esto representa a la empresa en Business Central.

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

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

  8. Haga clic en el botón Configuración avanzada

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

    • Haga clic en Guardar

    adjunto

  9. En Configuración de seguridad, configure Proveedor de seguridad como el proveedor de Business Central configurado

  10. Haga clic en Guardar

Probar la Conexión

En Pruebas, haga clic en el botón Probar conexión y asegúrese de que la configuración funcione como se espera.

Importar los Datos del Extremo

Una vez establecida la configuración, puede importar cualquier dato de Extremo que desee desde Business Central a App Builder una vez que se haya importado, puede exponer, interactuar y manipular los datos como lo haría normalmente en App Builder, se aplicarán todos los permisos de Business Central.

  1. Navegue hasta App Builder IDE

  2. Desde el menú Conectar, haga clic en el botón Servidores de datos

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

  4. Haga 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 Extremo de los servicios web en Patrón de importación que desea que coincidan. Por ejemplo: PaymentTerms

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