Logo Sparkrock

Génération de rapports Power BI pour afficher les données Dynamics 365 Business Central

Vous pouvez rendre vos données Dynamics 365 Business Central disponibles en tant que source de données dans Power BI Desktop et créer des rapports puissants sur l’état de votre entreprise.

Cet article explique comment commencer à utiliser Power BI Desktop pour créer des rapports affichant des données Dynamics 365 Business Central. Après avoir créé des rapports, vous pouvez les publier dans votre service Power BI ou les partager avec tous les utilisateurs de votre organisation. Lorsque les rapports sont dans le service Power BI, les utilisateurs qui y ont accès peuvent les consulter dans Dynamics 365 Business Central.

Préparez-vous

Remarque

Remarque:
Vous pouviez obtenir des données de plusieurs compagnies dans un seul rapport avec des services web OData. Toutefois, à partir de Business Central 2021 version vague 2, seul ODataV4 est pris en charge. ODataV4 n’exporte pas les données de plusieurs compagnies. La $expand fonction de Power BI que vous pourriez croire être une autre façon de créer un rapport multi-compagnies ne peut pas non plus être utilisée. Elle crée une colonne avec le nom de la compagnie, mais ne la remplit pas avec les données de la compagnie après une actualisation.

Ajouter Business Central comme source de données dans Power BI Desktop

La première tâche lors de la création de rapports consiste à ajouter Business Central comme source de données dans Power BI Desktop. Une fois connecté, vous pouvez commencer à créer le rapport.

  1. Démarrez Power BI Desktop.

  2. Sélectionner Obtenir les données.

    Si vous ne voyez pas Obtenir les données, sélectionnez le Fichier menu, puis Obtenir les données.

  3. Sur l' Obtenir les données page, sélectionnez Services en ligne.

  4. Dans la Services en ligne volet, effectuez l’une des étapes suivantes :

    • Pour vous connecter à Business Central en ligne, sélectionnez Dynamics 365 Business Central, puis Connecter.

  5. Connectez-vous à Business Central (une seule fois).

    Si vous n’êtes pas connecté à Business Central depuis Power BI Desktop, vous êtes invité à vous connecter.

    • Pour Business Central en ligne, sélectionnez Connexion, puis choisissez le compte approprié. Utilisez le même compte que celui que vous utilisez pour vous connecter à Business Central. Lorsque vous avez terminé, sélectionnez Connecter.
    Remarque

    Remarque:
    Une fois connecté à Business Central, il ne vous sera plus demandé de vous connecter. Comment modifier ou effacer le compte que j’utilise actuellement pour me connecter à Business Central depuis Power BI Desktop ?

  6. Une fois connecté, Power BI contacte le service Business Central. Le Navigateur La fenêtre affiche les sources de données disponibles pour créer des rapports. Sélectionnez un dossier pour le développer et afficher les sources de données disponibles.

    Ces sources de données représentent toutes les API et tous les services web publiés pour Business Central, regroupés par environnements et compagnies. Avec Business Central en ligne, Navigateur possède la structure suivante :

    • Nom de l’environnement
      • Nom de la compagnie

        • API avancées

          Ce dossier répertorie les API avancées publiées par Microsoft, comme les API d’automatisation Business Central et les API publiées par d’autres organisations (ces API sont appelées API personnalisées). Les API personnalisées sont regroupées dans des dossiers selon les APIPublisher/APIGroup propriétés du code source de l’API.

        • API standard v2.0

          Ce dossier répertorie les API de données exposées dans API Business Central V2.0. Vous utilisez ces API pour lire des données de la base de données Business Central, telles que les données de base (client, fournisseur, article, etc.), les transactions (écritures de grand livre, écritures client, etc.) ou les données de configuration (dimensions, modes de paiement, unités de mesure, etc.).

        • Services web (hérités)

          Ce dossier répertorie les pages, codeunits et requêtes publiés en tant que services web dans Business Central. L’utilisation de cette méthode héritée pour lire des données depuis Business Central est déconseillée. Nous suggérons plutôt d’utiliser des API.

  7. Sélectionnez la ou les sources de données que vous souhaitez ajouter à votre modèle de données, puis sélectionnez Charger bouton.

  8. Si vous souhaitez ajouter ultérieurement d’autres données Business Central, vous pouvez répéter les étapes précédentes.

Une fois les données chargées, vous pouvez les voir dans le volet de navigation de droite. À ce stade, vous êtes connecté à vos données Business Central et vous pouvez commencer à créer votre rapport Power BI.

Conseil

Conseil:
Pour plus d’informations sur l’utilisation de Power BI Desktop, consultez Démarrer avec Power BI Desktop.

Créer des rapports accessibles

Il est important de rendre vos rapports utilisables par le plus grand nombre de personnes possible. Essayez de concevoir des rapports qui ne nécessitent aucune adaptation spéciale pour répondre aux besoins spécifiques des différents utilisateurs. Assurez-vous que la conception permet aux utilisateurs de tirer parti des technologies d’assistance, comme les lecteurs d’écran. Power BI inclut diverses fonctionnalités d’accessibilité, des outils et des directives pour vous aider. Pour en savoir plus, consultez Concevoir des rapports Power BI pour l’accessibilité dans la documentation Power BI.

Créer des rapports pour afficher les données associées à une liste dans Business Central

Vous pouvez créer des rapports qui s’affichent dans un récapitulatif sur une page de liste Business Central, et qui changent lorsque différentes lignes sont sélectionnées dans la liste. La création de ces rapports est similaire à celle d’autres rapports, sauf que quelques étapes supplémentaires sont nécessaires pour s’assurer que les rapports s’affichent comme prévu. Pour en savoir plus, consultez Création de rapports Power BI pour afficher les données de liste dans Business Central.

Utiliser le thème de rapport Business Central (facultatif)

Avant de créer votre rapport, nous vous recommandons de télécharger et d’importer le fichier de thème Business Central. Le fichier de thème crée une palette de couleurs pour vous permettre de créer des rapports avec le même style de couleurs que les applications Business Central, sans avoir à définir de couleurs personnalisées pour chaque visuel.

Remarque

Remarque:
Cette tâche est facultative. Vous pouvez toujours créer vos rapports, puis télécharger et appliquer le modèle de style ultérieurement.

Télécharger le thème

Le fichier de thème est disponible en tant que fichier json dans la galerie de thèmes de la communauté Microsoft Power BI. Pour télécharger le fichier de thème, procédez comme suit :

  1. Aller à Galerie de thèmes de la communauté Microsoft Power BI pour Microsoft Dynamics 365 Business Central.
  2. Sélectionnez la pièce jointe de téléchargement Microsoft Dynamics Business Central.json.

Importer le thème sur un rapport

Après avoir téléchargé le thème de rapport Business Central, vous pouvez l’importer dans vos rapports. Pour importer le thème, sélectionnez Consulter > Thèmes > Parcourir les thèmes. Pour en savoir plus, consultez Power BI Desktop - Importer des thèmes de rapport personnalisés.

Publier des rapports

Après avoir créé ou modifié un rapport, vous pouvez le publier dans votre service Power BI et le partager avec d’autres personnes de votre organisation. Après avoir publié un rapport, il est disponible dans Business Central. Le rapport peut également être sélectionné dans Business Central.

Pour publier un rapport, sélectionnez Publier sur la Accueil onglet du ruban ou depuis le Fichier menu. Si vous êtes connecté au service Power BI, le rapport est publié dans ce service. Sinon, vous êtes invité à vous connecter.

Distribuer ou partager un rapport

Il existe plusieurs façons de partager des rapports :

  • Partager un rapport depuis votre service Power BI (recommandé)

    Si vous disposez d’une licence Power BI PRO ou utilisez Power BI Premium Capacity, vous pouvez partager le rapport directement depuis votre service Power BI. Pour en savoir plus, consultez Power BI - Partager un tableau de bord ou un rapport.

  • Distribuer des rapports sous forme de fichiers .pbix.

    Les rapports sont stockés sur votre ordinateur sous forme de fichiers .pbix. Vous pouvez distribuer le fichier .pbix aux utilisateurs, comme n’importe quel autre fichier. Les personnes avec lesquelles vous avez partagé le fichier peuvent ensuite le télécharger dans leur service Power BI. Pour en savoir plus, consultez Télécharger des rapports depuis des fichiers.

    Remarque

    Remarque:
    La distribution de rapports de cette manière signifie que l’actualisation des données pour les rapports est effectuée individuellement par chaque utilisateur. Cette situation pourrait avoir un impact sur les performances de Business Central.

Comment développer des rapports Power BI inter-compagnies ou inter-environnements

Les points de terminaison de l’API Business Central ont tous le préfixe https://api.businesscentral.dynamics.com/v2.0/<environment_name>/api/v2.0 suivi de /companies({company_id})/accounts({id}) (ici nous utilisons l’ accounts API à titre d’illustration). Vous pouvez utiliser cette structure pour créer des requêtes PowerQuery qui chargent des données pour plusieurs compagnies ou plusieurs environnements si l’utilisateur qui lit les données peut y accéder.

Pour configurer une requête afin de charger des données pour plusieurs compagnies, procédez comme suit :

  1. Prenez la requête PowerQuery qui charge les données pour une seule compagnie. Convertissez-la en une fonction Power Query personnalisée qui prend l’identifiant de la compagnie (ou peut-être le nom de l’environnement) comme paramètres. Pour en savoir plus, consultez Utiliser des fonctions Power Query personnalisées.
  2. Utilisez maintenant la nouvelle fonction personnalisée dans une requête PowerQuery, où vous mappez la fonction sur une liste de compagnies, puis fusionnez les ensembles de données à l’aide de Table.Combine fonction Power Query.

Personnaliser le code Power Query qui se connecte à votre source de données Business Central

Dans la plupart des cas, l’utilisation de l’interface de navigation dans Power BI Desktop est suffisante pour créer des rapports basés sur des données Business Central. Cependant, des scénarios plus complexes peuvent nécessiter de modifier manuellement le code Power Query responsable de l’obtention de vos données.

Pour ce faire, procédez comme suit :

  1. Démarrez Power BI Desktop.

  2. Réalisez l’étape correspondant à votre scénario :

    1. Sélectionner Fichier > Ouvert.
    2. Parcourez et sélectionnez le rapport (.pbix).
    3. Dans le ruban, sélectionnez Transformer les données pour ouvrir Éditeur Power Query.
  1. Dans Éditeur Power Query, sélectionnez Éditeur avancé depuis le ruban.

Ceci affichera le code Power Query que le système a généré automatiquement lorsque vous avez effectué vos sélections dans le navigateur. Par exemple, supposons que vous ayez sélectionné l’environnement Business Central nommé Production, la compagnie appelée CRONUS USA, Inc., le dossier API appelé API standard v2.0, et la table appelée customers. La navigation vers l’Éditeur avancé afficherait une requête similaire à celle-ci :

let
  Source = Dynamics365BusinessCentral.ApiContentsWithOptions(null, null, null, null),
  PRODUCTION = Source{[Name="PRODUCTION"]}[Data],
  #"CRONUS USA, Inc." = PRODUCTION{[Name="CRONUS USA, Inc."]}[Data],
  v2.0 = #"CRONUS USA, Inc."{[Name="v2.0"]}[Data],
  customers_table = v2.0{[Name="customers",Signature="table"]}[Data]
in
  customers_table

Vous pouvez maintenant modifier manuellement cette requête pour apporter les modifications correspondant à vos besoins.

La fonction Dynamics365BusinessCentral.ApiContentsWithOptions

Dans la requête ci-dessus, la fonction Dynamics365BusinessCentral.ApiContentsWithOptions est responsable de la connexion à Business Central et de la récupération des données. Cette fonction possède 4 paramètres facultatifs, qui ne sont pas fournis dans la requête par défaut.

Voici une description des différents paramètres :

Paramètre Exemples Description
Environnement "Production" Ce paramètre vous permet de spécifier l’environnement Business Central auquel vous connecter. S’il n’est pas spécifié, la fonction retourne une liste de tous les environnements, et vous devez sélectionner l’environnement approprié dans les étapes suivantes de votre code Power Query
Entreprise "CRONUS USA, Inc." Ce paramètre vous permet de spécifier la compagnie Business Central à laquelle vous connecter, dans votre environnement sélectionné. Ce paramètre est ignoré si le Environnement paramètre n’est pas spécifié. S’il n’est pas spécifié, la fonction retourne une liste de toutes les compagnies de votre environnement sélectionné (ou des environnements), et vous devez sélectionner la compagnie appropriée dans les étapes suivantes de votre code Power Query
Catégorie d’API (ou route d’API) "microsoft/runtime/beta", "v2.0" Ce paramètre vous permet de spécifier la route d’API à laquelle vous connecter dans Business Central, dans votre environnement et votre compagnie sélectionnés. Ce paramètre est ignoré si les Environnement et Entreprise paramètres ne sont pas spécifiés. S’ils ne sont pas spécifiés, la fonction retourne une liste de toutes les catégories d’API (aussi appelées routes d’API) dans votre environnement\/vos environnements et votre compagnie\/vos compagnies sélectionnés, et vous devez sélectionner la catégorie d’API appropriée dans les étapes suivantes de votre code Power Query
Options avancées Ce paramètre vous permet de spécifier des options avancées pour vous connecter à votre source de données Business Central. Notez que dans la grande majorité des cas, les valeurs par défaut sont optimisées et n’ont pas besoin d’être modifiées. Pour plus d’informations sur ces paramètres, consultez la section suivante.

Par exemple, la requête présentée ci-dessus dans cette section est entièrement équivalente à la requête suivante :

 let
   Source = Dynamics365BusinessCentral.ApiContentsWithOptions("PRODUCTION", "CRONUS USA, Inc.", "v2.0", null),
   customers_table = Source{[Name="customers",Signature="table"]}[Data]
 in
   customers_table

Avancé : Personnaliser la langue, le délai d’attente, le réplica de base de données ou la taille de page de votre source de données Business Central

Le connecteur Power BI pour Business Central prend en charge plusieurs propriétés avancées pour la connexion à une source de données Business Central que vous pouvez définir dans vos requêtes Power Query. Le tableau suivant décrit les paramètres.

Option avancée Description Par défaut Pour en savoir plus, consultez
AcceptLanguage Ce paramètre vous permet de spécifier les langues préférées pour les réponses, garantissant que les utilisateurs reçoivent les messages et les chaînes traduisibles dans la langue souhaitée. Il définit la langue dans laquelle la session de l’API Business Central s’exécute. Il influence la langue des messages d’erreur, les valeurs formatées en AL et d’autres valeurs qui dépendent de la langue ou de la culture.

La définition de ce paramètre améliore la satisfaction des utilisateurs et rend les données plus accessibles et pertinentes.		 non spécifié Utiliser des valeurs régionales dans des rapports Power BI multilingues.
ODataMaxPageSize Ce paramètre limite le nombre d’entités par page de résultats, ce qui permet plus de flexibilité lors de la connexion à de grands ensembles de données ou lors de l’utilisation de requêtes complexes. Il définit le nombre maximum d’enregistrements à retourner pour chaque page lors de l’appel d’une API. Par exemple, si votre table Clients contient 13 000 enregistrements et ODataMaxPageSize est défini sur 5 000, Power BI effectue 3 appels API pour obtenir vos clients. Le premier appel récupère 5 000 enregistrements, le suivant en récupère 5 000 autres, et le dernier appel récupère les 3 000 restants. Cette option ne peut pas dépasser la taille de page maximale appliquée par Business Central, qui est de 20 000.

La définition de ce paramètre garantit une récupération des données efficace et réactive, menant à des informations et des prises de décision plus rapides. Vous ne pouvez pas dépasser la taille de page maximale définie sur le service.		 5000 Propriété ODataPreferenceHeader.MaxPageSize
Délai d’attente Ce paramètre définit la durée maximale d’une demande avant annulation. Il définit le délai d’attente pour chaque appel API individuel à Business Central. Sa valeur ne peut pas dépasser le délai d’attente appliqué sur le service Business Central, qui est actuellement de 10 minutes (00:10:00).

La définition de ce paramètre aide à gérer efficacement les ressources système et empêche les requêtes de longue durée d’avoir un impact sur les performances globales du système. Les utilisateurs connaissent des délais et des interruptions minimaux, garantissant un flux de travail plus fluide.		 00:08:00 OData.Feed
UseReadOnlyReplica Ce paramètre détermine si les demandes ciblent la base de données principale ou un réplica en lecture seule. Le déchargement des opérations de lecture depuis la base de données principale peut considérablement améliorer les performances.

La définition de cette propriété entraîne une récupération des données plus rapide et une meilleure stabilité du système, en particulier lors des périodes de pointe.		 vrai

Configurer les options avancées

  1. Suivez les étapes pour afficher le code Power Query depuis l’Éditeur avancé Power BI

  2. Dans Éditeur avancé, localisez la ligne qui commence par Source =:

    Source = Dynamics365BusinessCentral.ApiContentsWithOptions(null, null, null, null),

  3. Dans la ligne, remplacez le quatrième paramètre de Dynamics365BusinessCentral.ApiContentsWithOptions par un enregistrement Power Query de propriétés et de valeurs que vous souhaitez définir, par exemple :

    Source = Dynamics365BusinessCentral.ApiContentsWithOptions(null, null, null, [UseReadOnlyReplica = true, Timeout = Duration.From("00:07:00"), ODataMaxPageSize = 10000, AcceptLanguage = "it-it"])

  4. Sélectionner Terminé pour fermer Éditeur avancé.

  5. Sélectionner Fermer et appliquer pour enregistrer les modifications et fermer l’Éditeur Power Query.

Résolution des problèmes

Erreur « Expression.Error: The environment 'Production' does not exist. » lors de la spécification d’un environnement Business Central

S’APPLIQUE À : Business Central en ligne

Lorsque vous vous connectez à Business Central en ligne depuis Power BI, ou lorsque vous installez une application Power BI Desktop depuis Microsoft AppSource qui utilise des données Business Central, vous pourriez être invité à saisir l’environnement Business Central auquel vous souhaitez vous connecter.

Si vous obtenez une erreur similaire à « Expression.Error: The environment 'Production' does not exist. », suivez ces étapes pour résoudre le problème :

  1. Assurez-vous d’utiliser les bonnes informations d’identification pour accéder à Business Central. Ces informations d’identification pourraient ne pas être les mêmes que celles que vous utilisez pour accéder à Power BI. Comment modifier ou effacer le compte que j’utilise actuellement pour me connecter à Business Central depuis Power BI Desktop ?
  2. Si votre environnement est un environnement ISV intégré, vous devez spécifier le nom de l’ISV intégré entre parenthèses dans le cadre du nom de l’environnement. Par exemple, si vous souhaitez vous connecter à un environnement nommé Production à partir de l’ISV intégré nommé Fabrikam, vous devez spécifier « PRODUCTION (fabrikam) » comme nom d’environnement.

Erreur « Can't insert a record. Current connection intent is Read-Only. » lors de la connexion à une page API personnalisée

S’APPLIQUE À : Business Central en ligne

Par défaut, les rapports qui utilisent des données Business Central se connectent à un réplica en lecture seule de la base de données Business Central. Dans de rares cas, selon la conception de l’API, vous pourriez obtenir une erreur lors de la tentative de connexion et d’obtention des données depuis l’API. L’erreur ressemble à ceci :

Dynamics365BusinessCentral: Request failed: The remote server returned an error: (400) Bad Request. (Can't insert a record. Current connection intent is Read-Only. CorrelationId: [...])".

Si vous utilisez une API personnalisée, nous vous recommandons de retravailler le code AL pour vous assurer qu’il n’effectue pas de modifications de base de données lorsqu’il ne fait que lire des données. Mais si votre scénario l’exige, vous pouvez configurer le connecteur pour utiliser une connexion en lecture-écriture à la place.

Activer vos données commerciales pour Power BI
Veille stratégique
Se préparer à faire des affaires
Importer des données commerciales depuis d'autres systèmes financiers
Configuration de Business Central
Finance
Démarrage rapide : Se connecter aux données dans Power BI Desktop

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

Tous droits réservés | Sparkrock © 2026