Partager via

Création d’états 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 aborde la prise en main de Power BI Desktop pour créer des états qui affichent des données Dynamics 365 Business Central. Après avoir créé des états, vous pouvez les publier dans votre service Power BI ou les partager avec tous les utilisateurs de votre organisation. Une fois que ces états figurent dans le service Power BI, les utilisateurs configurés pour ce dernier peuvent afficher les états dans Dynamics 365 Business Central.

Mise en route

Remarque

Vous pouvez obtenir les données de diverses entreprises 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 entreprises. La fonction $expand dans Power BI que vous pourriez considérer comme un autre moyen de créer un rapport multi-sociétés, ne peut pas non plus être utilisée. Elle crée une colonne avec le nom de l’entreprise, mais ne la remplit pas avec les données de l’entreprise 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 d’états consiste à ajouter Business Central comme source de données dans Power BI Desktop. Une fois connecté, vous pouvez commencer à créer l’état.

  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.

    Remarque

    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 API et services web que vous avez publiés pour Business Central, regroupés en environnement et entreprises. Avec Business Central Online, Navigateur a la structure suivante :

    • Nom de l’environnement
      • Nom de la société

        • 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 en outre regroupées dans des dossiers selon propriétés APIPublisher/APIGroup du code source de la API.

        • API standards v2.0

          Ce dossier répertorie les API de données exposées dans API Business Central V2.0. Ces API permettent de lire les données de la base de données Business Central, telles que les données de base (client, fournisseur, article, etc.), les transactions (écritures comptabilité, écritures client, etc.) ou les données de configuration (dimensions, modes de règlement, unité de mesure, etc.).

        • Services Web (hérités)

          Ce dossier répertorie les pages, les unités de code et les requêtes publiées en tant que services Web dans Business Central. Il est déconseillé d’utiliser cette méthode héritée pour lire les données de Business Central. À la place, nous vous recommandons d’utiliser les API.

  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.

Astuce

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

Créer des états accessibles

Il est important de rendre vos états utilisables par autant de personnes que possible. Essayez de concevoir des états 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, comme les lecteurs d′écran. Power BI comprend diverses fonctionnalités d′accessibilité, des outils et des consignes pour vous aider. Pour plus d′informations, voir Conception d′états Power BI pour l′accessibilité dans la documentation Power BI.

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

Vous pouvez créer des états qui s’affichent dans un récapitulatif d’une page de liste Business Central et modifier la sélection de différentes lignes dans la liste. La création de ces états est similaire à celle d’autres états, à la différence près de quelques actions pour vous assurer que les états s’affichent comme prévu. Pour en savoir plus, voir Création d’états Power BI pour afficher les données de liste dans Business Central.

Utilisation du thème de l’état Business Central (facultatif)

Avant de générer votre état, 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 états avec le même style de couleur que les applications Business Central sans avoir à définir des couleurs personnalisées pour chaque visuel.

Note

Cette tâche est facultative. Vous pouvez toujours créer vos états, 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 état

Après avoir téléchargé le thème de l’état Business Central, vous pouvez l’importer dans vos états. 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 d’état personnalisés.

Publier des états

Après avoir créé ou modifié un état, vous pouvez le publier dans votre service Power BI et le partager avec d’autres membres de votre organisation. Une fois que vous avez publié un rapport, il est disponible dans Business Central. L’état est également disponible pour sélection dans Business Central.

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

Distribuer ou partager un état

Plusieurs méthodes pour partager les états :

  • Partager l’état de votre service Power BI (recommandé)

    Si vous disposez d’une licence Power BI Pro ou utiliser la capacité Power BI Premium, vous pouvez partager l’état avec d’autres, directement depuis votre service Power BI. Pour en savoir plus, voir Power BI - Partager un tableau de bord ou un état.

  • Distribuez les états sous forme de fichiers .pbix.

    Les états 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. Ensuite, les personnes avec lesquelles vous avez partagé le fichier peuvent le télécharger sur leur Power BI service. Pour en savoir plus, consultez Charger des rapports à partir de fichiers.

    Remarque

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

Comment développer du cross-entreprise ou du cross-environnement Power BI rapports

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 sociétés 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 entreprises, procédez comme suit :

  1. Prenez la requête PowerQuery qui charge les données d’une seule entreprise. Convertissez-le en personnalisé Power Query fonction qui prend l’ID de l’entreprise (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 maintenant la nouvelle fonction personnalisée dans une requête PowerQuery, où vous mappez la fonction sur une liste d’entreprises, puis fusionnez les ensembles de données à l’aide du Table.Combine Power Query fonction.

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 Description 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 états 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 l’état (.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é sur le 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’Editeur 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 Desktop à 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 états 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 l'API, vous obtenez une erreur lorsque vous essayez de vous connecter et d’obtenir des données à partir de 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 reconcevoir le code AL 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 métier 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