Phase 5: Nachhalten Done with You · Done for You

Power-BI-Dokumentation direkt im Bericht

Wer ein Power-BI-Modell übernimmt oder weiterentwickelt, braucht das Wissen dahinter. Ein Demo-Bericht und eine Dokumentation zeigen, wie Sie es im Modell und im Bericht ablegen: Dokumente, Bilder und Webseiten direkt im Bericht, Versionsverlauf und Backlog im Modell, die Modellstruktur per Skript. Das Vorgehen lässt sich auf Ihr eigenes Modell übertragen.

Was beschäftigt Sie aktuell? Die drei Bereiche
3 Bereiche im Demo-Bericht
100+ Seiten Dokumentation
2 C#-Skripte ohne Roslyn
Power-BI-Dokumentation, Proofinity Guide KI-Bild
01

Wissen im Modell statt im Kopf

Beschreibungen, Versionsverlauf und Backlog stehen als Tabellen im Semantikmodell. Wer das Modell übernimmt, findet alles an einer Stelle.

02

Inhalte direkt im Bericht

PDF, HTML, Bilder und Webseiten erscheinen im Power-BI-Bericht, gespeist aus einem SharePoint-Ordner und mit jedem Refresh aktuell.

03

Ohne IT‑Freigabe starten

Die C#-Skripte laufen mit dem Compiler, den Tabular Editor 2 mitbringt. Roslyn, Visual Studio oder eine zusätzliche Installation sind nicht nötig.

Für wen ist das Modul?

Für BI-Entwickler, Berater und Power User

Das Modul ist technische Dokumentation für alle, die Power-BI-Modelle bauen, übernehmen oder weiterentwickeln. Ein Handbuch für Endanwender ist es nicht.

Modell nachvollziehbar machen

Tabellen, Spalten, Measures und Beziehungen werden mit Beschreibungen sichtbar, auch für Kollegen, die das Modell nicht selbst gebaut haben.

Dokumente zentral ausliefern

Anleitungen, Konzepte und Grafiken liegen in einem Ordner und erscheinen dort, wo sie gebraucht werden: im Bericht selbst.

Änderungen und Pläne festhalten

Versionsverlauf, Backlog und FAQ pflegen Sie als Tabellenzeile. Der Bericht zeigt jederzeit, was sich geändert hat und was als Nächstes kommt.

Schnell und ohne Hürden starten

Kostenlose Werkzeuge, zertifizierte Visuals als Option und Skripte ohne Zusatzinstallation. So vermeiden Sie lange Abstimmungen mit der IT.

Was der Demo-Bericht zeigt

Drei Bereiche in einem Bericht

Die Startseite der Demo führt zu Medien, Projektmanagement und Technischer Dokumentation. Jede Inhaltsseite hat links dasselbe Panel mit Formaten, Filtern und einem Schalter für helles und dunkles Design.

Medien · Bilder, Dokumente und Web-Inhalte Dateien aus einem SharePoint-Ordner, im Bericht angezeigt mit nativen Visuals oder HTML Content, auch in der zertifizierten Edition.
3 Kategorien
Demo-Seite Bilder in der Praxis-Ansicht mit einem Bergpanorama als JPEG im nativen Bild-VisualKI-Bild
Bilder

JPEG, PNG, SVG und GIF

Bilder liegen als Datei im Ordner und erscheinen im nativen Bild-Visual, ohne Custom Visual und ohne externe Links.

  • Dasselbe Bild im Vergleich: Bild-Visual, HTML Content, Tabelle, Matrix und Karte
  • Animierte GIF für Bedienhinweise, SVG für einfarbige Icons
  • Getestete Größengrenzen und der Umgang mit Calculation Groups
Demo-Seite Dokumente in der Praxis-Ansicht mit einer HTML-Einleitung in HTML Content
Dokumente

PDF und HTML im Bericht

Anleitungen und Konzepte lesen Sie direkt im Bericht, als PDF mit Blättern und Zoomen oder als HTML-Seite.

  • Volltextsuche über alle PDF-Seiten mit Trefferzähler
  • Seitenbilder für Berichte, die nur zertifizierte Visuals erlauben
  • Diese Moduldokumentation ist selbst eines der Demo-Dokumente
Demo-Seite Web-Inhalte in der Praxis-Ansicht mit der eingebetteten Webseite proofinity.eu
Web-Inhalte

Webseiten im Bericht

Externe Seiten wie ein Intranet, eine Dokumentation oder ein Werkzeug erscheinen eingebettet im Bericht.

  • Neue Webseiten ergänzen Sie als Tabellenzeile, der Code bleibt unverändert
  • Erlaubt eine Seite keine Einbettung, zeigt der Bericht den Grund und einen Link
Projektmanagement · Versionsverlauf, Backlog und FAQ Inhaltstabellen im Semantikmodell, im Bericht als HTML gerendert. Ein neuer Eintrag ist eine Tabellenzeile.
3 Tabs
Demo-Seite Projektmanagement mit dem Versionsverlauf und Filtern nach Kategorie, Typ und Status
Versionsverlauf

Was sich geändert hat

Jede Modelländerung ist eine Zeile mit Datum, Autor, Kategorie, Typ, Status und betroffenen Objekten. Der jüngste Eintrag steht oben.

  • Filter nach Kategorie, Typ und Status
  • Statusabzeichen zeigen, was getestet ist und was noch in Bearbeitung ist
Demo-Seite Projektmanagement mit dem Backlog und Filtern nach Priorität, Status und Verantwortlichem
Backlog

Was noch kommt

Geplante Erweiterungen mit Priorität, Status, Verantwortlichem und Zieldatum, in derselben Gestaltung wie der Versionsverlauf.

  • Filter nach Priorität, Status und Verantwortlichem
  • Neue Einträge ergänzen Sie, ohne das Measure zu ändern
Demo-Seite Projektmanagement mit dem FAQ als Akkordeon und einer Suche im Panel
FAQ

Wiederkehrende Fragen

Antworten auf wiederkehrende Fragen stehen im Bericht. Ein Klick auf die Frage klappt die Antwort auf, ohne dass Nutzer den Bericht verlassen.

  • Suche über Frage und Antwort mit Trefferzahl
  • Das Aufklappen kommt ohne JavaScript aus und funktioniert deshalb zuverlässig im Custom Visual
Technische Dokumentation · Modell und Hinweise Die Struktur des Semantikmodells direkt im Bericht, erzeugt mit einem Skript für Tabular Editor.
7 Tabs
Demo-Seite Technische Dokumentation mit dem Tab Measures: Anzeigeordner, Beschreibung, Ausdruck und Sichtbarkeit je Measure
Modell

Tabellen, Spalten, Measures und Beziehungen

Vier Tabs zeigen die Objekte des Semantikmodells mit ihren Beschreibungen. Mit den Filtern nach Tabelle und Anzeigeordner und der Suche finden Sie ein Measure schnell.

  • Daten aus den INFO-Funktionen von Power BI, immer auf dem Stand des Modells
  • Je Measure Beschreibung, Format String, Ausdruck und Sichtbarkeit
  • Ein Skript legt Tabellen und Measures an, die Berichtsseite wird kopiert
Demo-Seite Technische Dokumentation mit dem Tab Architektur und dem Architekturbild
Hinweise

Architektur, Glossar und Disclaimer

Drei weitere Tabs ergänzen, was nicht in den Metadaten des Modells steht.

  • Architekturbild der Datenstrecke von der Quelle bis zum Visual
  • Glossar und Disclaimer im selben Panel wie die Modell-Tabs
TheoriePraxis

Umschalten auf Knopfdruck

Jede Inhaltsseite hat einen Umschalter: Theorie erklärt das Verfahren mit einer Infografik, Praxis zeigt das echte Visual.

Ein weiterer Schalter wechselt zwischen hellem und dunklem Design. Infografiken, HTML-Seiten, Tabellen und Slicer wechseln gemeinsam, weil alle Farben aus einem zentralen Measure kommen.

Startseite der Demo mit den drei Kacheln Medien, Projektmanagement und Technische Dokumentation KI-Bild

Startseite der Demo im hellen Design: drei Bereiche, je eine Kachel.

Was steckt in der Dokumentation?

Über 100 Seiten, gegliedert in fünf Phasen

Die Dokumentation führt vom Ressourcen-Hub über das Doku-Konzept und die Umsetzung in Power Query, Semantikmodell und Bericht bis zur Pflege im Power BI Service.

Power Query lesbar halten

Kommentare, Formatierung, Parameter und eine Custom Function Library, die alle Funktionen in einer Abfrage bündelt.

Beschreibungen per Excel

Ein Skript exportiert alle Beschreibungen nach Excel und wieder zurück, wahlweise mit Vorschlägen einer Cloud-KI oder eines lokalen Modells.

Dokumentation im Modell

INFO-Tabellen und Measures für die Seite Technische Dokumentation, angelegt mit einem Skript und übertragen mit dem Power BI MultiTool.

Measures verstehen

Formatierung und Kommentare in DAX, Abhängigkeiten zwischen Measures als Mermaid-Diagramm und im TMDL Explorer.

Inhalte im Bericht

Schritt für Schritt zu PDF, HTML, Bildern, Webseiten, FAQ, Versionsverlauf und Backlog, mit getesteten Grenzen je Format.

Sichern und nachverfolgen

TMDL-Backups als Momentaufnahme des Modells und die Lineage View im Power BI Service für Abhängigkeiten zwischen Inhalten.

So kommt das Modul zum Einsatz

Als Baustein in unseren Leistungen

Wir setzen das Modul in Training, Coaching und Projekten ein, damit Ihr Team das Modell selbst dokumentieren und weiterentwickeln kann.

Training

Ihr Team lernt die Werkzeuge an der Demo kennen und dokumentiert anschließend das erste eigene Modell.

Training ansehen

Coaching

Wir begleiten die Übertragung auf Ihr Modell, von den Beschreibungen bis zur Seite Technische Dokumentation.

Coaching ansehen

Individuelles Projekt

Wir dokumentieren Ihr Modell und richten die Inhalte im Bericht für Sie ein, inklusive SharePoint-Ordner und Übergabe.

Projekt ansehen

Dokumentation, die gelesen wird.

Sie möchten Ihr Modell dokumentieren oder Anleitungen direkt im Bericht bereitstellen? Erzählen Sie uns, worum es geht, wir melden uns zeitnah.

Was beschäftigt Sie aktuell? Preise ansehen
Das Modul-Framework

Das könnte Sie auch interessieren

Foundation

Voraussetzung

Das Foundation-Modell ist vollständig dokumentiert und zeigt, wie Diagramme und Skripte des Dokumentationsmoduls in der Praxis aussehen.

Modul ansehen

Sicherheit

Kompatibel

Rollen, Regeln und Testfälle gehören in die technische Dokumentation, damit Freigaben später nachvollziehbar bleiben.

Modul ansehen

Design Playbook

Voraussetzung

Themes, Layouts und Gestaltungsregeln werden in der Dokumentation festgehalten, damit neue Berichtsseiten im selben Stil entstehen.

Modul ansehen
Häufige Fragen

Fragen zur Dokumentation in Power BI

Lässt sich das auf mein bestehendes Modell übertragen?

Ja, das ist der Standardfall. Die Skripte arbeiten mit jedem Semantikmodell, die Dokumentationstabellen und die Berichtsseiten übernehmen Sie in Ihren Bericht. Den Ablauf beschreibt die Dokumentation Schritt für Schritt.

Brauche ich Roslyn oder eine Freigabe durch die IT?

Nein. Die Skripte sind in C# 5 geschrieben und laufen mit dem Compiler, den Tabular Editor 2 über das .NET Framework mitbringt. Roslyn, Visual Studio oder Build Tools sind nicht nötig. In Tabular Editor 3 laufen sie unverändert.

Funktioniert das auch, wenn nur zertifizierte Visuals erlaubt sind?

Ja, mit Einschränkungen. Bilder laufen über das native Bild-Visual, Dokumente über die zertifizierte Edition von HTML Content und als Seitenbilder. Eingebettete Webseiten brauchen dagegen die Standard-Edition.

Wo liegen die Dateien, und wie groß dürfen sie sein?

In einem SharePoint-Ordner, für Tests genügt ein lokaler Ordner. Power Query lädt die Dateien beim Refresh und zerlegt sie in Abschnitte, die das Modell wieder zusammensetzt. Je Datei liegt die Grenze bei rund 1,5 MB, die Dokumentation nennt die getesteten Werte je Format.

Ist das ein Handbuch für die Anwender meiner Berichte?

Nein. Das Modul ist technische Dokumentation für alle, die Modelle bauen und pflegen. Eine Bedienungsanleitung für Endanwender ist ein eigenes Dokument. Über die Seite Dokumente lässt sie sich aber genauso im Bericht bereitstellen.

Kostenloses Erstgespräch

30 Minuten, kostenlos und unverbindlich.

Keine Werbung. Kein Newsletter-Abo. Datenschutz: proofinity.eu/datenschutz