Se connecter à Microsoft Dataverse

Notes

Azure Active Directory est désormais Microsoft Entra ID. En savoir plus

Cet article décrit comment configurer une connexion entre Business Central et Dataverse. En règle générale, les entreprises créent la connexion pour intégrer et synchroniser des données avec une autre application métier Dynamics 365 telle que Dynamics 365 Sales.

Avant de commencer

Avant de créer la connexion, quelques informations doivent être préparées :

• L’URL pour l’environnement Dataverse auquel vous souhaitez vous connecter. Si vous utilisez le guide de configuration assistée Configuration de la connexion Dataverse pour créer la connexion, nous trouverons vos environnements. Vous pouvez également entrer l’URL d’un autre environnement dans votre abonné.
• Le nom d’utilisateur et le mot de passe d’un compte ayant les autorisations administrateur dans Business Central et Dataverse.
• Si vous avez une vague de lancement 1 de 2020 Business Central sur site, version 16.5, lisez l’article Quelques problèmes connus. Vous devrez effectuer la solution de contournement décrite avant de pouvoir créer votre connexion à Dataverse.
• Les devises locales utilisées par chaque entreprise. Les entreprises Business Central peuvent se connecter à un environnement Dataverse dont la devise de base est différente de leur devise locale. Pour en savoir plus sur la gestion des configurations multidevises, consultez Autoriser différentes devises.

Important

Votre environnement Dataverse ne doit pas être en mode Administration. Le mode Administration entraînera l’échec de la connexion car le compte d’utilisateur d’intégration pour la connexion ne dispose pas des autorisations d’administrateur. Pour plus d’informations, voir Mode Administration.

Notes

Ces étapes décrivent la procédure pour la version en ligne de Business Central. Si vous utilisez Business Central sur site et que vous n’utilisez pas de compte Microsoft Entra pour vous connecter à Dataverse, vous devez également spécifier un nom d’utilisateur et un mot de passe d’un compte d’utilisateur pour l’intégration. Ce compte est appelé le compte « d’utilisateur d’intégration ». Si vous utilisez un compte Microsoft Entra, le compte utilisateur d’intégration n’est pas requis ni affiché. L’utilisateur d’intégration sera configuré automatiquement et ne nécessite pas de licence.

Reliez votre Business Central et Dataverse environnements

Les entreprises souhaitent protéger leurs données dans les limites de leur confidentialité, en particulier lorsque leur application de gestion d’entreprise s’intègre à d’autres applications. En reliant les environnements Business Central et Dataverse , non seulement vous atteindrez ces objectifs, mais vous offrirez également à vos administrateurs un moyen plus simple de créer et de maintenir vos intégrations avec d’autres applications Dynamics 365.

Dans le Business Central centre d’administration, vous pouvez lier votre Business Central environnement à votre Dataverse environnement. Business Central peut utiliser les informations du lien pour faciliter et sécuriser l’intégration à d’autres applications Dynamics 365, telles que Sales et Field Service. Par exemple, l’URL de l’environnement Dataverse liée est disponible par défaut sur la page Dataverse Configuration de la connexion et lorsque vous exécutez la Dataverse Connexion Guide de configuration assistée pour la configuration.

Autoriser différentes devises

Les entreprises Business Central peuvent se connecter à un environnement Dataverse dont la devise de base est différente de leur devise locale.

Notes

La synchronisation de plusieurs devises nécessite que vous utilisiez une synchronisation unidirectionnelle, de Business Central vers Dataverse.

Pour en savoir plus sur la devise de base dans Dataverse, consultez Entité de devise de transaction (devise).

Pour en savoir plus sur les devises dans Business Central, consultez Devises dans Business Central.

Pour autoriser différentes devises, avant de vous connecter, assurez-vous d’avoir spécifié les paramètres suivants :

• Le paramètre de devise de transaction de base dans Dataverse a le code de devise spécifié sur la page Devises dans Business Central.
• Au moins un taux de change est spécifié pour la devise dans Business Central sur la page Taux de change devise.

Lorsque vous activez la connexion à Dataverse, Business Central ajoute sa devise locale à l’entité Devise dans Dataverse. La devise locale utilise le taux de change du champ Facteur devise dans la page Taux de change devise.

Étant donné que la synchronisation des devises est unidirectionnelle, de Business Central vers Dataverse, les montants monétaires sont convertis et synchronisés comme suit :

• Dans la devise de base Dataverse, les montants sont convertis dans la devise locale Business Central en fonction du dernier taux de change synchronisé depuis Business Central.
• Dans la devise locale Business Central, les montants sont synchronisés avec la devise locale Business Central dans l’une des devises supplémentaires hors base dans Dataverse.

Configurer une connexion à Dataverse

Pour tous les types d’authentification autres que l’authentification Microsoft 365, configurez votre connexion à Dataverse sur la page Configuration de la connexion Dataverse. Pour l’authentification Microsoft 365, il est recommandé d’utiliser le guide de configuration assistée Paramétrage de la connexion Dataverse. Le guide facilite la configuration de la connexion et spécifie les fonctions avancées telles que le modèle de propriété et la synchronisation initiale.

Important

Pendant la configuration de la connexion à Dataverse, l’administrateur sera invité à accorder les autorisations suivantes à l’application Azure enregistrée nommée Business Central Intégration à Dataverse :

• Accédez à Dataverse étant donné que votre autorisation est nécessaire afin que Business Central puisse, au nom de l’administrateur, créer automatiquement un utilisateur d’application d’intégration Business Central sans licence non interactive, attribuer des rôles de sécurité à cet utilisateur et déployer Business Central la solution d’intégration à Dataverse. Cette autorisation n’est utilisée qu’une seule fois pendant la configuration de la connexion à Dataverse.
• Avoir un accès complet à Dynamics 365 Business Central une autorisation est nécessaire donc Business Central l’utilisateur d’application d’intégration créé automatiquement peut accéder aux données Business Central qui seront synchronisées.
• Une autorisation Connectez-vous et lisez votre profil est nécessaire pour vérifier que l’utilisateur qui se connecte a bien le rôle de sécurité Administrateur système affecté dans Dataverse.

En donnant son consentement au nom de l’organisation, l’administrateur autorise l’application Azure enregistrée appelée Business Central Intégration à Dataverse à synchroniser les données en utilisant les informations d’identification de l’utilisateur d’application d’intégration Business Central automatiquement créé.

Pour utiliser le guide de configuration assistée Paramétrage de la connexion Dataverse

Le guide de configuration de connexion Dataverse peut faciliter la connexion des applications et peut même vous aider à exécuter une synchronisation initiale. Si vous choisissez d’exécuter la synchronisation initiale, Business Central examinera les données des deux applications et fournira des recommandations sur la manière d’aborder la synchronisation initiale. Le tableau suivant décrit les recommandations.

Recommandation	Description
Synchronisation complète	Les données existent uniquement dans Business Central, ou seulement dans Dataverse. La recommandation consiste à synchroniser toutes les données du service vers l’autre service.
Aucune synchronisation	Les données existent dans les deux applications et une synchronisation complète dupliquerait les données. La recommandation consiste à coupler les enregistrements.
Dépendance non satisfaite	Les données existent dans les deux applications, mais la ligne ou la table ne peut pas être synchronisée, car elle dépend d’une ligne ou d’une table qui a la recommandation Aucune synchronisation. Par exemple, si les clients ne peuvent pas être synchronisés, les données des contacts qui dépendent des données client ne peuvent pas non plus être synchronisées.

Important

En règle générale, vous n’utilisez la synchronisation complète que lorsque vous intégrez les applications pour la première fois et qu’une seule application contient des données. La synchronisation complète peut être utile dans un environnement de démonstration, car elle crée et couple automatiquement des enregistrements dans chaque application, ce qui accélère le travail avec des données synchronisées. Cependant, vous devez exécuter une synchronisation complète uniquement si vous souhaitez une ligne dans Business Central pour chaque ligne dans Dataverse pour les mappages de table donnés. Sinon, le résultat peut être des enregistrements en double.

1. Sélectionnez l’icône saisissez Configuration assistée, puis choisissez le lien associé.
2. Sélectionnez Configurer la connexion à Microsoft Dataverse pour lancer le guide de configuration assistée.
3. Renseignez les champs selon vos besoins.

Notes

Si vous n’êtes pas invité à vous connecter avec votre compte administrateur, c’est probablement parce que les fenêtres contextuelles sont bloquées. Pour vous connecter, autorisez les fenêtres contextuelles de https://login.microsoftonline.com.

Pour créer ou conserver manuellement la connexion

La procédure suivante décrit comment configurer manuellement la connexion sur la page Paramétrage de la connexion Dataverse. C’est sur la page Configuration de la connexion Dataverse que vous gérez les paramètres d’intégration.

1. Sélectionnez saisissez Configuration de la connexion Dataverse, puis choisissez le lien associé.

2. Saisissez les informations suivantes pour la connexion de Dataverse vers Business Central.

   Champ	Description
   URL Environnement	Si vous possédez des environnements dans Dataverse, nous les trouverons lorsque vous exécuterez le guide de configuration. Si vous souhaitez vous connecter à un autre environnement dans un autre abonné, vous pouvez saisir les informations d’identification administrateur pour l’environnement et nous les trouverons.
   Activé	Commencez avec l’intégration. Si vous n’activez pas la connexion tout de suite, les paramètres de connexion seront sauvegardés, mais les utilisateurs ne seront pas en mesure d’accéder aux données Dataverse à partir de Business Central. Vous pouvez revenir sur cette page et activer la connexion ultérieurement.

3. Dans le champ Modèle de propriété, choisissez si vous souhaitez une table Équipe dans Dataverse pour posséder de nouveaux enregistrements, ou un ou plusieurs utilisateurs spécifiques. Si vous choisissez Personne, vous devez indiquer chaque utilisateur. Si vous choisissez Équipe, le centre de profit par défaut s’affiche dans le champ Centre de profit couplé.

4. Pour tester les paramètres de connexion, choisissez Connexion, puis Tester la connexion.

   Notes

   Si le chiffrement des données n’est pas activé dans Business Central, vous recevrez un message vous demandant si vous souhaitez l’activer. Pour activer le chiffrement des données, cliquez sur Oui et fournissez les informations requises. Sinon, sélectionnez Non. Vous pouvez activer le chiffrement des données ultérieurement. Pour plus d’informations, voir Chiffrement des données dans Dynamics 365 Business Central de l’aide sur Developer and Administration.

5. Si la synchronisation de Dataverse n’est pas déjà configurée, vous recevrez un message vous demandant si vous souhaitez utiliser les paramètres de synchronisation par défaut. Selon que vous souhaitez conserver ou non les enregistrements alignés dans Dataverse et Business Central, sélectionnez Oui ou Non.

Personnaliser le couplage par correspondance

À partir de la 2e vague de lancement de 2021, un administrateur peut saisir des critères pour coupler des enregistrements en fonction de correspondances. Vous pouvez lancer l’algorithme de correspondance des enregistrements à partir des emplacements suivants dans Business Central :

• Les pages de liste qui affichent les enregistrements synchronisés avec Dataverse, telles que les pages Clients et Articles.

  Sélectionnez plusieurs enregistrements, puis choisissez l’action Associé, choisissez Dataverse, choisissez Couplage, puis choisissez Couplage par correspondance.

  Lorsque vous démarrez le processus de couplage par correspondance à partir d’une liste de données de base, une tâche de couplage est planifiée directement après que vous ayez spécifié les critères de couplage.

• La page Révision synchronisation complète Dataverse.

  Lorsque le processus de synchronisation complet détecte que vous avez des enregistrements découplés à la fois dans Business Central et Dataverse, un lien Sélectionner les critères de couplage apparaît pour la table d’intégration.

  Vous pouvez lancer le processus Exécuter la synchronisation complète depuis les pages Configuration de la connexion Dataverse et Configuration de la connexion Dynamics 365. Vous pouvez également le lancer dans le guide de configuration assistée Configurer une connexion à Dataverse lorsque vous avez terminé votre configuration.

  Lorsque vous lancez le processus de couplage par correspondance à partir de la page Révision synchronisation complète Dataverse, une tâche de couplage est planifiée après que vous ayez terminé la configuration.

• La liste Mappages de table d’intégration.

  Sélectionnez un mappage, choisissez l’action Couplage, puis choisissez Couplage par correspondance.

  Lorsque vous lancez le processus de couplage par correspondance à partir du mappage d’une table d’intégration, une tâche de couplage s’exécute pour tous les enregistrements non couplés dans le mappage. Vous pouvez également sélectionner des enregistrements non couplés dans la liste pour exécuter la tâche uniquement pour ces enregistrements.

Dans les trois cas, la page Sélectionner les critères de couplage s’ouvre pour vous permettre de définir les critères de couplage pertinents. Dans cette page, personnalisez le couplage avec les tâches suivantes :

• Choisissez les champs à utiliser pour faire correspondre les enregistrements Business Central avec les entités Dataverse. Vous pouvez spécifier si la correspondance est sensible à la casse.

• Spécifiez s’il faut synchroniser après avoir couplé des enregistrements. Si les enregistrements utilisent le mappage bidirectionnel, vous pouvez également spécifier ce qui se produit si des conflits sont répertoriés sur la page Résoudre les conflits de mise à jour.

• Hiérarchisez l’ordre de recherche des enregistrements en spécifiant une priorité de correspondance pour les champs de mappage pertinents. Business Central recherchera une correspondance dans l’ordre croissant en fonction de la valeur du champ Priorité de correspondance. Une valeur vide dans le champ Priorité de correspondance est égale à la priorité 0, qui est la priorité la plus élevée. Les champs avec la priorité 0 sont pris en compte en premier.

• Spécifiez s’il faut créer une nouvelle instance d’entité dans Dataverse au cas où aucune correspondance non couplée unique ne peut être trouvée en utilisant les critères de correspondance. Pour activer cette fonctionnalité, choisissez l’action Créer si impossible de trouver une correspondance.

Voir les résultats de la tâche de couplage

Pour afficher les résultats de la tâche de couplage, ouvrez la page Mappages de table d’intégration, sélectionnez le mappage pertinent, choisissez l’action Couplage, puis choisissez l’action Journal des tâches de couplage d’intégration.

Si les enregistrements n’ont pas pu être couplés, vous pouvez choisir la valeur de la colonne Échec pour ouvrir une liste d’erreurs décrivant pourquoi cela s’est produit.

En général, le couplage échoue pour les raisons suivantes :

• Aucun critère de correspondance n’a été défini

  Exécutez à nouveau le couplage par correspondance, mais n’oubliez pas de définir les critères de couplage.

• Aucune correspondance n’a été trouvée pour les champs spécifiés dans les critères de correspondance

  Répétez le couplage en utilisant différents champs.

• Plusieurs correspondances ont été trouvées pour plusieurs enregistrements en fonction des champs spécifiés dans les critères de correspondance

  Répétez le couplage en utilisant différents champs.

• Une correspondance a été trouvée, mais l’enregistrement est déjà couplé à un enregistrement dans Business Central

  Répétez le couplage en utilisant différents champs ou recherchez pourquoi cette entité Dataverse est couplée à l’enregistrement dans Business Central.

Conseil

Pour vous aider à avoir une vue d’ensemble de la progression du couplage, le champ Couplé à Dataverse indique si un enregistrement est couplé à une entité Dataverse . Vous pouvez utiliser le champ Couplé à Dataverse pour filtrer la liste des enregistrements que vous synchronisez.

Mettre à niveau les connexions de Business Central Online pour utiliser l’authentification basée sur les certificats

Notes

Cette section s’applique uniquement aux locataires Business Central en ligne hébergés par Microsoft. Les locataires en ligne hébergés par les développeurs de logiciels indépendants et les installations locales ne sont pas affectés.

En avril 2022, Dataverse abandonne le type d’authentification Office365 (nom d’utilisateur/mot de passe). Pour en savoir plus, voir Abandon du type d’authentification Office365. De plus, en mars 2022, Business Central abandonne l’utilisation de l’authentification de service à service basée sur le secret client pour les abonnés en ligne. Vous devez utiliser l’authentification de service à service basée sur un certificat pour les connexions à Dataverse. Les abonnés Business Central Online hébergés par les éditeurs de logiciels indépendants et les installations sur site peuvent continuer à utiliser l’authentification basée sur le secret client pour l’authentification.

Pour éviter de perturber les intégrations, vous devez mettre à niveau la connexion pour utiliser l’authentification par certificat. Bien que le changement soit prévu pour mars 2022, nous vous recommandons fortement de mettre à niveau dès que possible. Les étapes suivantes décrivent comment effectuer une mise à niveau vers l’authentification par certificat.

Pour mettre à niveau votre connexion de Business Central Online pour utiliser l’authentification basée sur les certificats

1. Selon que vous intégrez ou non à Dynamics 365 Sales, effectuez l’une des opérations suivantes :
   • Si vous le faites, ouvrez la page Configuration de la connexion Microsoft Dynamics 365.
   • Si vous ne le faites pas, ouvrez la page Configuration de la connexion Dataverse.
2. Choisissez Connexion, puis Utiliser l’authentification par certificat pour mettre à niveau la connexion afin d’utiliser l’authentification basée sur un certificat.
3. Connectez-vous avec les informations d’identification d’administrateur pour Dataverse. La connexion doit prendre moins d’une minute.

Notes

Vous devez répéter ces étapes dans chaque environnement Business Central, y compris les environnements de production et de bac à sable, et dans chaque entreprise où vous êtes connecté à Dataverse.

Connexion des versions locales

Pour connecter Business Central sur site à Dataverse, vous devez spécifier quelques informations sur la page Configuration de la connexion Dataverse.

Pour vous connecter à l’aide d’un compte Microsoft Entra, vous devez enregistrer une application dans Microsoft Entra ID. Vous devrez fournir l’ID de l’application, le secret du coffre de clés et l’URL de redirection à utiliser. L’URL de redirection est pré-remplie et devrait fonctionner pour la plupart des installations. Vous devez configurer votre installation pour utiliser HTTPS. Pour plus d’informations, voir Configuration de SSL pour sécuriser la connexion du client Web Business Central. Si vous configurez votre serveur pour avoir une page d’accueil différente, vous pouvez changer l’URL. Le secret client sera enregistré sous forme de chaîne cryptée dans votre base de données.

Pour enregistrer une application dans Microsoft Entra ID pour la connexion de Business Central à Dataverse

Les étapes suivantes supposent que vous utilisez Microsoft Entra ID pour gérer les identités et les accès. Pour plus d’informations sur l’enregistrement d’une application dans Microsoft Entra ID, voir Démarrage rapide : enregistrer une application avec la plateforme d’identité Microsoft.

1. Dans le portail Azure, sous Gérer dans le volet de navigation, choisissez Authentification.

2. Sous Rediriger les URL, ajoutez l’URL de redirection suggérée sur la page de Configuration de la connexion Dataverse dans Business Central.

3. Sous Gérer, choisissez Autorisations d’API.

4. Sous Autorisations configurées, choisissez Ajouter une autorisation, puis ajoutez des autorisations déléguées sur l’onglet API Microsoft comme suit :

   • Pour Business Central, ajoutez les autorisations Financials.ReadWrite.All.
   • Pour Dynamics CRM, ajoutez les autorisations user_impersonation.

   Notes

   Le nom de l’API Dynamics CRM peut changer.

5. Sous Gérer, choisissez Certificats et secrets, puis créez un nouveau secret pour votre application. Vous utiliserez le secret soit dans Business Central, dans le champ Secret client sur la page Configuration de la connexion Dataverse ou stockez-le dans un stockage sécurisé et fournissez-le dans un souscripteur d’événements, comme décrit précédemment dans cette rubrique.

6. Choisissez Aperçu, puis recherchez la valeur ID application (client). Cet ID est l’ID client de votre application. Vous devez le saisir soit sur la page Configuration de la connexion Dataverse dans le champ ID client ou stockez-le dans un stockage sécurisé et fournissez-le à un souscripteur d’événements.

7. Dans Business Central, sur la page Configuration de la connexion Dataverse, dans le champ URL Environnement, saisissez l’URL de votre environnement Dataverse.

8. Pour activer la connexion à Dataverse, activez le bouton bascule Activé.

9. Connectez-vous avec votre compte administrateur pour Microsoft Entra ID (ce compte doit avoir une licence valide pour Dataverse et être administrateur dans votre environnement Dataverse). Une fois connecté, vous serez invité à autoriser votre application enregistrée à se connecter à Dataverse au nom de l’organisation. Vous devez donner votre accord pour terminer la configuration.

   Notes

   Si vous n’êtes pas invité à vous connecter avec votre compte administrateur, c’est probablement parce que les fenêtres contextuelles sont bloquées. Pour vous connecter, autorisez les fenêtres contextuelles de https://login.microsoftonline.com.

Pour se déconnecter de Dataverse

1. Sélectionnez l’icône saisissez Configuration de la connexion Dataverse, puis choisissez le lien associé.
2. Sur la page Paramétrage de la connexion Dataverse, désactivez le bouton bascule Activé.

Voir aussi

Afficher le statut d’une synchronisation

Trouvez des modules d’apprentissage en ligne gratuits pour Business Central ici