Contrôle Vignette Power BI dans Power Apps

Un contrôle qui affiche une mosaïque Power BI à l’intérieur d’une application.

Vous n’avez pas Power BI ? Inscription.

Description

Tirez parti des analyses et rapports de données actuels en affichant vos Vignettes Power BI à l’intérieur de vos applications. Spécifiez la vignette à afficher en définissant ses propriétés Workspace, Dashboard et Tile sous l’onglet Données du volet d’options.

Notes

  • Le contrôle Vignette Power BI n’est pas disponible dans les environnements GCC High et DoD.
  • Le contrôle Vignette Power BI n’est pas disponible en Chine.
  • Pour les exigences de licence au moment de l’intégration de la vignette Power BI, voir Gestion des licences.

Partage et sécurité

Quand vous partagez une application qui comprend du contenu Power BI, vous devez partager non seulement l’application proprement dite, mais aussi le tableau de bord d’où provient la vignette. Sinon, le contenu Power BI ne s’affiche pas (même les utilisateurs qui ouvrent l’application ne le voient pas). Les applications avec du contenu Power BI respectent les autorisations pour ce contenu.

Performance

Il n’est pas recommandé de charger plus de trois vignettes Power BI en même temps dans une application. Pour contrôler le chargement et le déchargement des vignettes, définissez la propriété LoadPowerBIContent.

Options d’intégration

L’intégration est différente entre les versions de l’API Power BI. En raison du nouveau schéma d’authentification API Power BI, votre vignette peut ne pas être accessible sur mobile ou dans d’autres scénarios intégrés (Teams ou SharePoint).

Vous pouvez contrôler l’utilisation de la version de l’API en utilisant la propriété AllowNewAPI. Pour plus d’information, voir Propriétés clés.

Valeur de la propriété AllowNewAPI Comportement
Vrai Vous pouvez intégrer un tableau de bord, un rapport ou une vignette en utilisant l’URL d’intégration de Power BI pour en faire une valeur TileUrl.
Faux Vous pouvez intégrer une vignette de tableau de bord soit en utilisant l’URL d’intégration et en lui donnant la valeur TileUrl, soit en utilisant l’interface graphique fournie.

Notes

Incorporer une URL Power BI (par exemple, dans un IFrame) n’est pas pris en charge sur l’application mobile Power Apps, car l’authentification de la demande d’URL Power BI n’est pas gérée par le lecteur mobile.

Filtering

Le filtrage diffère entre les versions de l’API Power BI. Voir les sections appropriées ci-dessous selon la façon dont vous configurez le contrôle.

Au moment de l’utilisation de la nouvelle API pour appeler le service Power BI

Quand la propriété AllowNewAPI est définie sur "True", vous utilisez une nouvelle API pour appeler le service Power BI. Pour plus d’informations, voir Filtrer un état à l’aide des paramètres de chaîne de requête dans l’URL.

Au moment de l’utilisation de l’API d’origine pour appeler le service Power BI

Quand la propriété AllowNewAPI est définie sur "False", vous utilisez l’API d’origine pour appeler le service Power BI. Dans ce cas, en transmettant un seul paramètre de l’application, vous pouvez filtrer les résultats qui apparaissent dans une vignette Power BI. Toutefois, seules les valeurs de chaîne et l’opérateur égal sont pris en charge et le filtre peut ne pas fonctionner si le nom de la table ou le nom de la colonne contient des espaces.

Pour passer une seule valeur de filtre, modifiez la valeur de la propriété TileURL, qui suit cette syntaxe :

"https://app.powerbi.com/embed?dashboardId=<DashboardID>&tileId=<TileID>&config=<SomeHash>"

À cette valeur, ajoutez cette syntaxe :

&$filter=<TableName>/<ColumnName> eq '<Value>'

Par exemple, en utilisant une valeur d’une zone de liste :

"&$filter=Store/Territory eq '" & ListBox1.Selected.Abbr & "'"

Le paramètre filtrera une valeur dans le jeu de données du rapport d’où provient la tuile. Cependant, la fonction de filtrage présente les limitations suivantes :

  • Un seul filtre peut être appliqué.
  • Seul l’opérateur eq est pris en charge.
  • Le type de champ doit être une chaîne.
  • Le filtrage est disponible uniquement sur les vignettes de visualisation épinglées. Il n’est pas pris en charge pour les rapports épinglés.
  • Les visuels de script R et Python ne peuvent pas être filtrés.

Vous pouvez utiliser des champs calculés dans le rapport Power BI pour convertir d’autres types de valeur en chaîne ou combine plusieurs champs en un seul.

Propriétés clés

AllowNewAPI - S’il faut utiliser la nouvelle API au moment de l’appel du service Power BI. Définir la valeur sur True permettra l’utilisation de la nouvelle API Power BI (qui n’est pas prise en charge dans les scénarios mobiles et certains scénarios embarqués, mais permet un filtrage plus avancé). False utilisera l’API d’origine. La valeur par défaut est False.

Dashboard : tableau de bord Power BI d’où provient la vignette.

LoadPowerBIContent – quand la valeur est True, le contenu Power BI est chargé et affiché. Quand la valeur est False, le contenu Power BI est déchargé, ce qui libère la mémoire et optimise les performances.

PowerBIInteractions - Quand il est paramétré sur True, le contenu Power BI peut faire l’objet d’une interaction, mais l’événement Power Apps OnSelect ne se déclenchera pas. Quand il est paramétré sur False, il n’est pas possible d’interagir avec la vignette, mais l’événement Power Apps OnSelect se déclenchera quand la vignette sera sélectionnée.

Vignette : nom de la vignette Power BI à afficher.

Workspace : espace de travail Power BI d’où provient la vignette.

Propriétés supplémentaires

BorderColor  : couleur de bordure du contrôle.

BorderStyle  : indique si la bordure d’un contrôle est unie, discontinue, en pointillés ou s’il n’y en a aucune.

BorderThickness  : épaisseur de bordure d’un contrôle.

DisplayMode  : indique si le contrôle autorise l’entrée utilisateur (Edit), affiche uniquement les données (View) ou est désactivé (Disabled).

Height  : distance entre le haut et le bas d’un contrôle.

OnSelect  : Actions à effectuer lorsque l’utilisateur sélectionne un contrôle. Par défaut, le rapport Power BI associé à la vignette s’ouvre.

TileUrl : URL par laquelle la vignette est demandée à partir du service Power BI. Pour ajouter un filtrage de chaîne de requête à votre URL, consultez la section filtrage ci-dessus.

Visible  : indique si un contrôle est visible ou est masqué.

Width  : distance entre les côtés droit et gauche d’un contrôle.

X  : distance entre le bord gauche d’un contrôle et le bord gauche de son conteneur parent (ou de l’écran—à défaut de conteneur parent).

Y  : distance entre le bord supérieur d’un contrôle et le bord supérieur du conteneur parent (ou de l’écran—à défaut de conteneur parent).

Exemple

  1. Sous l’onglet Insérer, ouvrez le menu Graphiques, puis ajoutez un contrôle Vignette Power BI.

    Vous ne savez pas comment ajouter et configurer un contrôle ?

  2. Sous l’onglet Données du volet d’options, sélectionnez Mon espace de travail pour le paramètre Workspace.

  3. Sélectionnez un tableau de bord dans la liste des tableaux de bord, puis une vignette dans la liste des vignettes.

    Le contrôle rend la vignette Power BI.

Instructions d’accessibilité

La Vignette Power BI est simplement un conteneur pour le contenu Power BI. Apprenez comment créer du contenu accessible avec ces conseils d’accessibilité Power BI.

Si le contenu Power BI n’a pas de titre, envisagez d’ajouter un en-tête à l’aide d’un contrôle Étiquette pour prendre en charge les lecteurs d’écran. Vous pouvez positionner l’étiquette immédiatement avant la vignette Power BI.

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).