Connecteur source MS Dynamics 365 BC

Le connecteur source MS Dynamics 365 BC dans DataSync vous permet de récupérer des données commerciales à partir de Microsoft Dynamics 365 Business Central en utilisant les points de terminaison API disponibles pour charger ou synchroniser dans votre entrepôt de données. Après avoir créé toutes les connexions source requises, configurez votre source de destination pour compléter la configuration de la connexion.

Configurer l'accès dans Microsoft Dynamics 365 BC

Assigner des permissions utilisateur

1. Connectez-vous à Dynamic 365 Business Central.
2. Cliquez sur la loupe dans le coin supérieur droit.
3. Dans la barre de recherche, entrez Utilisateurs.
4. Sélectionnez Utilisateurs sous Administration. Une liste de tous les utilisateurs apparaît.
5. Sélectionnez le compte utilisateur que vous souhaitez utiliser pour la connexion DataSync.
6. Dans Ensembles de permissions utilisateur, attribuez les autorisations requises pour la connexion. Les modifications sont enregistrées automatiquement.

Enregistrer une application dans Azure Portal

1. Connectez-vous au Portail Azure en tant qu'administrateur.
2. Sous Services Azure, sélectionnez Plus de services.
3. Dans la barre de recherche, entrez Enregistrements d'application et sélectionnez-le.
4. Cliquez sur + Nouvel enregistrement.
5. Entrez un nom pour l'application, sélectionnez les types de comptes pris en charge et ajoutez éventuellement une URL de redirection.
6. Revenez à la page Enregistrements d'application et sélectionnez votre nouvel enregistrement.
7. Dans le volet de navigation gauche, sélectionnez Autorisations API et ajoutez les autorisations nécessaires pour votre application. Accordez le consentement de l'administrateur si nécessaire.
8. Dans le volet de navigation gauche, sélectionnez Certificats et secrets et créez un nouveau secret client.
   • Important : Le secret client ne peut être copié qu'une seule fois — conservez-le en toute sécurité pour une utilisation ultérieure.

Créer une connexion source dans DataSync

1. Connectez-vous à DataSync.
2. À partir de l'écran d'accueil, sélectionnez Connexions.
3. À côté de Connexions source, cliquez sur Nouveau.
4. Sélectionnez MS Dynamics 365 BC.
5. Dans le panneau Propriétés de connexion, entrez les propriétés de connexion.
6. Copiez l'URL de rappel depuis le panneau Propriétés de connexion.
7. Connectez-vous à nouveau au Portail Azure.
8. Sous Services Azure, sélectionnez Plus de services et recherchez Enregistrements d'application.
9. Sélectionnez votre application. Dans le volet de navigation, cliquez sur Gérer l'authentification.
10. Ajoutez une configuration de plateforme Web et collez l'URL de rappel.
11. (Optionnel) Dans le panneau Propriétés de connexion supplémentaires, sélectionnez Ajouter une propriété et entrez les paramètres pour chaque propriété.
12. Dans le panneau Paramètres avancés, configurez les paramètres, y compris le Type de suivi et d'autres valeurs selon vos besoins.
13. Cliquez sur Enregistrer.
14. Vous serez redirigé vers l'écran de connexion pour vous authentifier. Après vous être connecté, le rappel devrait se compléter avec succès.

Paramètres

Propriétés de connexion

Paramètre	Description
Description	Nom unique pour la connexion. Exemple: MS Dynamics 365 BC
URL de l'organisation	URL pour le point de terminaison API Microsoft Dynamics 365 Business Central. Business Central prend en charge plusieurs points de terminaison : Service commun, Service Web ou API personnalisées. Par défaut, spécifier https://businesscentral.dynamics.com/ se résout en un point de terminaison de production de service commun, sauf si configuré autrement via EndpointType.
Société	Nom de votre entreprise, exactement comme il apparaît dans les paramètres API. Dans le contexte API, cela agit comme un schéma et doit être défini. Exemple: CRONUS International Ltd.
ID de locataire (répertoire)	ID de locataire Azure Active Directory. Trouvé dans l'aperçu de l'enregistrement d'application. Exemple: 72f988bf-86f1-41af-91ab-2d7cd011db47
Mode d'authentification	Mode d'authentification à Business Central : OAuth2 – Flux standard OAuth 2.0. Basique – Authentification nom d'utilisateur/mot de passe (non pris en charge pour la version cloud).
URL de rappel	URL générée automatiquement par DataSync qui doit être ajoutée dans Azure AD.
ID client	ID d'application (client) provenant de l'aperçu de l'enregistrement d'application. Exemple: d4a1b6e2-1234-5678-90ab-9d09c9ebfabc
Secret client	Valeur secrète créée dans Portail Azure. Exemple: P@ssw0rdValue123
Nom d'utilisateur	Nom d'utilisateur du compte utilisé pour l'authentification basique. Exemple: DOMAINE\user1
Clé d'accès	Clé d'accès API générée dans Business Central pour le compte utilisateur spécifié. Exemple: MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC...
Verbosité	1 – Journaliser les requêtes, les comptes de lignes, le début/fin d'exécution, les erreurs. 2 – Inclut le niveau 1 plus les requêtes de cache, les en-têtes HTTP. 3 – Inclut le niveau 2 plus les corps des requêtes/réponses. 4 – Inclut le niveau 3 plus la communication au niveau du transport. 5 – Inclut le niveau 4 plus toutes les commandes d'interface.
Activer le pooling	Option de pooling de connexion pour la performance.
Délai d'inactivité du pool	Temps d'inactivité maximal pour les connexions avant de les renvoyer au pool, en secondes.
Taille maximale du pool	Nombre maximal de connexions autorisées dans le pool.
Délai d'attente du pool	Délai d'attente maximal pour l'allocation de la connexion avant qu'une erreur ne soit générée, en secondes.

Points de terminaison de service commun

Les points de terminaison de service commun donnent accès aux données commerciales fondamentales telles que les comptes, les commandes de vente et les factures.

Environnement	URL
Production	https://api.businesscentral.dynamics.com/v2.0/{nom de l'environnement}/api/v2.0 https://api.businesscentral.dynamics.com/v1.0/api/v2.0 https://api.businesscentral.dynamics.com/v2.0/sandbox/api/v2.0
Test	https://api.businesscentral.dynamics.com/v2.0/{id de locataire}/{nom de l'environnement}/api/v2.0 https://api.businesscentral.dynamics.com/v1.0/{id de locataire}/api/v2.0 https://api.businesscentral.dynamics.com/v2.0/{id de locataire}/sandbox/api/v2.0

remarque

Votre ID de locataire est l'ID du répertoire Azure AD où l'application Business Central est hébergée. Trouvez-le dans Portail Azure. Allez dans Azure Active Directory, puis Aperçu. Les noms d'environnement peuvent être trouvés à :
https://businesscentral.dynamics.com/{id de locataire}/admin

Points de terminaison de service Web

Les points de terminaison de service Web incluent tout ce qui est personnalisé exposé dans Business Central (KPI, rapports, entités ou flux). Pour voir les services Web disponibles, ouvrez Business Central, cliquez sur la loupe et recherchez Services Web.

Environnement	URL
Production	https://api.businesscentral.dynamics.com/v1.0/ODataV4/
Test	https://api.businesscentral.dynamics.com/v1.0/{id de locataire}/ODataV4/

Points de terminaison API personnalisées

Pour se connecter à une API personnalisée, définissez OrganizationUrl sur votre URL de base personnalisée dans le format suivant :
https://api.businesscentral.dynamics.com/v2.0/{locataire}/api/{éditeur API}/{groupe API}/{version API}

Propriétés de connexion supplémentaires

Propriétés de chaîne de connexion supplémentaires non spécifiées dans le panneau Propriétés de connexion. Pour chaque propriété ajoutée, vous pouvez choisir Visible ou Chiffré. La sélection de Chiffré cache la valeur de l'interface et l'enregistre de manière chiffrée dans le back-end, comme lors de la définition de mots de passe.

Propriété	Valeur
EndpointType	Type de point de terminaison auquel se résout OrganizationUrl. Valeurs possibles : CSProduction – Point de terminaison de service commun de production CSTesting – Point de terminaison de service commun de test WSProduction – Point de terminaison de services Web de production WSTesting – Point de terminaison de services Web de test

Paramètres avancés

Les paramètres avancés contrôlent la façon dont le connecteur MS Dynamics 365 BC suit les modifications, gère la configuration régionale et horaire, et traite les lots de données lors de l'extraction. Ces options permettent d'affiner les performances et l'exactitude, et doivent être configurées en fonction de votre environnement système et de vos exigences opérationnelles.

Paramètre	Description
Type de suivi	Méthode pour suivre les changements : Aucun ou Date.
Région	Paramètre de région pour le connecteur, si nécessaire pour votre configuration.
Fuseau horaire	Fuseau horaire correspondant au serveur d'application MS Dynamics 365 BC.
Décalage horaire	Décalage de rafraîchissement en secondes pour compenser les problèmes de chronométrage dans la sélection des enregistrements. La valeur minimale est 0; le maximum est 3600 secondes.
Taille de lot	Quantité d'enregistrements traités dans chaque lot lors de l'extraction. Des tailles de lot plus grandes augmentent l'utilisation de la mémoire mais peuvent améliorer les performances jusqu'à un certain point. La valeur par défaut est 2000 et le maximum ne doit pas dépasser 10000 enregistrements. Ajustez selon la vitesse de votre réseau et la performance de votre disque ; dans la plupart des cas, la valeur par défaut (2000) fonctionne le mieux.

Exemple