# Fiche connecteur Microsoft Power BI Catalogue Pipedream : connexion du compte et droits nécessaires. Les actions réellement utilisables sont vérifiées dans Bruno lors de la connexion. Les déclencheurs sont documentés à titre de référence et ne sont pas activés automatiquement dans Bruno. Les noms et données des exemples sont fictifs ; toute exécution reste soumise aux droits et aux validations du connecteur. ## Microsoft Power BI URL : https://get-bruno.com/features/connectors/microsoft-power-bi Référence texte : https://get-bruno.com/features/connectors/microsoft-power-bi/reference.txt Origine : Catalogue Pipedream Statut : Catalogue Pipedream — connexion à vérifier Catégories : Analyse de données Description : Microsoft Power BI sert à visualiser des données et à exploiter des rapports, des jeux de données et des tableaux de bord dans un espace de travail Power BI. Ce connecteur donne accès à des lectures ciblées, à des requêtes DAX, à l’actualisation des jeux de données et à l’export de rapports. Authentification : OAuth Présentation : Microsoft Power BI sert à visualiser des données et à exploiter des rapports, des jeux de données et des tableaux de bord dans un espace de travail Power BI. Ce connecteur donne accès à des lectures ciblées, à des requêtes DAX, à l’actualisation des jeux de données et à l’export de rapports. Usage : Consulter un indicateur dans un jeu de données Exemple de demande : Je veux vérifier le total des ventes du jeu de données Ventes 2024 dans l’espace Partage Finance. Résultat attendu : Retour d’un résultat DAX ciblé, par exemple un total, un filtre ou un sous-ensemble de lignes selon la requête. À préciser : Le nom de l’espace de travail ou laisser My workspace si c’est l’espace personnel. ; Le nom du jeu de données Ventes 2024 ou son identifiant si déjà connu. ; La mesure ou la table à interroger, par exemple un total de ventes ou les lignes de la table Commandes. Nature : Exemple sous réserve de connexion et de droits Sources de l’exemple : https://pipedream.com/apps/microsoft-power-bi/actions/list-workspaces ; https://pipedream.com/apps/microsoft-power-bi/actions/list-datasets ; https://pipedream.com/apps/microsoft-power-bi/actions/execute-dax-query Usage : Exporter un rapport en PDF Exemple de demande : Je veux exporter le rapport Synthèse mensuelle en PDF pour l’espace Commercial. Résultat attendu : Un export du rapport au format demandé, avec le fichier renvoyé après traitement asynchrone si le rapport et la capacité le permettent. À préciser : Le nom de l’espace de travail ou laisser My workspace si c’est l’espace personnel. ; Le nom du rapport Synthèse mensuelle ou son identifiant. ; Le format souhaité, par exemple PDF, ainsi que les pages à inclure si l’export doit être limité. Nature : Exemple sous réserve de connexion et de droits Sources de l’exemple : https://pipedream.com/apps/microsoft-power-bi/actions/list-workspaces ; https://pipedream.com/apps/microsoft-power-bi/actions/list-reports ; https://pipedream.com/apps/microsoft-power-bi/actions/export-report Usage : Lancer une actualisation d’un jeu de données Exemple de demande : Je veux lancer l’actualisation du jeu de données Catalogue Produits dans l’espace Données partagées. Résultat attendu : Un départ d’actualisation avec un identifiant de demande à suivre ensuite dans l’historique des actualisations. À préciser : Le nom de l’espace de travail ou laisser My workspace si c’est l’espace personnel. ; Le nom du jeu de données Catalogue Produits ou son identifiant. ; Le besoin de notification de fin ou d’échec si une alerte est souhaitée. Nature : Exemple sous réserve de connexion et de droits Sources de l’exemple : https://pipedream.com/apps/microsoft-power-bi/actions/list-workspaces ; https://pipedream.com/apps/microsoft-power-bi/actions/list-datasets ; https://pipedream.com/apps/microsoft-power-bi/actions/refresh-dataset ; https://pipedream.com/apps/microsoft-power-bi/actions/get-refresh-history Limites propres au service : Les rapports ne sont pas créés par l’API de ce catalogue ; ils sont publiés depuis Power BI Desktop. Les tableaux de bord ne sont pas créés par l’API de ce catalogue ; ils sont construits dans le service Power BI. Pour les jeux de données Push, l’ajout de lignes ne met à jour que les données ajoutées ; les lignes individuelles ne sont pas modifiables ni supprimables. L’export de rapport dépend d’une capacité Premium, Premium Per User ou Embedded pour les rapports concernés. Vocabulaire français : Ajouter des lignes à une table de jeu de données — Ajoute de nouvelles lignes à une table précise dans un jeu de données situé dans Mon espace de travail. (https://pipedream.com/apps/microsoft-power-bi/actions/add-rows-dataset-table) Vocabulaire français : Ajouter des lignes à un jeu de données Push — Ajoute des lignes à un jeu de données Push, uniquement pour des jeux de données créés via l’API REST avec le mode Push. (https://pipedream.com/apps/microsoft-power-bi/actions/add-rows-to-push-dataset) Vocabulaire français : Annuler l’actualisation d’un jeu de données — Interrompt une opération d’actualisation en cours pour un jeu de données donné. (https://pipedream.com/apps/microsoft-power-bi/actions/cancel-refresh) Vocabulaire français : Créer un jeu de données — Crée un nouveau jeu de données Push dans Power BI. (https://pipedream.com/apps/microsoft-power-bi/actions/create-dataset) Vocabulaire français : Exécuter une requête DAX — Exécute une requête DAX sur un jeu de données pour lire des valeurs, des agrégats ou des lignes filtrées. (https://pipedream.com/apps/microsoft-power-bi/actions/execute-dax-query) Vocabulaire français : Exporter un rapport — Exporte un rapport Power BI en PDF, PPTX ou PNG, puis renvoie le fichier généré. (https://pipedream.com/apps/microsoft-power-bi/actions/export-report) Vocabulaire français : Déclencher l’actualisation d’un jeu de données — Déclenche l’actualisation d’un jeu de données Power BI. (https://pipedream.com/apps/microsoft-power-bi/actions/get-dataset-refresh) Vocabulaire français : Obtenir l’historique des actualisations — Récupère l’historique des actualisations d’un jeu de données avec l’état et les horodatages. (https://pipedream.com/apps/microsoft-power-bi/actions/get-refresh-history) Vocabulaire français : Obtenir un rapport par identifiant — Récupère les métadonnées d’un rapport Power BI précis à partir de son identifiant. (https://pipedream.com/apps/microsoft-power-bi/actions/get-reports-by-id) Vocabulaire français : Obtenir les rapports — Liste les rapports disponibles dans un espace de travail Power BI. (https://pipedream.com/apps/microsoft-power-bi/actions/get-reports) Vocabulaire français : Lister les tableaux de bord — Liste les tableaux de bord d’un espace de travail Power BI. (https://pipedream.com/apps/microsoft-power-bi/actions/list-dashboards) Vocabulaire français : Lister les jeux de données — Liste les jeux de données d’un espace de travail et fournit les identifiants utiles pour les autres opérations. (https://pipedream.com/apps/microsoft-power-bi/actions/list-datasets) Vocabulaire français : Lister les rapports — Liste les rapports d’un espace de travail avec leurs identifiants, leurs liens et leur type. (https://pipedream.com/apps/microsoft-power-bi/actions/list-reports) Vocabulaire français : Lister les espaces de travail — Liste les espaces de travail accessibles par l’utilisateur et renvoie leurs identifiants. (https://pipedream.com/apps/microsoft-power-bi/actions/list-workspaces) Vocabulaire français : Actualiser un jeu de données — Déclenche une actualisation d’un jeu de données et renvoie une acceptation asynchrone. (https://pipedream.com/apps/microsoft-power-bi/actions/refresh-dataset) Vocabulaire français : Événement : actualisation de jeu de données terminée — Émet un événement quand une actualisation de jeu de données se termine. (https://pipedream.com/apps/microsoft-power-bi/triggers/dataset-refresh-completed) Vocabulaire français : Événement : actualisation de jeu de données échouée — Émet un événement quand une actualisation de jeu de données échoue. (https://pipedream.com/apps/microsoft-power-bi/triggers/dataset-refresh-failed) Vocabulaire français : Événement : création d’une actualisation de jeu de données — Émet un événement quand une nouvelle actualisation de jeu de données est créée. (https://pipedream.com/apps/microsoft-power-bi/triggers/new-dataset-refresh-created) - action : Add Rows to Dataset Table — Adds new data rows to the specified table within the specified dataset from My workspace. See the documentation (https://pipedream.com/apps/microsoft-power-bi/actions/add-rows-dataset-table) - action : Add Rows To Push Dataset — Append rows to a table in a Power BI Push Dataset (streaming / realtime data). Only works for datasets created via the REST API with defaultMode: Push — these datasets expose addRowsAPIEnabled: true on the object returned by List Datasets . Use List Datasets first to resolve a dataset name → datasetId and inspect its tables for the exact tableName (case-sensitive). Pass workspaceId (from List Workspaces ) or workspaceName to target a specific workspace, or omit both for My workspace. Rows must match the table's column schema. rows accepts either a JSON array ( [{...}, {...}] ) or a JSON-stringified array. Each row is an object of columnName → value . Common mistakes: (1) case mismatch on tableName returns 404 — copy the exact string from the dataset's tables array. (2) Sending values that don't match the declared column data type returns RequestedResourceNotFound or DMTS_DatasourceHasNoCredentialsError . Push-dataset rows have no individual IDs and cannot be updated or deleted — only appended or bulk-cleared. See the documentation (https://pipedream.com/apps/microsoft-power-bi/actions/add-rows-to-push-dataset) - action : Cancel Dataset Refresh — Cancels a refresh operation for a specified dataset in Power BI. See the documentation (https://pipedream.com/apps/microsoft-power-bi/actions/cancel-refresh) - action : Create Dataset — Creates a new Push Dataset in Power BI. See the documentation (https://pipedream.com/apps/microsoft-power-bi/actions/create-dataset) - action : Execute DAX Query — Execute a DAX (Data Analysis Expressions) query against a Power BI dataset (semantic model). This is the primary analytics tool — use it to answer questions about values, aggregates, or filtered rows in a dataset. Use List Datasets first to resolve a dataset name → datasetId . The query must be a single valid DAX expression starting with EVALUATE . Table discovery (standard datasets): For datasets published from Power BI Desktop, the REST GET /datasets/{id}/tables endpoint is scoped to push datasets only and will not list tables. Use EVALUATE INFO.TABLES() instead — it returns every table name in the semantic model. Typical agent flow: List Workspaces → List Datasets → Execute DAX Query ( EVALUATE INFO.TABLES() ) → Execute DAX Query ( EVALUATE 'TableName' ). Common patterns: • Discover all tables — EVALUATE INFO.TABLES() (use this before querying an unknown dataset) • List all rows of a table — EVALUATE 'Species' • Filter — EVALUATE FILTER('Species', 'Species'[dietType] = "Carnivore") • Top N by column — EVALUATE TOPN(5, 'Species', 'Species'[weightKg], DESC) • Aggregate single value — EVALUATE ROW("Total", SUMX('Species', 'Species'[weightKg])) • Peek at a table's columns — EVALUATE TOPN(0, 'Species') (returns an empty rowset with column names in the response). Limits: max 100,000 rows or 1,000,000 values per query, and DEFINE /multiple-statement queries are not supported via REST. The tenant must have 'Dataset Execute Queries REST API' enabled (admin setting) or the call returns 401/403. Pass workspaceId (from List Workspaces ) or workspaceName to target a specific workspace, or omit both for My workspace. See the documentation (https://pipedream.com/apps/microsoft-power-bi/actions/execute-dax-query) - action : Export Report — Export a Power BI report to a file format such as PDF, PPTX, or PNG. Requires a report ID (use List Reports to find it) and defaults to PDF if no format is given. Pass workspaceId (from List Workspaces ) or workspaceName to target a specific workspace, or omit both for My workspace. Supported format values depend on the report type: Power BI reports support PDF , PPTX , PNG . Paginated reports additionally support CSV , XLSX , DOCX , XML , MHTML . This API is Premium-only : requires the workspace to be backed by Premium capacity, Premium Per User, or Embedded capacity. On shared (free) capacity it returns FixedCapacityLimitExceeded / 403. The export is asynchronous — this tool starts the export, then polls until the job reaches Succeeded or Failed (or pollTimeoutSeconds elapses), then downloads the file and returns it as base64 along with the job metadata. PNG exports only work for single-page reports. For PPTX/PDF, pass pages (array of page names, e.g., ["ReportSection", "ReportSection1"] ) to limit the export. See the documentation (https://pipedream.com/apps/microsoft-power-bi/actions/export-report) - action : Get Dataset Refresh — Triggers a refresh operation for a specified Power BI dataset. See the documentation (https://pipedream.com/apps/microsoft-power-bi/actions/get-dataset-refresh) - action : Get Refresh History — Get the refresh history for a Power BI dataset. Use List Datasets first to resolve a dataset name → datasetId . Pass workspaceId (from List Workspaces ) or workspaceName to scope to a specific workspace, or omit both for My workspace. Each entry includes requestId , refreshType ( OnDemand , Scheduled , ViaApi , etc.), startTime , endTime , status ( Completed , Failed , Disabled , Cancelled , Unknown — Unknown means still in progress), and serviceExceptionJson on failures. See the documentation (https://pipedream.com/apps/microsoft-power-bi/actions/get-refresh-history) - action : Get Report by id — Retrieve metadata for a single Power BI report by ID. Uses My workspace by default; set Workspace (Group) ID for a specific workspace. See the documentation (https://pipedream.com/apps/microsoft-power-bi/actions/get-reports-by-id) - action : Get Reports — Get reports from a Power BI workspace. See the documentation (https://pipedream.com/apps/microsoft-power-bi/actions/get-reports) - action : List Dashboards — List Power BI dashboards in a workspace. Defaults to the authenticated user's personal My workspace when no workspace is specified. Pass workspaceId (preferred, from List Workspaces ) OR workspaceName to scope to a specific workspace. Each dashboard includes id , displayName , isReadOnly , webUrl , and embedUrl . Note: dashboards cannot be created via the REST API — they are built interactively in the Power BI service. See the documentation (https://pipedream.com/apps/microsoft-power-bi/actions/list-dashboards) - action : List Datasets — List Power BI datasets (semantic models) in a workspace. Defaults to the authenticated user's personal My workspace when no workspace is specified. Pass workspaceId (preferred, from List Workspaces ) OR workspaceName to scope to a specific workspace. Each dataset includes id , name , webUrl , addRowsAPIEnabled (true for Push Datasets), isRefreshable , and defaultMode ( Push , Streaming , PushStreaming , AsOnPrem , AsAzure ). Use this tool to resolve a dataset name → ID before calling Refresh Dataset , Execute DAX Query , Get Refresh History , or Add Rows To Push Dataset . For push-dataset row inserts, call the dataset's GET tables endpoint (not exposed as a separate tool) by inspecting the dataset's name → tables are defined at dataset creation; the table name is the string configured at creation time (e.g., Species ). See the documentation (https://pipedream.com/apps/microsoft-power-bi/actions/list-datasets) - action : List Reports — List Power BI reports in a workspace. Defaults to the authenticated user's personal My workspace when no workspace is specified. Pass workspaceId (preferred, from List Workspaces ) OR workspaceName to scope to a specific workspace — the tool resolves the name to an ID server-side. Each report includes id , name , webUrl , embedUrl , datasetId , and reportType ( PowerBIReport or PaginatedReport ). Note: reports cannot be created via the REST API — they are published from Power BI Desktop. See the documentation (https://pipedream.com/apps/microsoft-power-bi/actions/list-reports) - action : List Workspaces — List the Power BI workspaces (groups) the authenticated user can access. Use this tool first whenever the user refers to a workspace by name — it returns the id you need to pass as workspaceId to other tools. Power BI has no /me endpoint, so the set of accessible workspaces is the user's primary context (the 'who am I' signal for this app). Every item in the response includes id , name , isReadOnly , isOnDedicatedCapacity , and type . Note: when a user says 'my workspace' without a name, they may mean personal My workspace (implicit — pass no workspaceId to other tools) OR a specific named workspace — ask only if ambiguous. See the documentation (https://pipedream.com/apps/microsoft-power-bi/actions/list-workspaces) - action : Refresh Dataset — Trigger a refresh of a Power BI dataset. Returns 202 Accepted on success; the request ID is available in the Location response header (last path segment) and x-ms-request-id header — use Get Refresh History to check status. Use List Datasets first to resolve a dataset name → datasetId . Pass workspaceId (from List Workspaces ) or workspaceName to target a specific workspace, or omit both for My workspace. notifyOption controls email notifications on refresh outcome: NoNotification (default), MailOnCompletion , or MailOnFailure . Power BI Pro licenses allow up to 8 scheduled refreshes per day; Premium allows 48. Note: Push datasets accept this endpoint but the refresh is metadata-only (tile refresh), not a data refresh — no cancellable history entry is produced. See the documentation (https://pipedream.com/apps/microsoft-power-bi/actions/refresh-dataset) - trigger : Dataset Refresh Completed — Emit new event when a dataset refresh operation has completed. See the documentation (https://pipedream.com/apps/microsoft-power-bi/triggers/dataset-refresh-completed) - trigger : Dataset Refresh Failed — Emit new event when a dataset refresh operation has failed in Power BI. See the documentation (https://pipedream.com/apps/microsoft-power-bi/triggers/dataset-refresh-failed) - trigger : New Dataset Refresh Created — Emit new event when a new dataset refresh operation is created. See the documentation (https://pipedream.com/apps/microsoft-power-bi/triggers/new-dataset-refresh-created)