Aller au contenu

Accès à Business Central pour Data Foundation

Data Foundation rassemble les données de chaque système ERP et de chaque instance que vous connectez dans un seul Common Finance Model, et Microsoft Dynamics 365 Business Central fait partie des ERP qu’il lit directement. La connexion repose sur une application Microsoft Entra ID avec des identifiants client, un jeu d’autorisations en lecture seule et quelques objets de page publiés comme services web. Cette page s’adresse à l’administrateur Business Central qui effectue cette configuration, et à l’utilisateur PlaidCloud qui la lui demande.

PlaidCloud lit uniquement les données. Personne n’envoie de secret client par e-mail.

Dans l’onglet Foundation du projet, choisissez Créer une nouvelle connexion sous Connexion Business Central. Le formulaire affiche la demande complète. Cliquez sur Copier la demande pour la coller dans votre propre message, ou sur Envoyer la demande par e-mail pour l’ouvrir dans votre messagerie avec l’objet « Read-only Business Central access for PlaidCloud (Microsoft Entra ID, client credentials). »

Ce que l’administrateur Business Central configure

Section intitulée « Ce que l’administrateur Business Central configure »
  1. Enregistrez une application dans Microsoft Entra ID. Sous App registrations > New registration, ajoutez un secret client, puis notez l’ID de répertoire (locataire), l’ID d’application (client) et le secret.

  2. Ajoutez l’application dans Business Central. Ouvrez Microsoft Entra Applications, ajoutez l’application, définissez son état sur Activé, puis attribuez-lui les jeux d’autorisations D365 READ et D365 BASIC pour chaque société sur laquelle vous produisez des rapports. Ne lui attribuez aucun jeu d’autorisations en écriture.

  3. Publiez des objets de page comme services web. Sous Search > Web Services > New, publiez ces objets de page avec exactement ces noms de service, en cochant Published. L’API standard ne contient pas leurs champs :

    Page Nom du service Remarques
    20 G/L Entries GLEntries
    16 Chart of Accounts GLAccounts
    100 Accounting Periods AccountingPeriods
    537 Dimension Values DimensionValues
    240 Business Units BusinessUnits
    605 IC Partner List ICPartners
    5802 Value Entries ValueEntries Coût des marchandises vendues ; facultatif
    120 G/L Budget Entries GLBudgetEntries Budgets ; facultatif
    Statistical Ledger Entries StatisticalLedgerEntries Inducteurs statistiques ; facultatif
    118 General Ledger Setup GeneralLedgerSetup Dimensions raccourcies 3 à 8 ; facultatif
    479 Dimension Set Entries DimensionSetEntries Dimensions raccourcies 3 à 8 ; facultatif
  4. Communiquez deux choix à l’utilisateur PlaidCloud : le code source sous lequel vos écritures d’ajustement d’audit sont comptabilisées (PlaidCloud suppose ADJUSTMENT), et la dimension qui correspond à votre département (PlaidCloud suppose Global Dimension 1, nommée DEPARTMENT).

L’administrateur envoie Saisi dans PlaidCloud comme
L’ID de répertoire (locataire) Directory (tenant) ID
Le nom de l’environnement, par exemple production Nom de l’environnement
L’ID d’application (client) Application (client) ID
Le secret client Secret client, saisi dans le formulaire, pas par e-mail
Le nom de la dimension qui correspond à votre département Le paramètre système department_dimension
Les sociétés que PlaidCloud peut lire Sélectionnées sous Companies dans PlaidCloud (au moins une)

Les sociétés de consolidation se déclarent dans le paramètre système consolidation_companies, afin que leurs écritures ne soient pas comptées comme l’activité d’une société. Les taux de change proviennent d’une seule société : indiquez-la dans le paramètre système rate_company, sinon PlaidCloud utilise la première société.

De retour dans PlaidCloud, saisissez les valeurs, puis cliquez sur Tester la connexion. Chaque jeu de données s’affiche comme Lisible, Autorisation manquante ou Erreur :

Jeu de données Ce dont il a besoin
Entités, Plan comptable, Clients, Produits, Taux de change, Balance de vérification Accès à l’API (jeu d’autorisations D365 READ)
Calendrier fiscal Le service web AccountingPeriods
Départements Le service web DimensionValues
Grand livre Le service web GLEntries
Lignes de vente, Budget, Inducteurs d’allocation Facultatif

Lorsqu’un jeu de données est manquant, le test indique l’autorisation ou le service web à ajouter. Demandez à l’administrateur de l’ajouter, puis testez à nouveau. Les lignes de vente, le budget et les inducteurs d’allocation sont facultatifs : un environnement qui ne les utilise pas charge tout le reste.