Cet article a été rédigé par Sébastien Manjony, Directeur technique chez Prodware
Lors de la construction de la solution et de ces interactions avec d’autres applications, les équipes doivent prendre des décisions réfléchies concernant les scénarios d’intégration de données lors de l’implémentation de D365 Finance.
D365 Finance met à sa disposition plusieurs types d’APIs qui prennent en charge les scénarios d’intégration :
- Open Data Protocol (OData)
- Custom services
- Web services externe
- Intégrations Office
- Intégrations récurrentes
- Data management package API
Selon les réponses aux questions à poser sur le volume, la récurrence, la fréquence, qui est maître ou esclave, la gestion des erreurs sur l’interface, la planification et si vous faites du full ou de l’incrémentiel pour l’échange des données, vous atteignez un niveau de complexité qui définira la bonne API à utiliser.
Comment déterminer la meilleure API selon votre scénario ?
Open Data Protocol (OData) :
Les endpoints du service OData doivent être utilisés pour le scénario d’intégration lorsque des données en temps réel sont nécessaires. Par exemple, lorsqu’un produit est créé ou modifié dans l’application tierce, l’utilisateur verra les mêmes modifications dans D365 Finance en temps réel.
- Déterminez quelles entités légales sont nécessaires à l’intégration.
- Assurez-vous que les endpoints du service OData sont disponibles pour le même ensemble d’entités légales identifiées comme requises pour l’intégration.
- Dans l’application tierce, assurez-vous que lorsque les données sont créées ou modifiées, un appel OData est effectué vers D365 Finance pour effectuer la même modification.
OData est un protocole standard de création et de consommation de données. Le but d’OData est de fournir un protocole pour les opérations de création, lecture, mise à jour et suppression (CRUD). OData utilise des technologies Web telles que HTTP JSON pour fournir un accès à l’information provenant de diverses applications. Il permet aux développeurs d’interagir avec les données en utilisant les services web RESTful. Il est possible d’afficher une liste de toutes les entités exposées, via une url. OData active un langage SQL qui permet de créer des requêtes enrichies sur la base de données, de sorte que les résultats ne comprennent que les éléments de données souhaités.
Custom Service :
Le custom service peut être utilisé lorsque l’entité de données n’est pas facilement disponible et que son développement n’est pas souhaité.
Par exemple, lorsqu’une personne passe une commande de vente, le système tiers a besoin d’informations provenant de D365 Finance pour informer si l’article est en stock en temps réel. Ce scénario peut être implémenté à l’aide d’un custom service.
La solution recommandée est la suivante :
- Un custom appel est créé dans D365 Finance pour calculer l’inventaire physique disponible pour un article donné.
- Dans l’application tierce, un appel en temps réel est effectué vers un endpoint du custom service via REST (ou SOAP) pour récupérer les informations d’inventaire d’un article.
Ce scénario peut également être réalisé en utilisant une action Odata qui exécuterait la logique spécifique pour obtenir les données requises.
Avec OData, les customs services et les modèles d’intégration synchrones, la logique métier est immédiatement exécutée lorsque les API sont appelées. Les customs sont plutôt orientés pour la réalisation soit de requêtes dont la logique nécessite du code spécifique, soit d’actions spécifiques (validation, changement de statut). Les délais de traitement sont soumis au délai d’expiration des services web, qui ne dépasse pas quelques minutes. Cela est très utile pour interroger rapidement des données très fluctuantes.
Par exemple, si un custom service est utilisé pour rechercher un stock disponible, la logique métier est immédiatement exécuté dans le cadre de l’appel du endpoint JSON/SOAP et, lors de l’implémentation, la somme du stock est immédiatement renvoyée. Alternativement, OData peut être utilisé pour insérer des enregistrements, qui sont immédiatement insérés dans le cadre de l’appel OData.
Intégrations récurrentes
Cette API permet l’échange de documents ou de fichiers entre le service D365 Finance et toute application ou service tiers, en envoyant des fichiers ou des data packages. Elle repose sur des API REST sécurisées et des mécanismes d’autorisation pour gérer l’envoi et la réception de données avec les systèmes d’intégration
L’API d’intégrations récurrentes prend en charge à la fois l’importation et l’exportation de données avec de nombreux avantages.
- Planification des tâches : effectuée dans D365 Finance
- Plusieurs formats de données : Fichiers et data packages pour l’importation et l’exportation.
- Transformation : Si vos données sont au format XML, XSLT est pris en charge pour convertir les données.
- Protocoles : Les deux protocoles pris en charge pour les intégrations récurrentes sont SOAP et REST.
Data management framework package API
Le Data management Framework est un scénario d’intégration basé sur des fichiers qui est pris en charge par les D365 Finance. Plusieurs raisons peuvent pousser votre organisation à choisir ce scénario :
- Planification : Contrairement aux intégrations récurrentes, la planification est effectuée en dehors de D365 Finance
- Formats : uniquement les data packages.
- Transformation : Transformations de données externes au système.
- Protocoles : REST est pris en charge.
Intégrations Office :
Les capacités d’intégration de Microsoft Office offrent aux utilisateurs un environnement productif qui les aide à accomplir leur travail en utilisant les produits Office.
Microsoft Excel peut modifier et analyser rapidement les données. L’application Excel Data Connector interagit avec les classeurs Excel et les services OData créés pour les entités de données exposées publiquement. L’Add-in Excel Data Connector permet à Excel de devenir un élément transparent de l’expérience utilisateur. Cet Add-in permet de réaliser les opérations CRUD (Create, Read, Update, Delete) en lien avec D365 Finance. L’Add-in s’exécute dans un volet Office.
Service Web externe :
Le service Web externe est implémenté dans D365 Finance en appelant ou en consommant le service Web externe qui facilite l’échange de données.
