top of page
Suche

Power BI Theme Datei reparieren

Aktualisiert: 23. Okt.

JSON Fehler beheben mit Visual Studio Code

Wenn du schon länger mit Power BI arbeitest, hast du vermutlich irgendwann eine Theme-Datei erstellt, um Farben, Schriftarten oder Stile projektspezifisch festzulegen. Diese Themes sind ein praktisches Mittel, um Berichte konsistent zu gestalten und gleichzeitig Designrichtlinien einzuhalten.


Manchmal kommt es aber vor, dass ältere Theme-Dateien in neueren Power BI Desktop Versionen plötzlich nicht mehr funktionieren. Du möchtest sie importieren – und bekommst die Fehlermeldung, dass die Datei nicht mehr dem gültigen Standard entspricht. Genau an dieser Stelle setzt dieses Tutorial an. Ich zeige dir, wie du solche fehlerhaften JSON-Dateien analysieren und reparieren kannst, damit du sie weiterhin nutzen kannst.



Das Problem: Alte Theme-Dateien und neue Standards

Die Theme-Dateien in Power BI basieren auf dem JSON-Format. Microsoft entwickelt Power BI kontinuierlich weiter, und mit neuen Versionen ändern sich manchmal auch die Anforderungen an diese JSON-Struktur.


Das führt dazu, dass Themes, die vor ein oder zwei Jahren problemlos funktioniert haben, heute eine Fehlermeldung erzeugen, wenn du sie importierst. In der Regel lautet die Meldung sinngemäß, dass die Datei nicht validiert werden konnte, weil sie nicht dem erwarteten Schema entspricht.


Für dich als Anwender bedeutet das: Du musst herausfinden, welches Element oder welche Eigenschaft im JSON fehlerhaft ist – und genau das ist ohne Hilfsmittel kaum lesbar oder verständlich.


Der erste Schritt: Die richtige Schema-Datei finden

Microsoft stellt für Power BI Theme-Dateien ein sogenanntes „Schema“ bereit. Dieses Schema beschreibt, wie eine gültige Theme-Datei aufgebaut sein muss: welche Felder erlaubt sind, welche Datentypen erwartet werden und welche optional sind.


In der offiziellen Dokumentation findest du eine Übersicht über die aktuellen Schemas: Format der JSON-Datei für Berichtsdesigns

Und auf GitHub liegt das Repository mit den eigentlichen Schema-Dateien:


Hier kannst du die Schema-Version auswählen, die zu deiner Power BI Desktop Version passt. Meist reicht es, die neueste Datei zu verwenden.


Der zweite Schritt: JSON-Datei in Visual Studio Code öffnen

Um deine Theme-Datei zu überprüfen, brauchst du ein Tool, das JSON-Strukturen lesen und gegen ein Schema validieren kann. Der kostenlose Editor Visual Studio Code eignet sich dafür hervorragend.

Wenn du die Theme-Datei (.json) öffnest, siehst du zunächst eine reine Textstruktur – mit vielen geschweiften Klammern, Kommas und Einrückungen. Das ist zwar technisch korrekt, hilft dir aber noch nicht, den Fehler zu erkennen.


Deshalb verknüpfst du jetzt die Datei mit dem Microsoft Schema. In der Dokumentation von Visual Studio Code ist beschrieben, wie das funktioniert: Editing JSON mit Visual Studio Code


Im Wesentlichen legst du in deinem Workspace eine kleine Konfigurationsdatei namens settings.json an, in der du den Pfad zu deiner Theme-Datei und die URL zum Schema einträgst.

Ein Beispiel für diesen Eintrag sieht so aus:

{
    "json.schemas": [
        {
            "fileMatch": ["*.theme.json"],
            "url": "https://raw.githubusercontent.com/microsoft/powerbi-desktop-samples/main/Report%20Theme%20JSON%20Schema/July2024/schema.json"
        }
    ]
}

Speichere diese Einstellung und benenne deine Theme-Datei so um, dass sie zur Dateierweiterung im Mapping passt – also zum Beispiel meinDesign.theme.json.


Der dritte Schritt: Fehler identifizieren und beheben

Sobald die Verknüpfung aktiv ist, überprüft Visual Studio Code automatisch deine Theme-Datei gegen das Schema. Fehlerhafte Einträge werden direkt im Code gelb markiert. Wenn du mit der Maus darüberfährst, bekommst du eine Beschreibung, warum der Eintrag ungültig ist – etwa, weil ein Wert fehlt, ein falscher Typ angegeben wurde oder eine Eigenschaft veraltet ist.


Ein typischer Fehler ist beispielsweise ein Attribut ohne gültigen Wert. Im Video zeige ich einen Fall, bei dem innerhalb der Formatierung ein Eintrag "solid": {} vorhanden war. Laut Schema muss hier aber ein Farbwert hinterlegt sein. Die einfachste Lösung ist, diesen Abschnitt zu löschen, wenn keine Farbe angegeben ist.


Nach der Korrektur speicherst du die Datei und schaust, ob Visual Studio Code noch weitere Fehler anzeigt. Sobald keine Markierungen mehr vorhanden sind, gilt deine Datei als valide.


Der vierte Schritt: Die reparierte Datei testen

Jetzt kommt der praktische Teil. Öffne Power BI Desktop, gehe zu Ansicht → Designs → Durchsuchen und wähle deine korrigierte Theme-Datei aus. Wenn alles funktioniert hat, kannst du das Design wieder importieren und verwenden. Power BI sollte keine Fehlermeldung mehr anzeigen.

Falls du möchtest, kannst du die reparierte Datei anschließend als neue Vorlage speichern, damit du beim nächsten Mal gleich auf eine gültige Version zurückgreifen kannst.


Warum sich dieser Aufwand lohnt

Auch wenn das Reparieren einer Theme-Datei auf den ersten Blick technisch klingt, lernst du dabei etwas, das dir in vielen Situationen hilft: den Umgang mit JSON und den Wert einer strukturierten Validierung. Gerade wenn du regelmäßig eigene Themes, Farbpaletten oder Formatvorlagen in Power BI nutzt, ist es sinnvoll zu wissen, wie du solche Dateien eigenständig prüfen kannst.


Visual Studio Code bietet dir hier ein Werkzeug, das dich unabhängig von der Power BI Oberfläche macht und dir gleichzeitig hilft, Fehler zu verstehen, statt sie nur zu umgehen.

Fazit zu Power BI Theme Datei reparieren

Wenn deine Power BI Theme Datei nicht mehr importiert werden kann, ist das kein Grund, sie aufzugeben. Mit ein paar Handgriffen kannst du sie validieren, korrigieren und wieder zum Laufen bringen.


Ich hoffe, dieser Beitrag hilft dir, deine eigenen Designs zu retten – und vielleicht auch ein bisschen neugierig zu werden, wie viel Power BI eigentlich unter der Haube bietet, wenn man mal hinter die Oberfläche schaut.


Falls du das Ganze lieber in Aktion sehen möchtest: Auf meinem YouTube-Kanal Daten-WG findest du das passende Video dazu.Und wenn du magst, hinterlass gerne Feedback oder eigene Erfahrungen in den Kommentaren.

Wenn du neugierig geworden bist, welche weiteren Möglichkeiten in Power BI stecken und du deine Fähigkeiten erweitern möchtest, dann schau dir unser Power BI Training auf der Daten-WG Website an. In diesem Training gehen wir tiefer in die Praxis, zeigen fortgeschrittene Use Cases und viele Tipps aus echten Projekten.

bottom of page