Configurer l’intégration de Power BI

Notes

À compter du 12 octobre 2022, le portail Power Apps devient Power Pages. Plus d’informations : Microsoft Power Pages est maintenant généralement disponible (blog)
Nous allons bientôt migrer et fusionner la documentation des portails Power Apps avec la documentation de Power Pages.

Power BI est l’un des meilleurs outils pour fournir des informations avec une visualisation simple et interactive. Pour afficher des tableaux de bord et des états Power BI sur les pages Web d’un portail, vous devez activer la visualisation de Power BI à partir du Centre d’administration du portail Power Apps. Vous pouvez également intégrer des tableaux de bord et des états créés dans le nouvel espace de travail Power BI en activant le service d’intégration Power BI Embedded.

Notes

Vous pouvez également intégrer Power BI avec Power Pages. Plus d’informations : Qu’est-ce Power Pages.

Notes

  • Vous devez disposer d’une licence Power BI appropriée.
  • Pour utiliser le service Power BI Embedded, vous devez disposer d’une licence Power BI Embedded appropriée. Vérifiez la planification de la capacité et le prix pour Power BI Embedded. Plus d’informations : FAQ sur la gestion des licences Power BI Embedded.
  • Veiller à ce que Intégrer du contenu dans des applications est Activé dans votre locataire Power BI Paramètres du développeur. Quand il est désactivé, un portail ne peut pas afficher les tableaux de bord ou rapports Power BI intégrés.

Activer la visualisation Power BI

Activer la visualisation de Power BI vous permet d’inclure des tableaux de bord et des états dans les pages web d’un portail à l’aide de la balise Liquid powerbi.

  1. Ouvrez le Centre d’administration Portails Power Apps.

  2. Accédez à Configurer l’intégration de Power BI et sélectionnez Activer la visualisation Power BI.

    Activer la visualisation Power BI.

  3. Sélectionnez Activer dans le message de confirmation. Quand la visualisation Power BI est activée, le portail redémarrera et ne sera pas disponible pendant quelques minutes. Un message s’affichera quand la visualisation Power BI aura été activée.

Les personnalisateurs peuvent utiliser maintenant la balise Liquid powerbi pour intégrer des tableaux de bord ou des états Power BI sur les pages web d’un portail. Au moment de l’intégration du contenu Power BI, les personnalisateurs peuvent utiliser les paramètres de filtre pour créer des vues personnalisées. Pour plus d’informations, voir Balise Liquid powerbi.

Désactiver la visualisation Power BI

  1. Ouvrez le Centre d’administration Portails Power Apps.

  2. Accédez à Configurer l’intégration de Power BI et sélectionnez Désactiver la visualisation Power BI.

    Désactiver la visualisation Power BI.

  3. Sélectionnez Désactiver dans le message de confirmation. Quand la visualisation Power BI est désactivée, le portail redémarrera et ne sera pas disponible pendant quelques minutes. Un message s’affichera quand la visualisation Power BI aura été désactivée.

Activer le service Power BI Embedded

L’activation du service Power BI Embedded vous permet d’intégrer des tableaux de bord et des états créés dans le nouvel espace de travail Power BI. Les tableaux de bord ou les rapports sont intégrés aux pages web d’un portail à l’aide de la balise Liquid powerbi.

Conditions préalables : Avant d’activer le service Power BI Embedded, vérifiez que vous avez créé vos tableaux de bord et états dans le nouvel espace de travail de Power BI. Après avoir créé l’espace de travail, fournissez l’accès administrateur à l’administrateur global pour que les espaces de travail soient affichés dans le Centre d’administration des portails Power Apps. Pour plus d’informations sur la création de nouveaux espaces de travail et l’ajout d’un accès à ceux-ci, voir Créer des espaces de travail dans Power BI.

Notes

Vérifiez que la visualisation Power BI est activée pour que la balise Liquid powerbi fonctionne.

Pour activer le service Power BI Embedded :

  1. Ouvrez le Centre d’administration Portails Power Apps.

  2. Accédez à Configurer l’intégration de Power BI et sélectionnez Activer le service Power BI Embedded.

    Activer le service Power BI Embedded.

  3. Dans la fenêtre Activer l’intégration du service Power BI Embedded, sélectionnez les espaces de travail disponibles dont les tableaux de bord et les états doivent être affichés dans votre portail. Déplacez ces espaces de travail vers la liste Espaces de travail sélectionnés.

    Sélectionner des espaces de travail Power BI.

    Notes

    Après avoir ajouté les espaces de travail à la liste Espaces de travail sélectionnés, les bases de données et les rapports s’affichent après quelques minutes.

  4. Sélectionnez Activer. Quand le service Power BI Embedded est en cours d’activation, le portail redémarre et est indisponible pendant quelques minutes. Un message s’affiche quand le service Power BI Embedded est activé.

Après avoir activé le service Power BI Embedded, vous devez maintenant créer un groupe de sécurité, et l’ajouter à votre compte Power BI. Pour plus d’informations, voir Créer un groupe de sécurité et l’ajouter au compte Power BI.

Créer un groupe de sécurité et l’ajouter au compte Power BI

Après avoir activé l’intégration de service Power BI Embedded, vous devez créer un groupe de sécurité dans Azure Active Directory, ajouter un membre à celui-ci, puis ajouter le groupe de sécurité à Power BI via le portail d’administration Power BI. Cette configuration permet aux tableaux de bord et aux rapports créés dans les nouveaux espaces de travail Power BI de s’afficher dans le portail.

Notes

Vous devez vous connecter avec le même compte administrateur global que celui utilisé pour activer le service Power BI Embedded.

Étape 1 : Créer un groupe de sécurité

  1. Connectez-vous au portail Azure à l’aide d’un compte d’administrateur global pour le répertoire.

  2. Sélectionnez Azure Active Directory, Groupe, puis Nouveau groupe.

  3. Sur la page Groupe, entrez les informations suivantes :

    • Type de groupe : Sécurité

    • Nom du groupe : Service Power BI Embedded de portail

    • Description du groupe : Ce groupe de sécurité est utilisé pour l’intégration du service de portail et Power BI Embedded.

    • Type d’appartenance : Attribué

      Créer un groupe de sécurité pour le service Power BI Embedded.

  4. Sélectionnez Créer.

Étape 2 : Ajouter un membre du groupe

Éléments requis : Avant d’ajouter un membre au groupe de sécurité, vous devez vous assurer d’avoir l’ID d’application du portail. L’ID de l’application du portail est également disponible sur l’onglet Détails du portail dans le centre d’administration des portails Power Apps.

  1. Connectez-vous au portail Azure à l’aide d’un compte d’administrateur global pour le répertoire.

  2. Sélectionnez Azure Active Directory, puis sélectionnez Groupes.

  3. Dans la page Groupes – Tous les groupes, recherchez et sélectionnez le groupe Service Power BI Embedded du portail.

    Rechercher et sélectionner le groupe de sécurité pour le service Power BI Embedded.

  4. Dans la page Présentation du service Power BI Embedded du portail, sélectionnez Membres dans la zone Gérer.

  5. Sélectionnez Ajouter des membres, puis entrez l’ID d’application du portail dans la zone de texte.

  6. Sélectionnez le membre dans le résultat de la recherche, puis choisissez Sélectionner.

    Ajouter un membre dans le groupe de sécurité pour le service Power BI Embedded.

Étape 3 : Paramétrage de Power BI

  1. Connectez-vous à Power BI à l’aide d’un compte d’administrateur global pour le répertoire.

  2. Sélectionnez l’icône Paramètres dans le coin supérieur droit du service Power BI, et choisissez Portail d’administration.

    Sélectionner le portail d’administration dans le service Power BI.

  3. Sélectionnez Paramètres du client.

  4. Sous la section Paramètres du développeur, sélectionnez Autoriser les principaux du service à utiliser les API de Power BI.

  5. Dans le champ Groupes de sécurité spécifiques, recherchez et sélectionnez le groupe Service Power BI Embedded du portail.

    Ajouter le groupe de sécurité dans le portail d’administration Power BI.

  6. Cliquez sur Appliquer.

Les personnalisateurs peuvent désormais utiliser la balise Liquid powerbi pour intégrer des tableaux de bord ou des états Power BI depuis de nouveaux espaces de travail Power BI sur les pages web d’un portail. Pour utiliser le service Power BI Embedded, le type d’authentification doit être spécifié comme powerbiembedded. Au moment de l’intégration du contenu Power BI, les personnalisateurs peuvent utiliser les paramètres de filtre pour créer des vues personnalisées. Pour plus d’informations, voir Balise Liquid powerbi.

Gérer le service Power BI Embedded

  1. Ouvrez le Centre d’administration Portails Power Apps.

  2. Accédez à Configurer l’intégration de Power BI et sélectionnez Gérer le service Power BI Embedded.

    Gérer le service Power BI Embedded.

  3. Dans la fenêtre Gérer l’intégration du service Power BI Embedded, sélectionnez les espaces de travail disponibles dont les tableaux de bord et les états doivent être affichés dans votre portail. Déplacez ces espaces de travail vers la liste Espaces de travail sélectionnés. Vous pouvez également supprimer les espaces de travail actuellement utilisés en les déplaçant vers Espaces de travail disponibles.

    Gérer l’intégration du service Power BI Embedded.

    Notes

    Après avoir supprimé les espaces de travail de la liste Espaces de travail sélectionnés, cela peut prendre jusqu’à 1 heure pour refléter les modifications. Jusque-là, les bases de données et les rapports sont affichés sur le portail sans aucun problème.

  4. Sélectionnez Enregistrer.

Désactiver le service Power BI Embedded

  1. Ouvrez le Centre d’administration Portails Power Apps.

  2. Accédez à Configurer l’intégration de Power BI et sélectionnez Gérer le service Power BI Embedded.

    Gérer le service Power BI Embedded.

  3. Dans la fenêtre Gérer l’intégration du service Power BI Embedded, sélectionnez Désactiver l’intégration du service Power BI Embedded.

    Désactiver le service Power BI Embedded.

  4. Sélectionnez Enregistrer.

  5. Dans le message de confirmation, sélectionnez OK. Quand le service Power BI Embedded est désactivée, le portail redémarrera et ne sera pas disponible pendant quelques minutes. Un message s’affichera quand le service Power BI Embedded aura été désactivée.

Considérations et limites

  • Portails avec version 9.3.4.x ou une version ultérieure prend en charge les fonctionnalités suivantes :
    • Tableaux de bord et rapport de Azure Analysis Services utilisant les connexions en direct. Les configurations Azure Analysis Services local ne sont pas prises en charge.
    • Tableaux de bord avec sécurité basée sur les rôles.
    • Vignette unique avec sécurité basée sur les rôles.
  • La fonctionnalité de visualisation Power BI n’est pas disponible dans la région Chine pour l’authentification Azure Active Directory.
  • Pour plus d’informations sur les limitations du service Power BI Embedded, voir Considérations et limites.

Le rendu d’un rapport Power BI sur une page de portail échoue avec l’erreur suivante :

Une erreur de configuration s’est produite au moment de l’affichage de votre rapport.

Ce problème peut survenir pour plusieurs raisons telles que :

Avis de confidentialité

En activant l'incorporation des vignettes et des tableaux de bord Power BI, lorsqu'un utilisateur intègre une vignette ou un tableau de bord Power BI, son jeton d'autorisation Azure Active Directory pour Microsoft Dataverse est utilisé pour l'authentification auprès du service Power BI avec une autorisation implicite, ce qui lui offre une expérience « d'authentification unique » transparente.

Un administrateur peut désactiver l'incorporation des vignettes et des tableaux de bord Power BI à tout moment pour arrêter d'utiliser le jeton d'autorisation Dynamics 365 pour s'authentifier auprès du service Power BI. Toutes les vignettes ou tous les tableaux de bord existants cessent de s'afficher pour l'utilisateur final.

Le composant ou le service Azure impliqué dans l'incorporation des vignettes Power BI est détaillé dans la section suivante.

Remarque : Pour plus d'informations sur les offres de service Azure, consultez le Centre de gestion de la confidentialité Microsoft Azure.

Azure Active Directory

Ce service fournit le jeton d'authentification échangé avec le service Power BI pour l'authentification des API et de l'interface utilisateur.

Étapes suivantes

Ajouter un composant Power BI à une page web à l’aide des portails Studio

Voir aussi

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é).