Format PBIR décrypté : ce qui se cache dans vos fichiers Power BI

Série : Automatiser Power BI avec Claude AI — Épisode 5/12 Temps de lecture : 12 min Public cible : BI Engineers, Développeurs Power BI, Architectes Data

TL;DR : Le format PBIR (Power BI Report) décompose un rapport Power BI en fichiers JSON lisibles : chaque visuel est un fichier de 150 à 300 lignes, chaque page un dossier, chaque bookmark un objet JSON avec des targets explicites. 6 concepts clés à maîtriser : IDs de visuels, z-order, bookmarks, groupes de visuels, actions de navigation, et bindings DAX. Ce format — introduit par Microsoft en 2023 — est ce qui rend l’automatisation par LLM possible.

• Pas de diff Git lisible. Vous ne pouvez pas voir “qu’est-ce qui a changé entre la version de lundi et celle de vendredi”. Juste “le fichier a changé”.

• Pas de scripting. Vous ne pouvez pas automatiser la création ou la modification de visuels sans passer par l’interface graphique.

• Pas d’analyse statique. Vous ne pouvez pas détecter des erreurs DAX, des références cassées, ou des visuels orphelins sans ouvrir le rapport.

plain text
MonProjet.pbip              <- Fichier de projet (ouvre Power BI)
  MonRapport.Report/        <- Dossier PBIR
    definition/
      pages/
      bookmarks/
      report.json
    .platform
  MonModèle.SemanticModel/  <- Modèle de données séparé
    definition/
      tables/
      relationships/
      model.bim
    .platform

json
{
  "name": "Vue d'ensemble",
  "displayName": "Vue d'ensemble",
  "filters": [],
  "visualContainers": [...],
  "config": {
    "layouts": [
      {
        "id": 0,
        "layoutItemsConfig": [...]
      }
    ]
  }
}

json
{
  "id": "card_montant_ao_001",
  "x": 20,
  "y": 80,
  "z": 1000,
  "width": 180,
  "height": 100,
  "config": {
    "name": "card_montant_ao_001",
    "singleVisual": {
      "visualType": "card",
      "projections": {
        "Values": [
          {
            "queryRef": "Mesures.Montant AO Total"
          }
        ]
      },
      "vcObjects": {
        "title": [
          {
            "properties": {
              "text": {
                "expr": {
                  "Literal": {
                    "Value": "'Montant AO Total'"
                  }
                }
              }
            }
          }
        ]
      }
    }
  }
}

json
{
  "id": "bookmark_en_cours",
  "displayName": "En cours",
  "explorationState": {
    "sections": {
      "overview": {
        "visualContainers": {
          "group_en_cours": { "display": "visible" },
          "group_termines": { "display": "hidden" }
        }
      }
    }
  },
  "options": {
    "applyOnlyToTargetVisuals": true,
    "targetVisualNames": ["group_en_cours", "group_termines"]
  }
}

json
"vcObjects": {
  "action": [{
    "properties": {
      "type": { "expr": { "Literal": { "Value": "'TabNavigation'" } } },
      "navigationSection": { "expr": { "Literal": { "Value": "'page_achats'" } } }
    }
  }]
}

json
"projections": {
  "Values": [{
    "queryRef": "Mesures.Montant AO Total",
    "active": true
  }]
}

python
import json
import os
from pathlib import Path

def explore_pbir(report_path: str):
    """Explore la structure d'un rapport PBIR."""
    report_dir = Path(report_path)

    # Pages
    pages_dir = report_dir / "definition" / "pages"
    print(f"\n=== PAGES ({len(list(pages_dir.iterdir()))}) ===")

    for page_dir in sorted(pages_dir.iterdir()):
        if page_dir.is_dir():
            page_json = page_dir / "page.json"
            if page_json.exists():
                with open(page_json) as f:
                    page = json.load(f)
                visuals_dir = page_dir / "visuals"
                visuals_count = len(list(visuals_dir.iterdir())) if visuals_dir.exists() else 0
                print(f"{page.get('displayName', page_dir.name)}:{visuals_count} visuels")

    # Bookmarks
    bookmarks_dir = report_dir / "definition" / "bookmarks"
    if bookmarks_dir.exists():
        print(f"\n=== BOOKMARKS ({len(list(bookmarks_dir.iterdir()))}) ===")
        for bm_file in sorted(bookmarks_dir.iterdir()):
            with open(bm_file) as f:
                bm = json.load(f)
            targets = bm.get("options", {}).get("targetVisualNames", [])
            print(f"{bm.get('displayName')}:{len(targets)} targets")

explore_pbir("./App-Infra-Report.Report")

• Pas de support pour les visuels custom (AppSource : Charticulator, Deneb, etc.)

• Les images embedded sont en base64 directement dans le JSON

• Pas de validation de schéma officielle — la documentation Microsoft est incomplète

• Breaking changes potentiels entre versions de Power BI Desktop