Aller au contenu principal

Prérequis pour DYCE API Connector for Dataverse

Attention

La connexion Microsoft Dataverse standard ne doit pas être activée lors de l'utilisation de DYCE API Connector for Dataverse. L'activation des deux peut entraîner des doublons de données et des conflits de synchronisation.

Avant d'installer DYCE API Connector for Dataverse, vérifiez que les conditions suivantes sont remplies :

  • Accès administrateur à Microsoft Entra ID (anciennement Azure AD)
  • Une souscription Azure active
  • Droits d'administration dans Business Central
  • Accès à l'environnement Dataverse/Dynamics 365 Sales
  • Coordination avec wysa pour le déploiement de SalesCentral et de DataBridge

Le processus de configuration comprend trois composants principaux :

  1. DYCE API Connector for Dataverse - L'application AppSource qui fournit les pages API dans Business Central
  2. SalesCentral - La solution de vente de wysa pour l'harmonisation des processus
  3. DataBridge - Le moteur de mappage et de synchronisation hébergé dans Azure

La configuration de SalesCentral et de DataBridge est décrite dans DataBridge et SalesCentral.

Inscription d'application dans Microsoft Entra ID​

Pour permettre une communication sécurisée entre Business Central et Dataverse, deux inscriptions d'application doivent être créées dans Microsoft Entra ID.

Inscription d'application Business Central​

  1. Accédez à Portail Azure > Microsoft Entra ID > Inscriptions d'applications
  2. Cliquez sur Nouvelle inscription pour créer une nouvelle inscription d'application
  3. Configurez les autorisations d'API suivantes :
    • Business Central API.ReadWrite.All (nécessite le consentement administrateur)
    • Business Central Automation.ReadWrite.All (nécessite le consentement administrateur)
    • User.Read (autorisation déléguée)
  4. Un administrateur doit accorder le consentement pour les autorisations Business Central
  5. Notez l'ID d'application (client) pour la configuration dans Business Central

Inscription d'application Dataverse/Sales​

  1. Créez une deuxième inscription d'application selon la même procédure que ci-dessus
  2. Configurez l'autorisation d'API suivante :
    • User.Read (autorisation déléguée)
  3. Notez l'ID d'application (client) pour la configuration dans SalesCentral

Pour générer une clé secrète client pour l'une ou l'autre des inscriptions d'application :

  1. Accédez à Portail Azure > Microsoft Entra ID > Inscriptions d'applications.
  2. Sélectionnez l'inscription d'application pour laquelle la clé secrète doit être créée.
  3. Accédez à Certificats & secrets > Secrets client.
  4. Cliquez sur Nouveau secret client.
  5. Ajoutez une description et choisissez une durée d'expiration, puis cliquez sur Ajouter.
  6. Copiez immédiatement la Valeur de la clé secrète. C'est la seule fois où elle peut être affichée. Conservez-la en lieu sûr, car elle est nécessaire pour configurer la connexion entre Business Central et Dataverse/SalesCentral.