Se connecter à Microsoft Dataverse

Remarque

Remarque:
Azure Active Directory s'appelle maintenant Microsoft Entra ID. En savoir plus.

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

Avant de commencer

Vous devez avoir quelques informations prêtes avant de créer la connexion :

• L'URL de l'environnement Dataverse auquel vous souhaitez vous connecter. Si vous utilisez le Configuration de la connexion Dataverse guide de configuration assistée pour créer la connexion, nous trouvons vos environnements pour vous. Vous pouvez également entrer l'URL d'un autre environnement dans votre locataire.
• Le nom d'utilisateur et le mot de passe d'un compte disposant d'autorisations d'administrateur dans Business Central et Dataverse.
• Si vous disposez de Business Central version locale 2020 vague de publication 1, version 16.5, lisez le Problèmes connus article. Effectuez la solution de contournement décrite avant de pouvoir créer votre connexion à Dataverse.
• Les devises locales que chaque compagnie utilise. Les compagnies 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, accédez à Autoriser différentes devises.

Important

Important:
Votre environnement Dataverse ne doit pas être en mode Administration. Le mode Administration entraîne l'échec de la connexion car le compte d'utilisateur d'intégration pour la connexion ne dispose pas d'autorisations d'administrateur. Pour en savoir plus, consultez Mode Administration.

Remarque

Remarque:
Ces étapes décrivent la procédure pour Business Central en ligne. Si vous utilisez Business Central en local et n'utilisez pas un compte Microsoft Entra pour vous connecter à Dataverse, vous devez également spécifier un nom d'utilisateur et un mot de passe d'un compte utilisateur pour l'intégration. Ce compte est appelé compte « d'utilisateur d'intégration ». Si vous utilisez un compte Microsoft Entra, le compte d'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.

Lier vos environnements Business Central et Dataverse

Les entreprises souhaitent protéger leurs données au sein de leur périmètre de confidentialité, surtout lorsque leur application de gestion d'entreprise s'intègre à d'autres applications. Le lien entre les environnements Business Central et Dataverse contribue à atteindre ces objectifs. De plus, vous donnez à vos administrateurs un moyen plus simple de créer et de maintenir vos intégrations avec d'autres applications Dynamics 365.

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

Autoriser différentes devises

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

Remarque

Remarque:
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, accédez à Entité Devise de transaction (currency).

Pour en savoir plus sur les devises dans Business Central, accédez à 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 devise qui se trouve sur la Devises page dans Business Central.
• Il existe au moins un taux de change spécifié pour la devise dans Business Central sur la Taux de change des devises .

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

É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 :

• Si 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.
• Si dans la devise locale Business Central, les montants se synchronisent avec la devise locale Business Central dans l'une des devises supplémentaires non de base dans Dataverse.

Configurer une connexion à Dataverse

Pour tous les types d'authentification autres que l'authentification Microsoft 365, vous configurez votre connexion à Dataverse sur la Configuration de la connexion Dataverse page. Pour l'authentification Microsoft 365, nous vous recommandons d'utiliser le Configuration de la connexion Dataverse guide de configuration assistée. Le guide facilite la configuration de la connexion et vous permet de spécifier des fonctionnalités avancées, telles que le modèle de propriété et la synchronisation initiale.

Important

Important:
Lors de la configuration de la connexion à Dataverse, les administrateurs sont invités à accorder les autorisations suivantes à une application Azure enregistrée nommée Business Central Integration to Dataverse :

• Accéder à Dataverse en votre nom l'autorisation est nécessaire pour que Business Central puisse, au nom de l'administrateur, créer automatiquement un utilisateur d'application Business Central Integration sans licence et non interactif, attribuer des rôles de sécurité à cet utilisateur et déployer la solution Business Central Integration dans Dataverse. Cette autorisation n'est utilisée qu'une seule fois pour configurer la connexion à Dataverse.
• Avoir un accès complet à Dynamics 365 Business Central l'autorisation est nécessaire pour que l'utilisateur d'application Business Central Integration créé automatiquement puisse accéder aux données Business Central qui se synchronisent.
• Se connecter et lire votre profil l'autorisation est nécessaire pour vérifier que l'utilisateur qui se connecte dispose bien du rôle de sécurité Administrateur système attribué dans Dataverse.

En accordant le consentement au nom de l'organisation, l'administrateur autorise l'application Azure enregistrée appelée Business Central Integration to Dataverse à synchroniser les données en utilisant les informations d'identification de l'utilisateur d'application Business Central Integration créé automatiquement.

Pour utiliser le guide de configuration assistée Dataverse Connection Setup

Le guide Dataverse Connection Setup 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 examine les données dans les deux applications et fournit des recommandations sur la façon d'aborder la synchronisation initiale. Le tableau suivant décrit les recommandations.

Recommandation	Description
Synchronisation complète	Les données n'existent que dans Business Central ou uniquement dans Dataverse. La recommandation est de synchroniser toutes les données du service qui les possède vers l'autre service.
Aucune synchronisation	Les données existent dans les deux applications, et l'exécution d'une synchronisation complète dupliquerait les données. La recommandation est de coupler les enregistrements.
Dépendance non satisfaite	Les données existent dans les deux applications, mais la ligne ou la table ne peut pas se synchroniser car elle dépend d'une ligne ou d'une table dont la recommandation est Aucune synchronisation . Par exemple, si les clients ne peuvent pas se synchroniser, les données de contacts qui dépendent des données client ne peuvent pas non plus se synchroniser.

Important

Important:
En général, 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 permet de commencer plus rapidement à travailler avec des données synchronisées. Toutefois, vous ne devez exécuter la synchronisation complète que si vous souhaitez une ligne dans Business Central pour chaque ligne dans Dataverse pour les mappages de tables. Sinon, le résultat peut être des enregistrements en double.

1. Sélectionner Rechercher (Alt+Q) dans le coin supérieur droit, saisissez Configuration assistée, puis choisissez le lien associé.
2. Choisissez Configurer une connexion à Microsoft Dataverse pour démarrer le guide de configuration assistée.
3. Renseignez les champs si nécessaire.

Remarque

Remarque:
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 depuis https://login.microsoftonline.com.

Pour créer ou maintenir la connexion manuellement

La procédure suivante décrit comment configurer la connexion manuellement sur la Configuration de la connexion Dataverse page. La Configuration de la connexion Dataverse page est l'endroit où vous gérez les paramètres d'intégration.

1. Sélectionner Rechercher (Alt+Q) dans le coin supérieur droit, saisissez Configuration de la connexion Dataverse, puis choisissez le lien associé.

2. Entrez les informations suivantes pour la connexion de Business Central à Dataverse.

   Champ	Description
   URL de l'environnement	Si vous possédez des environnements dans Dataverse, nous les trouvons pour vous lorsque vous exécutez le guide de configuration. Si vous souhaitez vous connecter à un environnement différent dans un autre locataire, vous pouvez entrer les informations d'identification de l'administrateur de l'environnement et nous pouvons également le trouver.
   Activé	Commencez à utiliser l'intégration. Si vous n'activez pas la connexion maintenant, les paramètres de connexion sont enregistrés, mais les utilisateurs ne peuvent pas accéder aux données Dataverse depuis Business Central. Vous pouvez revenir à cette page et activer la connexion ultérieurement.

3. Dans la Modèle de propriété champ, choisissez si vous souhaitez qu'une table équipe dans Dataverse possède de nouveaux enregistrements, ou un ou plusieurs utilisateurs spécifiques. Si vous choisissez Personne, vous devez spécifier chaque utilisateur. Si vous choisissez Équipe, l'unité commerciale par défaut s'affiche dans le Unité commerciale couplée champ.

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

   Remarque

   Remarque:
   Si le chiffrement des données n'est pas activé dans Business Central, vous êtes invité à l'activer. Pour activer le chiffrement des données, choisissez Oui et fournissez les informations requises. Sinon, choisissez Non. Vous pouvez activer le chiffrement des données ultérieurement. Pour plus d'informations, consultez Chiffrement des données dans Dynamics 365 Business Central dans l'aide pour les développeurs et les administrateurs.

5. Si la synchronisation Dataverse n'est pas encore configurée, vous êtes invité à utiliser la configuration de synchronisation par défaut. Selon que vous souhaitez garder les enregistrements alignés dans Dataverse et Business Central, choisissez Oui ou de Non.

Personnaliser le couplage basé sur des correspondances

Les administrateurs peuvent entrer des critères pour coupler des enregistrements en fonction de correspondances. Vous pouvez démarrer l'algorithme de mise en correspondance des enregistrements depuis les endroits suivants dans Business Central :

• Pages de liste affichant les enregistrements synchronisés avec Dataverse, telles que les Clients et Articles pages.

  Sélectionnez plusieurs enregistrements, puis choisissez le Connexe action, choisissez Dataverse, choisissez Couplage, puis choisissez Couplage basé sur des correspondances.

  Lorsque vous démarrez le processus de couplage basé sur des correspondances à partir d'une liste de données de référence, un travail de couplage est planifié après que vous avez spécifié les critères de couplage.

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

  Lorsque le processus de synchronisation complète détecte des enregistrements non couplés dans Business Central et Dataverse, un Sélectionner les critères de couplage lien apparaît pour la table d'intégration.

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

  Lorsque vous démarrez le processus de couplage basé sur des correspondances depuis la Révision de synchronisation complète Dataverse page, un travail de couplage est planifié après que vous avez terminé la configuration.

• La Mappages de tables d'intégration liste.

  Sélectionnez un mappage, choisissez le Couplage action, puis choisissez Couplage basé sur des correspondances.

  Lorsque vous démarrez le processus de couplage basé sur des correspondances à partir d'un mappage de table d'intégration, un travail 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 le travail uniquement pour ces enregistrements.

Dans les trois cas, la Sélectionner les critères de couplage page s'ouvre pour vous permettre de définir les critères de couplage appropriés. Sur 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 si vous souhaitez synchroniser après avoir couplé les enregistrements. Si les enregistrements utilisent un mappage bidirectionnel, vous pouvez également spécifier ce qui se passe si des conflits sont répertoriés dans la Résoudre les conflits de mise à jour .

• Définissez la priorité de l'ordre dans lequel les enregistrements sont recherchés en spécifiant une priorité de correspondance pour les champs de mappage concernés. Business Central recherche une correspondance dans l'ordre croissant en fonction de la valeur dans le Priorité de correspondance champ. Une valeur vide dans le Priorité de correspondance champ est équivalente à la priorité 0, qui est la priorité la plus élevée. Les champs avec la priorité 0 sont considérés en premier.

• Spécifiez si vous souhaitez créer une nouvelle instance d'entité dans Dataverse si aucune correspondance unique non couplée ne peut être trouvée à l'aide des critères de correspondance. Pour activer cette capacité, choisissez le Créer si aucune correspondance trouvée action.

Afficher les résultats du travail de couplage

Pour afficher les résultats du travail de couplage, ouvrez la Mappages de tables d'intégration page, sélectionnez le mappage concerné, choisissez le Couplage action, puis choisissez le Journal du travail de couplage d'intégration action.

Si des enregistrements n'ont pas pu être couplés, vous pouvez choisir la valeur dans la Échec colonne pour ouvrir une liste d'erreurs qui expliquent pourquoi.

Si le couplage échoue, c'est généralement pour l'une des raisons suivantes :

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

  Exécutez à nouveau le couplage basé sur des correspondances, mais n'oubliez pas de définir des 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 des champs différents.

• 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 des champs différents.

• 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 des champs différents, ou examinez pourquoi cette entité Dataverse est couplée à l'enregistrement dans Business Central.

Conseil

Conseil:
Pour vous aider à avoir un aperçu de la progression du couplage, le Couplé à Dataverse champ indique si un enregistrement est couplé à une entité Dataverse. Vous pouvez utiliser le Couplé à Dataverse champ pour filtrer la liste des enregistrements que vous synchronisez.

Mettre à niveau les connexions de Business Central en ligne pour utiliser l'authentification basée sur les certificats

Remarque

Remarque:
Cette section s'applique uniquement aux locataires Business Central en ligne hébergés par Microsoft. Les locataires en ligne hébergés par des ISV et les installations locales ne sont pas affectés.

En avril 2022, Dataverse a déprécié le type d'authentification Office365 (nom d'utilisateur/mot de passe). Pour en savoir plus, consultez Dépréciation du type d'authentification Office365. De plus, en mars 2022, Business Central a déprécié l'utilisation de l'authentification de service à service basée sur une clé secrète client pour les locataires en ligne. Vous devez utiliser l'authentification de service à service basée sur les certificats pour les connexions à Dataverse. Les locataires Business Central en ligne hébergés par des ISV et les installations locales peuvent continuer à utiliser des clés secrètes client pour l'authentification.

Pour éviter toute interruption des intégrations, vous devez mettre à niveau la connexion pour utiliser l'authentification basée sur les certificats. Les étapes suivantes décrivent comment effectuer la mise à niveau vers l'authentification basée sur les certificats.

Pour mettre à niveau votre connexion Business Central en ligne afin d'utiliser l'authentification basée sur les certificats

1. Selon que vous effectuez une intégration avec Dynamics 365 Sales, effectuez l'une des opérations suivantes :
   • Si vous le faites, ouvrez la Configuration de la connexion Microsoft Dynamics 365 .
   • Si vous ne le faites pas, ouvrez la 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 les certificats.
3. Connectez-vous avec des informations d'identification d'administrateur pour Dataverse. La connexion devrait prendre moins d'une minute.

Remarque

Remarque:
Vous devez répéter ces étapes dans chaque environnement Business Central, y compris les environnements de production et les environnements sandbox, et dans chaque compagnie où vous avez une connexion à Dataverse.

Connexion des versions locales

Pour connecter Business Central en local à Dataverse, vous devez spécifier certaines informations sur la 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 devez fournir l'ID d'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 en savoir plus, consultez 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 modifier l'URL. La clé secrète client est enregistrée sous forme de chaîne chiffré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 en savoir plus sur l'enregistrement d'une application dans Microsoft Entra ID, accédez à Démarrage rapide : Inscrire une application auprès de la plateforme d'identités Microsoft.

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

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

3. Sous Gérer, choisissez Autorisations API.

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

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

   Remarque

   Remarque:
   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 utilisez le secret soit dans Business Central, dans le Clé secrète client champ sur la Configuration de la connexion Dataverse page, soit stockez-le dans un stockage sécurisé et fournissez-le dans un abonné aux événements comme décrit précédemment dans cet article.

6. Choisissez Vue d'ensemble, puis recherchez le ID d'application (client) valeur. Cet ID est l'ID client de votre application. Vous devez l'entrer soit sur la Configuration de la connexion Dataverse page dans le ID client champ, soit le stocker dans un stockage sécurisé et le fournir dans un abonné aux événements.

7. Dans Business Central, sur la Configuration de la connexion Dataverse , dans la vue URL de l'environnement champ, entrez l'URL de votre environnement Dataverse.

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

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). Après vous être connecté, vous serez invité à autoriser votre application enregistrée à se connecter à Dataverse au nom de l'organisation. Vous devez donner votre consentement pour terminer la configuration.

   Remarque

   Remarque:
   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 depuis https://login.microsoftonline.com.

Pour se déconnecter de Dataverse

1. Sélectionner Rechercher (Alt+Q) dans le coin supérieur droit, saisissez Configuration de la connexion Dataverse, puis choisissez le lien associé.
2. Sur l' Configuration de la connexion Dataverse page, désactivez le Activé bouton bascule.

Informations connexes

Afficher l'état d'une synchronisation

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