Select a data integration (import/export) strategy
This unit explores integration patterns, scenarios, and solutions for finance and operations. Although this unit does not include technical details about how to use or set up every integration pattern or how to work with sample code, it is always wise to be aware of available integration tools.
The following integration patterns are available for finance and operations apps:
- OData
- Batch data API
- Custom service
- Consume external web services
- Excel integration
OData
OData is a standard protocol for creating and consuming data. The purpose of OData is to provide a protocol that is based on Representational State Transfer (REST) for create, read, update, and delete (CRUD) operations. OData applies web technologies such as HTTP and JavaScript Object Notation (JSON) to provide access to information from various programs.
OData provides the following benefits:
- Allowing developers to interact with data by using RESTful web services
- Providing a simple and uniform way to share data in a discoverable manner
- Enabling broad integration across products
- Enabling integration by using the HTTP protocol stack
Batch data API
Use the batch data API in scenarios that require one or both Data management package REST API and Recurring integrations. Both APIs support data import scenarios and data export scenarios.
For finance and operations apps, we have tried to simplify this process for all parties who are involved, from integration solution builders to customer users.
The package API lets you integrate with finance and operations apps by using data packages. The REST API can be used with both cloud and on-premises deployments. The data management framework's package API uses OAuth 2.0 for authorizing access.
The process of data migration, and movement into and out of any enterprise system, are critical pieces that any platform must support.
Recurring integration does the following:
- Builds on data entities and the Data management framework
- Enables the exchange of documents or files between finance and operations apps and any third-party application or service
- Supports several document formats, source-mapping, and filters
- Uses secure Representational State Transfer (REST) application programming interfaces (APIs) and authorization mechanisms to receive data from, and send data back to, integration systems
Before the integrating client application can consume this endpoint, you need to create an application ID in Microsoft Entra ID and give it appropriate permission to finance and operations apps.
When you create and enable a recurring job, you're prompted to enter the Microsoft Entra ID application ID that will interact with that recurring job. Therefore, be sure to make a note of the application ID.
Much effort and planning go into building third-party integrations between an enterprise line of business (LOB) system, such as Microsoft finance and operations apps, and various source systems.
Custom service
A developer can create custom services for finance and operations apps. When a developer writes a custom service under a service group, the service group is always deployed on two endpoints:
- SOAP endpoint – Code examples for consuming custom services using SOAP are available in the Microsoft Dynamics AX Integration GitHub repository - SoapConsoleApplication.
- JSON endpoint – Code examples for consuming JSON services are available in the Microsoft Dynamics AX Integration GitHub repository - JsonConsoleApplication.
Consume external web services
A developer consumes web services by adding new class libraries to finance and operations apps.
Excel integration
The Microsoft Office integration capabilities provide users with a productive environment that helps them get the job done by using Office products. Microsoft Excel can change and quickly analyze data.
The Excel Data Connector app interacts with Excel workbooks and OData services that are created for publicly exposed data entities. The Excel Data Connector add-in enables Excel to become a seamless part of the user experience. The Excel Data Connector add-in is built by using the Office Web add-ins framework. The add-in runs in a task pane.
Synchronous vs. asynchronous integration patterns
Processing can be either synchronous or asynchronous. Often, the type of processing that you must use determines the integration pattern that you choose.
A synchronous pattern is a blocking request and response pattern, where the caller is blocked until the recipient has finished running the Excel integration and gives a response. An asynchronous pattern is a non-blocking pattern, where the caller submits the request and then continues without waiting for a response.
Consider using OData for synchronous and Batch data API for asynchronous integration scenarios.