Open Office Hours Saison 1 : Session 3 - Connexions : D365 OData Cloud
Pour connecter votre système Microsoft Dynamics 365 à Rapidi, il vous faut une connexion OData. Que vous intégriez Business Central, D365 Finance ou D365 Sales, la démarche suit toujours le même schéma. Une fois ces étapes maîtrisées, vous pouvez configurer n'importe quelle connexion D365 en cinq minutes environ.
Dans cet article, nous vous expliquons comment configurer une connexion OData Cloud - vous y trouverez aussi l'enregistrement de la session 3 des Open Office Hours - Connexion OData Cloud.
Dans notre série Open Office Hours, des formations en direct de 30 minutes que nous proposons de janvier à avril, nous abordons tout, de la configuration de base aux paramétrages avancés.
Configurer des connexions OData Dynamics 365 dans Rapidi : Business Central, Finance & Sales
La configuration de connexions OData entre Microsoft Dynamics 365 et Rapidi suit un schéma en trois étapes :
- enregistrer une application dans Azure,
- configurer l'application dans votre ERP,
- puis créer la connexion dans Rapidi.
Ce guide vous accompagne à chaque étape, avec les paramètres précis dont vous avez besoin.
Regardez l'enregistrement de notre troisième session : Connexions - Dynamics 365 ODATA Cloud
Diapositives de la présentation
Avant de commencer
Vous aurez besoin d'accéder à trois systèmes :
-
D'abord, le portail Azure, avec les droits nécessaires pour enregistrer des applications.
-
Ensuite, votre instance Microsoft Dynamics 365 (Business Central, Finance ou Sales) avec un accès administrateur.
-
Enfin, votre compte de service Rapidi.
La mise en place de la connexion comporte trois grandes phases : l'enregistrement de l'application dans Azure, la configuration de l'ERP et la création de la connexion dans Rapidi. Chaque système transmet les identifiants au suivant.
Étape 1 : enregistrer votre application dans Azure
1 Créer l'enregistrement d'application
Ouvrez le portail Azure et accédez à App Registrations. Cliquez sur « New registration » et donnez à votre application un nom explicite (par exemple « Rapidi-Production » ou « Rapidi-Test-2026 »).
Ajoutez une URL de redirection. Elle est obligatoire pour les connexions Business Central. Utilisez l'URL de redirection indiquée dans votre documentation Rapidi.
2 Définir les autorisations d'API
Votre application a besoin d'autorisations pour accéder aux données D365. Ouvrez API Permissions et cliquez sur « Add a permission ».
Recherchez votre système cible (par ex. Business Central, Dynamics 365 Finance). Il vous faut deux types d'autorisations :
Delegated permissions : sélectionnez toutes les autorisations disponibles dans cette catégorie.
Application permissions : cliquez de nouveau sur « Add a permission », sélectionnez votre système, choisissez « Application permissions », puis sélectionnez les options disponibles.
Une fois les deux ajoutées, cliquez sur « Grant admin consent » pour que les autorisations apparaissent comme « Granted » (coche verte).
3 Créer un secret client
Ouvrez « Certificates & secrets » et cliquez sur « New client secret ». Donnez-lui un nom et choisissez une durée de validité.
Copiez immédiatement la valeur du secret. C'est votre mot de passe pour la connexion Rapidi. Elle ne s'affiche qu'une seule fois.
Avant de quitter Azure, notez ces valeurs sur la page Overview de votre application :
| Champ Azure | Champ Rapidi |
|---|---|
| Application (client) ID | User ID |
| Directory (tenant) ID | Domain |
| Client secret value | Password |
Étape 2 : configurer votre ERP
Pour Dynamics 365 Business Central
Dans Business Central, recherchez « Microsoft Entra » et ouvrez la page. Cliquez sur « New » pour créer une nouvelle entrée d'application.
Collez votre Application ID Azure dans le champ Application ID. Donnez à l'entrée un nom qui correspond à l'enregistrement de votre application dans Azure. Activez l'application.
Ajoutez des ensembles d'autorisations. Il vous faut au minimum :
les autorisations d'automatisation et les autorisations d'administration. Selon votre configuration, des ensembles d'autorisations supplémentaires peuvent être nécessaires pour certaines fonctionnalités.
Cliquez sur « Grant consent » et acceptez la demande d'autorisations.
Pour Dynamics 365 Finance
La démarche est similaire. Enregistrez votre application Azure dans Dynamics 365 Finance, ajoutez l'Application ID et attribuez les rôles de sécurité requis.
Pour Dynamics 365 Sales
Dans Dynamics 365 Sales, enregistrez l'application Azure et attribuez les rôles de sécurité appropriés pour accéder aux données dont vous avez besoin.
Étape 3 : créer la connexion dans Rapidi
Connectez-vous à votre service Rapidi et créez une nouvelle connexion. Sélectionnez le type de connexion en fonction de votre ERP :
| Système | Type de connexion |
|---|---|
| Business Central | BC Nav OData |
| D365 Finance | Finance OData |
| D365 Sales | D365 Sales OData |
Les champs de connexion en détail
Server/Instance URL : vous l'obtenez dans les services web de votre ERP. Dans Business Central, ouvrez Web Services, trouvez une page comme Customer Card et copiez l'URL OData.
Company : le nom de la société dans votre instance ERP.
User ID : votre Application (client) ID Azure.
Password : la valeur du secret client que vous avez copiée dans Azure.
Domain : votre ID de locataire (tenant ID) Azure.
Resource : l'URL de base de votre ERP (l'URL jusqu'au domaine inclus).
Metadata URL : votre URL OData jusqu'à « /ODataV4 », suivie de « /$metadata ».
Cochez « Use SSL » et choisissez la méthode d'authentification appropriée.
Cliquez sur « Test » pour vérifier la connexion. Si le test réussit, un message de confirmation s'affiche.
Lancer un Redesign pour charger les métadonnées
Après le test, cliquez sur « Redesign » pour lire les tables et les champs disponibles dans votre ERP. Les métadonnées sont ainsi chargées, et Rapidi sait à quelles données vous pouvez accéder.
Les connexions OData affichent le nombre d'enregistrements et de tables disponibles, pas le nom de chaque table. Pour vérifier l'accès, consultez la liste Web Services de votre ERP. Tout ce qui y est publié sera disponible via la connexion.
Gérer votre connexion
Quand les secrets expirent
Lorsque votre secret client expire, Rapidi envoie des notifications d'erreur. Pour y remédier :
Dans Azure, ouvrez l'enregistrement de votre application et créez un nouveau secret client. Copiez la nouvelle valeur. Dans Rapidi, modifiez votre connexion et mettez à jour uniquement le champ du mot de passe avec la nouvelle valeur du secret. Enregistrez, puis testez la connexion.
Ajouter de nouvelles tables ou de nouveaux champs
Si vous ajoutez de nouvelles pages ou de nouveaux champs dans votre ERP, ils n'apparaissent pas automatiquement dans Rapidi. Après avoir publié de nouvelles pages dans Web Services (pour Business Central) ou rendu des champs visibles dans votre ERP, ouvrez votre connexion Rapidi et cliquez sur « Redesign » pour actualiser les métadonnées.
Si un champ n'apparaît toujours pas après le Redesign, vérifiez qu'il est bien publié sur la page dans l'interface de votre ERP. Les champs qui n'existent que dans le back-end doivent être exposés dans le front-end avant que Rapidi puisse les lire.
Réutiliser une application pour plusieurs connexions
Vous pouvez utiliser le même enregistrement d'application Azure pour plusieurs connexions. Créez une seule application dans Azure, puis utilisez les mêmes identifiants pour configurer dans Rapidi des connexions vers différentes instances ERP. Vous gagnez du temps et réduisez le nombre d'applications à gérer.
Pages OData ou pages API
Dans Business Central, Microsoft passe progressivement des pages OData aux pages API. Les deux fonctionnent avec Rapidi. La configuration de la connexion est identique pour l'un et l'autre type. Vous pouvez lire et écrire des données et effectuer toutes les opérations standard, que vous vous connectiez à des pages OData ou à des pages API.
Résoudre les problèmes courants
Échec du test de connexion : vérifiez que vous avez bien accordé le consentement administrateur dans Azure. Contrôlez que l'Application ID est identique dans Azure et dans votre ERP. Assurez-vous que le secret client n'a pas expiré.
Tables manquantes : dans Business Central, consultez Web Services pour vérifier que la page est publiée. Après publication, lancez un Redesign de la connexion dans Rapidi.
Champs manquants : les champs doivent être visibles dans l'interface de votre ERP. Ajoutez le champ à la mise en page, puis lancez un Redesign dans Rapidi.
Erreurs d'autorisation : vérifiez les ensembles d'autorisations attribués à votre application dans l'ERP. Assurez-vous que les autorisations d'automatisation et d'administration en font partie.
Questions fréquentes
Que se passe-t-il lorsque mon secret client Azure expire ?
Vous recevez des notifications d'erreur de Rapidi. Créez un nouveau secret dans Azure, copiez sa valeur et mettez à jour le champ du mot de passe dans votre connexion Rapidi. Lancez un test pour confirmer que le problème est résolu.
Pourquoi certaines tables ou certains champs n'apparaissent-ils pas après la connexion ?
Les tables et les champs doivent être publiés dans les Web Services de votre ERP avant d'apparaître dans Rapidi. Publiez les éléments manquants, puis lancez un Redesign de votre connexion pour actualiser les métadonnées.
Puis-je utiliser la même application Azure pour plusieurs connexions D365 ?
Oui. Créez un seul enregistrement d'application dans Azure et réutilisez ces identifiants pour plusieurs connexions dans Rapidi.
Y a-t-il une différence entre les pages OData et les pages API pour les connexions Rapidi ?
Aucune différence fonctionnelle dans la configuration de la connexion. Les deux types de pages fonctionnent de la même manière avec Rapidi.
Prochaines étapes
Une fois votre connexion OData D365 configurée, vous pouvez créer des transferts pour déplacer des données entre vos systèmes. La connexion gère l'authentification et l'accès aux données, tandis que les transferts définissent quelles données sont transférées et à quel moment.
Inscrivez-vous à la session de la semaine prochaine : Connexions : Salesforce & HubSpot
Si vous devez connecter Salesforce ou HubSpot, ces systèmes utilisent une autorisation OAuth plutôt qu'un enregistrement d'application Azure, mais la démarche dans Rapidi suit un schéma similaire.
Vous avez manqué les sessions précédentes ? Retrouvez les enregistrements de
Consultez le Wiki Rapidi pour une documentation détaillée, ou soumettez une demande de support si vous rencontrez un problème.
Open Office Hours
Chaque semaine, nos spécialistes de l'intégration animent une formation gratuite de 30 minutes sur un thème précis de MyRapidi.