Comment migrer d'OData vers les pages API dans Dynamics 365 Business Central
Vous avez probablement déjà entendu l'annonce : Microsoft abandonne progressivement la possibilité d'exposer des pages d'interface utilisateur (UI) en tant que points de terminaison OData (et SOAP). À la place, vous devrez utiliser des pages API. Cet abandon s'inscrit dans une stratégie de modernisation pluriannuelle qui vise à standardiser les intégrations autour des pages API et des requêtes API, conçues spécifiquement pour l'accès programmatique.Migrer d'OData vers les pages API dans Dynamics 365 Business Central consiste à identifier les points de terminaison OData, à créer les pages API correspondantes et à transférer vos données tout en garantissant des autorisations appropriées et la cohérence des données. Vous bénéficiez ainsi d'un accès aux données plus rapide, plus sûr et modernisé.
Cela peut sembler un peu tôt, mais plus vous vous préparez tôt, mieux vous serez positionné le jour où il faudra basculer.
Résumé
Ce guide explique comment passer des points de terminaison OData de pages UI aux pages API et aux requêtes API dans Microsoft Dynamics 365 Business Central.Vous découvrirez le calendrier de ces changements, les raisons qui poussent Microsoft à les mettre en œuvre, ce qui distingue les pages API d'OData et des requêtes API, ainsi que les étapes pour migrer vos intégrations.
Utilisez ce guide pour que vos intégrations restent fonctionnelles, sécurisées et à jour.
Table des matières
- Dates clés et changements de la migration
- Pourquoi Microsoft s'éloigne d'OData
- OData ou pages API : quelles différences ?
- Pages API ou requêtes API : lesquelles utiliser ?
- Migrer d'OData vers les pages API : étape par étape
- Questions fréquentes
Dates clés et changements de la migration
- 2025 (v26, Wave 1) : des avertissements s'affichent si vous utilisez OData avec des pages UI.
- 2026 (v28–v29) : Microsoft ajoute de nouvelles fonctionnalités d'API et davantage d'avertissements.
- 2027 (v30, Wave 1) : OData avec les pages UI cesse de fonctionner. Seules les pages API et les requêtes API fonctionneront.
Source : Microsoft – Fonctionnalités dépréciées dans Business Central
Pourquoi Microsoft s'éloigne d'OData
- Les pages API sont destinées aux intégrations. Les pages UI sont destinées aux utilisateurs.
- Les pages API traitent les données plus rapidement et gèrent mieux les filtres et les grands volumes de données.
- Les pages API offrent un meilleur contrôle sur qui peut accéder à quoi.
- Les pages API utilisent des numéros de version, ce qui réduit le risque qu'une mise à jour casse vos intégrations.
OData ou pages API : quelles différences ?
| Caractéristique | OData (page UI) | Page API |
|---|---|---|
| Rôle | Expose une page UI comme point de terminaison | Conçue pour les intégrations |
| Vitesse | Plus lente avec beaucoup de données | Plus rapide, gère davantage d'enregistrements |
| Gestion des versions | Aucune | Oui (v2.0, v3.0, etc.) |
| Stabilité | Change si l'UI change | Plus stable, fondée sur un contrat |
| Sécurité | Basée sur la page | Basée sur le contrat de données |
| Support | En voie de disparition | Entièrement prise en charge |
Pages API ou requêtes API : lesquelles utiliser ?
Les pages API et les requêtes API vous donnent toutes deux accès aux données de Business Central, mais leurs usages diffèrent :
- Pages API : utilisez-les pour travailler sur les enregistrements d'une table (comme les clients ou les commandes vente). Vous pouvez lire, créer, modifier et supprimer des enregistrements si vous disposez des autorisations nécessaires.
- Requêtes API : utilisez-les lorsque vous devez extraire des données de plusieurs tables ou que vous avez besoin d'un rapport personnalisé. Les requêtes API peuvent joindre, filtrer et regrouper des données, mais elles sont en lecture seule. Elles conviennent bien aux rapports personnalisés ou aux données de synthèse.
En bref : utilisez les pages API pour les opérations courantes sur les données. Utilisez les requêtes API pour les rapports personnalisés ou lorsque vous devez combiner des données provenant de différentes sources.
Migrer d'OData vers les pages API : étape par étape
- Remplacez les anciens points de terminaison OData comme
/ODataV4/Page/CustomerCardpar des points de terminaison de pages API comme/api/v2.0/customers,/vendorsou/salesOrders. - Mettez à jour les mappages de vos intégrations et actualisez les métadonnées.
- Utilisez des champs comme
systemModifiedAtoulastModifiedDateTimepour ne synchroniser que les données modifiées. - Testez vos intégrations dans un environnement sans risque. Les pages API sont généralement 30 à 50 % plus rapides.
- Si vous avez besoin de champs personnalisés, créez des pages API personnalisées avec des extensions AL.
Pour aller plus loin, consultez cet article qui explique comment lire les pages API de Microsoft Dynamics 365 Business Central et vous y intégrer.
💡 Conseil de pro ! Basculer sans tarder permet à vos intégrations de continuer à fonctionner et facilite la maintenance.
Comme toujours, si vous avez besoin d'aide pour faire passer votre intégration d'OData aux pages API, n'hésitez pas à contacter l'équipe du support Rapidi.
Mis à jour en février 2026
Questions fréquentes
Quand les points de terminaison OData cessent-ils de fonctionner ?
Les points de terminaison OData de pages UI cessent de fonctionner avec la version 30 (2027 Wave 1).
Pourquoi utiliser les pages API plutôt qu'OData ?
Les pages API sont plus rapides, plus sûres et risquent moins de cesser de fonctionner.
Dois-je réécrire toutes mes intégrations ?
Si votre intégration utilise des pages UI via OData, vous devez passer aux pages API ou aux requêtes API avant 2027.