Incorporer des rapports paginés Power BI

Avec l’analytique incorporée Power BI, vous pouvez créer du contenu Power BI qui affiche des rapports paginés dans une application entièrement intégrée et interactive. Incorporez des rapports paginés à l’aide de la solution qui vous convient le mieux : incorporer pour vos clients ou incorporer pour votre organisation.

Cet article explique comment incorporer des rapports paginés à l’aide des exemples de tutoriels d’incorporation.

Prérequis

Pour commencer, vous avez besoin des éléments suivants :

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.

Méthode

Pour incorporer un rapport paginé à l’aide de l’exemple d’application, procédez comme suit :

  1. Créez un espace de travail.

  2. Créez une capacité.

  3. Affectez un espace de travail à une capacité.

  4. Créez et chargez votre rapport paginé.

  5. Incorporez du contenu à l’aide de l’exemple d’application.

Étape 1 - Créer un espace de travail

Quand vous utilisez un principal de service pour vous connecter à votre application, vous devez créer un espace de travail.

Votre principal de service doit également être un administrateur ou un membre des espaces de travail Power BI.

Étape 2 - Créer une capacité

Avant d’importer ou de charger un rapport paginé à incorporer, vous devez affecter l’espace de travail contenant le rapport à une capacité. Vous avez le choix entre deux types de capacité dans Power BI :

Le tableau suivant décrit les ressources et les limites de chaque référence SKU. Pour déterminer la capacité qui correspond le mieux à vos besoins, consultez le tableau Quelle référence SKU dois-je acheter pour mon scénario ?

Nœuds de capacité V-cores RAM (Go)
EM1/A1 1 2.5
EM2/A2 2 5
EM3/A3 4 10
P1/A4 8 25
P2/A5 16 50
P3/A6 32 100

Étape 3 - Affecter un espace de travail à une capacité

Après avoir créé une capacité, affectez-lui l’espace de travail de votre application.

Pour affecter une capacité à un espace de travail à l’aide d’un principal de service, utilisez l’API REST Power BI. Quand vous utilisez les API REST Power BI, veillez à utiliser l’ID d’objet du principal de service.

Notes

Vous pouvez également importer des rapports paginés dans un espace de travail en utilisant les API REST Power BI.

Étape 4 - Créer et charger votre rapport paginé

Vous pouvez créer votre rapport paginé à l’aide du Générateur de rapports Power BI, puis charger ce rapport dans le service.

Notes

La personne qui charge le rapport paginé a besoin d’une licence Power BI Pro ou Premium par utilisateur (PPU) pour publier sur un espace de travail.

Étape 5 - Incorporer du contenu en utilisant l’exemple d’application

Suivez les étapes du tutoriel Incorporer du contenu pour vos clients. Ignorez l’Étape 4 - Créer et publier un rapport Power BI et travaillez avec le rapport paginé que vous avez chargé, à la place de l’exemple de rapport suggéré dans le tutoriel.

Pour plus d’informations sur l’incorporation de jetons, consultez Jetons d’accès pour l’analytique incorporée.

Considérations et limitations

  • Pour obtenir la liste complète des jeux de données pris en charge et leurs méthodes d’authentification, consultez Sources de données prises en charge pour les rapports paginés Power BI.
  • Vous devez utiliser un principal de service. Vous ne pouvez pas avoir d’utilisateur maître.
  • Vous ne pouvez pas utiliser une licence PPU (Premium par utilisateur).
  • Lorsque vous incorporez un rapport paginé à un modèle sémantique Power BI, deux conditions s’appliquent :
    • Le rapport paginé et le modèle sémantique Power BI doivent résider dans un espace de travail Premium par capacité ou incorporé (ils peuvent résider dans deux espaces de travail différents).
    • La personne qui génère le jeton intégré doit avoir des autorisations écrites dans les espaces de travail du rapport et du modèle sémantique.
  • L’incorporation d’un rapport paginé connecté à Azure Analysis Services avec l’authentification unique activée n’est actuellement pas prise en charge.
  • Les rapports paginés ne prennent pas en charge les événements côté client (comme loaded ou rendered).
  • L’incorporation de rapports paginés avec un jeu de données en temps réel (jeu de données push) n’est pas prise en charge.