Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Pourboire
Pour expérimenter des API en temps réel, à l’aide de votre propre rapport ou d’un exemple de rapport, visitez le terrain de jeu d’analytique incorporée Power BI
L’API cliente Power BI est une bibliothèque côté client qui vous permet de contrôler par programmation votre contenu Power BI incorporé à l’aide de JavaScript ou De TypeScript.
Utilisez les API clientes pour communiquer entre les éléments Power BI (tels que les rapports et les tableaux de bord) et le code de l’application. Cela vous donne la possibilité de créer une expérience utilisateur final en fonction de votre conception.
Comment fonctionne la bibliothèque cliente ?
Les API clientes communiquent avec un élément Power BI incorporé, tel qu’un rapport ou un tableau de bord. L’iframe crée une séparation entre l’application d’hébergement et l’élément Power BI, en veillant à ce que les données soient sécurisées.
application cliente : la capture d’écran complète est un exemple d’application cliente.
rapport incorporé : rapport incorporé actuellement affiché dans l’application.
limite iFrame : le rapport incorporé est hébergé à l’intérieur d’un iFrame. Le diagramme présente sa limite.
API clientes : utilisez les API clientes pour communiquer entre l’application web et le composant incorporé. Par exemple, lorsque vous appelez
report.setPage(…)la page active du rapport sera modifiée. Une fois la page modifiée, un événement pageChanged sera émis par le rapport et vous pouvez ajouter du code supplémentaire dans le gestionnaire d’événements. Pour plus d’informations, consultez de navigation de page.
Qu’est-ce que ce jeu de documentation inclut ?
Cet ensemble de documentation répertorie les API pour les composants suivants :
powerbi-client : la bibliothèque principale du client Power BI qui inclut toutes les API clientes Power BI, à l’exception de de création de rapports powerbi. Cette bibliothèque définit les classes pour les différents éléments Power BI qui peuvent être incorporés. La bibliothèque
powerbi-client vous permet de contrôler le contenu que vous incorporez. powerbi-models : contient les modèles objet pour les API clientEs Power BI. Pour chaque modèle, il existe une interface TypeScript, une définition de schéma JSON et une fonction de validation pour garantir qu’un objet donné est un modèle valide.
powerbi-report-authoring : extension de la bibliothèque cliente. Ces API aident à créer des visuels et à créer le rapport après son chargement. La bibliothèque powerbi-report-authoring vous permet de modifier par programmation vos rapports incorporés.
L’ensemble de documentation comprend également des articles qui expliquent comment utiliser les API, ainsi que des exemples de code. Les articles sont divisés en sections suivantes :
Vue d’ensemble - Informations supplémentaires sur l’analytique incorporée Power BI.
Playground présente : découvrez comment utiliser l’analytique incorporée dans vos applications rapidement à l’aide du terrain de jeu d’analytique incorporée Power BI.
Démarrer l’incorporation - Découvrez comment incorporer chacun des éléments Power BI tels que les rapports et les tableaux de bord.
concepts de base - Découvrez quelques-uns des concepts que chaque développeur doit connaître.
l’incorporation de rapports - Concepts d’incorporation supplémentaires applicables uniquement aux rapports.
opérations de rapport : ajustez votre rapport incorporé afin qu’il offre une meilleure expérience utilisateur à vos clients.
Incorporer des rapports pour votre organisation : créez de meilleurs rapports incorporés lors de l’incorporation à l’aide de l’incorporation pour votre organisation solution.
création de rapports - Articles dédiés aux API powerbi-report-authoring, ce qui vous permet de créer et de personnaliser des visualisations une fois le rapport chargé.
L’entrée Resources inclut des ressources utiles pour les développeurs Power BI.
Note
Il est recommandé de passer en revue ces articles lors de l’expérience avec le terrain de jeu d’analytique incorporée power BI .