Partage via

Création de rapports Power BI pour afficher les données Dynamics 365 Business Central

  • Article

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

Cet article décrit la prise en main de Power BI Desktop pour créer des rapports qui affichent 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 figurent dans le service Power BI, les utilisateurs configurés pour ce dernier peuvent afficher les rapports dans Dynamics 365 Business Central.

Mise en route

Note

Vous pouvez obtenir les données de diverses compagnies dans un seul rapport avec les services Web OData. Cependant, à partir de la 2e vague de lancement 2021 de Business Central, seul ODataV4 est pris en charge. ODataV4 n’exporte pas les données de plusieurs compagnies. La fonction $expand dans Power BI que vous pourriez considérer comme un autre moyen de créer un rapport multi-compagnies, ne peut pas non plus être utilisée. Cela 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 dans le cadre 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. Lancez Power BI Desktop.

  2. Sélectionnez Extraire les données.

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

  3. Sur la page Extraire les données, sélectionnez Services en ligne.

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

    • Pour vous connecter à Business Central Online, sélectionnez Dynamics 365 Business Central, puis Se 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 Online, sélectionnez Se connecter, puis choisissez le compte pertinent. Utilisez le même compte que celui que vous utilisez pour vous connecter à Business Central. Lorsque vous avez terminé, sélectionnez Connecter.

    Note

    Une fois connecté(e) à Business Central, vous n’êtes plus invité(e) à 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 affiche les sources de données disponibles pour les rapports de construction. Sélectionnez un dossier pour le développer et afficher les sources de données disponibles.

    Ces sources de données représentent tous les services web et toutes les pages API que vous avez publiés pour Business Central, regroupés en environnement et compagnies. Avec Business Central Online, Navigateur a la structure suivante :

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

  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, elles s'affichent dans le volet de navigation à droite dans la page. À ce stade, vous êtes connecté à vos données Business Central, et vous êtes prêt à générer votre flux Power BI.

Pourboire

Pour plus d’informations sur l’utilisation de Power BI Desktop, reportez-vous à Mise en route avec Power BI Desktop.

Créer des rapports accessibles

Il est important de rendre vos rapports utilisables par autant de personnes que possible. Essayez de concevoir des rapports qui ne nécessitent aucune adaptation particulière 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 standard, comme les lecteurs d′écran. Power BI comprend diverses fonctionnalités d′accessibilité, des outils et des consignes pour vous aider à atteindre cet objectif. Pour plus d′informations, Conception de rapports Power BI pour l′accessibilité dans la documentation Power BI.

Création de rapports pour afficher des données associées à une liste

Vous pouvez créer des rapports qui s’affichent dans un Récapitulatif d’une liste Business Central. Les rapports peuvent contenir des données sur l’enregistrement sélectionné dans la liste. La création de ces rapports est similaire à celle d’autres rapports, à la différence près que vous devez effectuer quelques actions pour vous 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.

Utilisation du thème du rapport Business Central (facultatif)

Avant de générer votre rapport, il est préférable 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 afin de pouvoir établir des rapports avec le même style de couleur que les applications Business Central sans avoir à définir des couleurs personnalisées pour chaque visuel.

Noter

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 sous forme de fichier json sur 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. Accédez à 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 dans un rapport

Après avoir téléchargé le thème du rapport Business Central, vous pouvez l’importer dans vos rapports. Pour importer le thème, sélectionnez Afficher>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 membres de votre organisation. Après avoir publié un rapport, il est disponible dans Power BI. Le rapport est également disponible pour sélection dans Business Central.

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

Distribuer ou partager un rapport

Il existe plusieurs façons de transmettre des rapports à vos collègues et à d’autres personnes :

  • Distribuez les 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 du rapport aux utilisateurs, comme n’importe quel autre fichier. Ensuite, les utilisateurs peuvent télécharger le fichier sur leur service Power BI. Voir Télécharger des rapports à partir de fichiers.

    Noter

    Distribuer les rapports de cette manière signifie que l’actualisation des données des rapports est effectuée individuellement par chaque utilisateur. Cette situation pourrait avoir un impact sur la performance Business Central.

  • Partager un rapport à partir de votre service Power BI

    Si vous disposez d’une licence Power BI Pro, vous pouvez partager le rapport avec d’autres, directement depuis votre service Power BI. Pour en savoir plus, consultez Power BI - partager un tableau de bord ou un rapport.

Comment développer des rapports Power BI intercompagnies ou interenvironnements

Les points de terminaison de l’API Business Central portent 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’API accounts à 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 d’une seule compagnie. Convertissez-le en fonction Power Query personnalisée qui prend le code de la compagnie (ou peut-être le nom de l’environnement) comme paramètres. Pour en savoir plus, rendez-vous sur Utiliser la personnalisation Power Query les fonctions.
  2. Utilisez désormais 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 la fonction Table.Combine Power Query.

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

Le connecteur Power BI pour Business Central prend en charge plusieurs propriétés avancées pour se connecter à 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.

Paramètre Désignation Par défaut En savoir plus
AcceptLanguage Ce paramètre vous permet de spécifier les langues préférées pour les réponses, ce qui garantit que les utilisateurs reçoivent des messages et des chaînes traduisibles dans la langue souhaitée. Il définit la langue dans laquelle s’exécute la session de l’API Business Central. Il influence la langue des messages d’erreur, les valeurs formatées dans 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 de l’utilisateur et rend les données plus accessibles et pertinentes.		 non spécifié Utiliser les valeurs des paramètres régionaux dans les rapports Power BI dans plusieurs langues.
ODataMaxPageSize Ce paramètre limite le nombre d’entités par page de résultats, ce qui offre plus de flexibilité lors de la connexion à de grands ensembles de données ou de l’utilisation de requêtes complexes. Il définit le nombre maximal d’enregistrements à renvoyer pour chaque page lors de l’appel d’une API. Par exemple, si votre table Clients contient 13 000 enregistrements et que ODataMaxPageSize est défini sur 5 000, Power BI effectue 3 appels d’API pour obtenir vos clients. Le premier appel reçoit 5 000 enregistrements, le suivant en reçoit 5 000 de plus et le dernier appel reçoit les 3 000 restants. Cette option ne peut pas être supérieure à 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 de données efficace et réactive, ce qui accélère l’obtention d’informations et la prise de décision. Vous ne pouvez pas dépasser la taille de page maximale définie sur le service.		 5000 Propriété ODataPreferenceHeader.MaxPageSize
Expiration du délai Ce paramètre définit la durée maximale d’une requête avant annulation. Il définit le délai d’expiration pour chaque appel d’API unique à Business Central. Sa valeur ne peut pas dépasser le délai d’expiration appliqué dans 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 longues d’impacter les performances globales du système. Les utilisateurs subissent des retards et des interruptions minimales, ce qui garantit un flux de travail plus fluide.		 00:08:00 OData.Feed
UseReadOnlyReplica Ce paramètre détermine si les requêtes 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 améliorer considérablement les performances.

La définition de cette propriété permet une récupération plus rapide des données et une meilleure stabilité du système, en particulier pendant les périodes d’utilisation de pointe.		 vrai

Configurer les paramètres avancés

  1. Lancez Power BI Desktop.

  2. Effectuez l’étape adaptée à votre scénario :

    1. Sélectionnez Fichier>Ouvrir.
    2. Recherchez et sélectionnez le rapport (.pbix).
    3. Dans le ruban, sélectionnez Transformer les données pour ouvrir l’Éditeur Power Query.

  1. Dans l’éditeur Power Query, sélectionnez Éditeur avancé du ruban.

  2. Dans l’Éditeur avancé, repérez 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 une liste séparée par des virgules de propriétés et de valeurs que vous souhaitez définir, par exemple :

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

  4. Sélectionnez Terminé pour fermer l’Éditeur avancé.

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

Résolution des problèmes

Erreur « Expression.Error : l’environnement « Production » n’existe pas. » lors de la spécification d’un environnement Business Central

S’APPLIQUE À : Business Central Online

Lorsque vous vous connectez à Business Central Online à partir de Power BI ou lorsque vous installez une application Power BI à partir de Microsoft AppSource qui utilise les données Business Central, vous pouvez être invité à entrer l’environnement Business Central auquel vous souhaitez vous connecter.

Si vous obtenez une erreur similaire à « Expression.Error : l’environnement « Production » n’existe pas. », procédez comme suit pour résoudre le problème :

  1. Assurez-vous d’utiliser les informations d’identification appropriées pour accéder à Business Central. Ces informations d’identification peuvent 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 incorporé, vous devez spécifier le nom ISV incorporé entre parenthèses dans le nom de l’environnement. Par exemple, si vous souhaitez vous connecter à un environnement nommé Production à partir du fournisseur de logiciels indépendant nommé Fabrikam, vous devez spécifier « PRODUCTION (fabrikam) » comme nom d’environnement.

« Impossible d’insérer un enregistrement. L’intention de connexion actuelle est en lecture seule. » erreur de connexion à la page d’API personnalisée

S’APPLIQUE À : Business Central Online

Par défaut, les rapports qui utilisent les 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 la page, vous obtenez une erreur lorsque vous essayez de vous connecter et d’obtenir des données à partir de la page. 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 page d’API personnalisée, nous vous recommandons de reconcevoir la page pour garantir qu’elle n’apporte pas de modifications de la base de données lorsqu’elle lit simplement des données. Mais si votre scénario l’exige, vous pouvez configurer le connecteur pour qu’il utilise une connexion en lecture-écriture à la place.

Activation de vos données commerciales pour Power BI
Veille économique
Préparation aux activités commerciales
Importation des données métier à partir d'autres systèmes financiers
Configuration de Business Central
Finances
Démarrage rapide : Se connecter aux données dans Power BI Desktop

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