Se connecter à Microsoft Dataverse

Remarque

Azure Active Directory est maintenant Microsoft Entra ID. Apprendre encore 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 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 local, 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 Connecter vers un Dataverse environnement dont la devise de base est différente de leur devise société. Pour en savoir plus sur la gestion des configurations multidevises, accédez à 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.

Remarque

Ces étapes décrivent la procédure pour Business Central Online. Si vous utilisez Business Central sur site et n’utilisez pas de Microsoft Entra compte pour 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 Business Central et les environnements, vous atteindrez non seulement ces objectifs, mais vous offrirez également à vos administrateurs un moyen plus simple de créer et de gérer vos intégrations avec d’autres applications Dynamics 365. Dataverse

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 avec d’autres applications Dynamics 365, telles que Sales et Field Service. Par exemple, l’URL liée Dataverse environnement est disponible par défaut sur la page Dataverse Configuration de la connexion et lorsque vous exécutez la configuration assistée Dataverse Configuration de la connexion guide.

Autoriser différentes devises

Les entreprises Business Central peuvent Connecter vers un Dataverse environnement dont la devise de base est différente de leur devise société.

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 (devise).

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 de devise spécifié sur la page Devises dans Business Central.
• Il existe au moins un taux de change spécifié pour la devise dans Business Central sur la page Taux de change des devises .

Lorsque vous activez la connexion à Dataverse, Business Central ajoute son devise société à l’entité Devise dans Dataverse. Le devise société utilise le taux de change du champ Facteur de devise sur la page Taux de change des devises .

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

• Si dans la devise de base, les montants sont convertis dans le taux de change devise société de Business Central en fonction du dernier taux de change synchronisé depuis Business Central. Dataverse
• Si dans le Business Central devise société, les montants se synchronisent avec le Business Central devise société dans l’une des devises supplémentaires non de base dans Dataverse.

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

• L’autorisation d’accès Dataverse en tant que est nécessaire pour que Business Central puisse, au nom de l’administrateur, créer automatiquement un utilisateur d’application d’intégration Business Central non interactif et sans licence, attribuer des rôles de sécurité à cet utilisateur et déployer la solution d’intégration Business Central sur 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 l’autorisation est nécessaire pour que l’utilisateur de l’application d’intégration Business Central créée automatiquement puisse accéder aux données Business Central qui seront synchronisées.
• connectez-vous et lisez votre profil une autorisation est nécessaire pour vérifier que l’utilisateur qui se connecte dispose réellement du rôle de sécurité Administrateur système attribué dans Dataverse.

En donnant son consentement au nom de l’organisation, l’administrateur autorise l’application Azure enregistrée appelée Intégration Business Central à 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 uniquement dans Dataverse. La recommandation consiste à synchroniser toutes les données du service vers l’autre service.
Pas de 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. Choisissez l’icône , entrez 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.

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 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. Choisissez l’icône , entrez Dataverse Configuration de la connexion, puis choisissez le lien associé.

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

   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.

   Remarque

   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.

Pourboire

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

Remarque

Cette section s’applique uniquement aux locataires Business Central Online 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.

Remarque

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 local à 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, consultez Démarrage rapide : Enregistrer une application auprès de 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 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.

   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 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 Dataverse environnement). 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.

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

Pour se déconnecter de Dataverse

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

Voir aussi

Afficher l’état d’une synchronisation

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