Wie aktiviere ich Tooltips für benutzerdefinierte Visuals in Power BI Desktop?
- Einführung in Tooltips bei benutzerdefinierten Visuals
- Grundlagen der Tooltip-Integration in benutzerdefinierte Visuals
- Data Roles und Tooltip-Datenfelder definieren
- Modifikationen im Visual-Code
- Visual als Tooltip konfigurieren
- Tooltip in Power BI Desktop aktivieren und verwenden
- Zusammenfassung
Einführung in Tooltips bei benutzerdefinierten Visuals
In Power BI Desktop stellen Tooltips eine effektive Möglichkeit dar, zusätzliche Informationen anzuzeigen, wenn Nutzer mit der Maus über ein Visual fahren. Während für Standardvisuals die Tooltip-Unterstützung bereits integriert ist, benötigt man bei benutzerdefinierten Visuals (Custom Visuals) eine explizite Implementierung und Aktivierung, um Tooltips korrekt anzeigen zu können.
Grundlagen der Tooltip-Integration in benutzerdefinierte Visuals
Benutzerdefinierte Visuals in Power BI basieren auf dem Power BI Visuals API, welches eine Reihe von Interfaces und Möglichkeiten bereitstellt, um Interaktionen wie Tooltips zu ermöglichen. Damit Tooltips funktionieren, muss das Visual sowohl im Code unterstützt werden als auch die entsprechenden Data Roles definieren.
Data Roles und Tooltip-Datenfelder definieren
Der erste Schritt besteht darin, in der Datei capabilities.json des Custom Visuals eine Rolle für Tooltips zu definieren. Diese Rolle gibt an, welche Datenfelder für die Tooltip-Anzeige genutzt werden sollen.
Ein typisches Beispiel für eine Tooltip-Rolle in capabilities.json sieht folgendermaßen aus:
{ "dataRoles": , ...}Hier wird die Rolle "tooltips" als Gruppierung definiert, die dann im Visual im Tooltip-Bereich genutzt werden kann.
Modifikationen im Visual-Code
Im Visual-Code, meist in TypeScript, müssen die Daten aus der Rolle "tooltips" abgefangen und verarbeitet werden. Zusätzlich wird die Tooltip-Unterstützung absichtlich aktiviert, indem im Update-Methodenblock geprüft wird, ob Tooltip-Daten vorhanden sind, und diese für die Anzeige genutzt werden.
Die Einbindung erfolgt typischerweise über die Schnittstelle ITooltipService von Power BI. Ein Beispielansatz ist:
this.tooltipService = tooltipService; update(options: VisualUpdateOptions) { ... if (this.tooltipService) { this.tooltipService.addTooltip( this.rootElement, (tooltipEvent: TooltipEventArgs ) => { return this.getTooltipData(tooltipEvent.dataPoint); } ); }}Die Methode getTooltipData übernimmt dabei die Formatierung und Rückgabe der Tooltip-Daten basierend auf dem angeforderten Datenpunkt.
Visual als Tooltip konfigurieren
Alternativ kann in Power BI Desktop ein spezielles Tooltip-Visual erstellt werden, das als eigenständiger Bericht fungiert und bei Hover-Effekten erscheint. Dieses Vorgehen nutzt die Parent Visual-Eigenschaft und erfordert, dass das benutzerdefinierte Visual als Tooltip-Visual gekennzeichnet und entsprechend zugeschnitten ist.
Tooltip in Power BI Desktop aktivieren und verwenden
Nach der Entwicklung des benutzerdefinierten Visuals mit Tooltip-Unterstützung muss das Visual in Power BI Desktop importiert werden. Anschließend kann man im Feldbereich beim Visual das Feld aus der definierten Tooltip-Rolle mit Daten befüllen.
Ist das korrekt gesetzt, werden beim Überfahren der Datenpunkte im Visual automatisch die Tooltips angezeigt. Sollte dies nicht geschehen, lohnt sich eine Prüfung, ob der Client die Tooltip-Unterstützung im Custom Visual korrekt erkennt und ob keine Javascript-Fehler im Entwickler-Tool-Log auftauchen.
Zusammenfassung
Die Aktivierung von Tooltips bei benutzerdefinierten Visuals in Power BI Desktop erfordert die Planung auf mehreren Ebenen: Zunächst die Definition der Tooltip-Datenrollen im capabilities.json, danach die Implementierung der Datenverarbeitung und Tooltip-Logik im Visual-Code selbst. Abschließend erfolgt die Nutzung und Befüllung der Tooltip-Felder im Power BI Desktop. Sind diese Schritte beachtet, lassen sich aussagekräftige Tooltips für Custom Visuals erfolgreich aktivieren und darstellen.