Bookmarks Power BI en PBIR : anatomie des bugs et correction automatisée

Série : Automatiser Power BI avec Claude AI — Épisode 8/12 Temps de lecture : 13 min Public cible : BI Engineers avancés, Power BI Developers

TL;DR : Les bookmarks sont la fonctionnalité Power BI la moins bien documentée et la plus sujette aux bugs silencieux. Sur le projet client, 4 problèmes critiques ont été détectés : un bookmark ne ciblant qu’1 visuel sur 17, des groupes absents des bookmarks, 9 boutons cachés dans tous les états, et des conflits de z-order rendant des visuels invisibles. Le plan de correction en 4 étapes et le script Python d’audit sont réutilisables sur n’importe quel rapport PBIR.

python
# Résultat du scan
Bookmark "Chiffrage" : targetVisualNames: [17 IDs]  OK
Bookmark "En cours"  : targetVisualNames: [17 IDs]  OK
Bookmark "Terminés"  : targetVisualNames: ["visual_abc123"]  1 seul ID

• ID : “termin00000000000000”

• displayName : “Terminés Signet Overview”

• z-order : 52 000

• Enfants : 16 IDs de visuels Terminés

json
{
  "id": "3d929e68c755368d281a",
  "displayName": "Terminés",
  "explorationState": {
    "sections": {
      "overview": {
        "visualContainers": {
          "visual_001": {"display": "hidden"},
          "termin00000000000000": {"display": "visible"}
        },
        "visualContainerGroups": {
          "termin00000000000000": {"display": "visible"},
          "en_cours_group": {"display": "hidden"},
          "chiffrage_group": {"display": "hidden"}
        }
      }
    }
  },
  "options": {
    "applyOnlyToTargetVisuals": true,
    "targetVisualNames": [
      "termin00000000000000",
      "visual_001", "visual_002"
    ]
  }
}

python
import json
from pathlib import Path

def audit_bookmarks(report_path: str):
    report_dir = Path(report_path)
    bookmarks_dir = report_dir / "definition" / "bookmarks"

    if not bookmarks_dir.exists():
        print("Aucun bookmark trouvé")
        return

    # Collecter tous les IDs de visuels du rapport
    all_visual_ids = set()
    pages_dir = report_dir / "definition" / "pages"
    for page_dir in pages_dir.iterdir():
        if page_dir.is_dir():
            visuals_dir = page_dir / "visuals"
            if visuals_dir.exists():
                for visual_dir in visuals_dir.iterdir():
                    all_visual_ids.add(visual_dir.name)

    print(f"Visuels dans le rapport :{len(all_visual_ids)}\n")

    for bm_file in sorted(bookmarks_dir.iterdir()):
        with open(bm_file) as f:
            bm = json.load(f)

        name = bm.get("displayName", bm_file.name)
        targets = set(bm.get("options", {}).get("targetVisualNames", []))
        apply_only = bm.get("options", {}).get("applyOnlyToTargetVisuals", False)
        orphan_targets = targets - all_visual_ids

        print(f"==={name} ===")
        print(f"  Targets :{len(targets)}")
        print(f"  applyOnlyToTargetVisuals :{apply_only}")

        if not apply_only:
            print(f"  RISQUE : applyOnlyToTargetVisuals = false")
        if orphan_targets:
            print(f"  Targets orphelins :{orphan_targets}")
        if len(targets) <= 1:
            print(f"  Probablement incomplet")
        print()

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