Freigeben über

Hinzufügen eines Anzeigewarnsymbols zu Ihrem Visual

  • Artikel

In einem Power BI kann ein Anzeigewarnsymbol den Benutzer über ein mögliches Problem oder einen Fehler benachrichtigen. Anzeigewarnsymbole können in vielen Fällen nützlich sein, wie z. B.:

  • Ein visuelles Zuordnungselement kann ein Warnsymbol anzeigen, wenn Werte außerhalb des gültigen Breiten- oder Längengradbereichs liegen.

  • Ein Kreisdiagrammvisual kann ein Warnsymbol anzeigen, wenn negative Werte angezeigt werden, die mit positiven Werten gemischt sind.

  • Ein kartesisches Diagramm kann ein Warnsymbol anzeigen, wenn Unendlichkeitswerte berechnet werden. Wenn Y beispielsweise 0 ist, ist das Ergebnis unendlich, wenn X durch Y dividiert wird.

Wenn das Symbol angezeigt wird, kann der Benutzer darauf zeigen, um den Titel der Warnmeldung anzuzeigen.

A screenshot showing a warning icon in a Power BI visual.

Wenn der Benutzer das Warnsymbol auswählt, wird in einem Pop-up-Fenster eine Meldung angezeigt, die das Problem beschreibt.

A screenshot showing a warning message triggered by selecting a warning icon in a Power BI visual.

Erstellen eines Warnsymbols

Sie können ein Warnsymbol mit einer angepassten Meldung für ein benutzerdefiniertes Visual erstellen. Die Entscheidung, ob das Warnsymbol angezeigt werden soll, liegt bei Ihnen. Wie in diesen Beispielen dargestellt, funktioniert das Visual weiterhin, wenn das Warnsymbol angezeigt wird.

Fügen Sie der Updatemethode einen Aufruf hinzu

Um Ihrem Visual ein Anzeigewarnsymbol hinzuzufügen, rufen Sie zuerst die Methode displayWarningIcon auf. Die Methode ist Teil von IVisualHost und wird mit powerbi-visuals-api verfügbar gemacht.

Fügen Sie Ihrer Datei den folgenden Import hinzu:

import powerbiVisualsApi from "powerbi-visuals-api";

Nachdem Sie den Import hinzugefügt haben, fügen Sie eine Bedingung hinzu, die bestimmt, wann das Warnsymbol angezeigt werden soll. Verwenden Sie die Beispiele in diesem Artikel, um zwei optionale Bedingungen anzuzeigen.

Beispiel 1: Überprüfen der Sprachkompatibilität

Die Lokalisierung wird verwendet, um Visuals in der nativen Sprache des Kunden anzuzeigen, was durch die Einstellungen des Betriebssystems verhindert wird.

In diesem Beispiel vergleicht das Visual die Sprache des Visuals, die auf US-Englisch festgelegt ist, mit der Sprache des Betriebssystems. Wenn die Sprachen nicht übereinstimmen, wird das Warnsymbol angezeigt.

if (this.locale != 'en-US') { 

            this.host.displayWarningIcon('Language inconsistency', 'This visual supports only US English. For the visual to work as expected, set your browser's language to US English.'); 
        }

A screenshot showing the language mismatch warning message.

Beispiel 2: Vergleichen von Farben in angrenzenden Spalten

In diesem Beispiel wird das Anzeigewarnsymbol angezeigt, wenn zwei Spalten, die sich nebeneinander befinden, die gleiche Farbe aufweisen.

Die Methode getColumnColorByIndex durchläuft alle Spalten. Wenn zwei angrenzende Spalten dieselbe Farbe aufweisen, wird ein Warnsymbol angezeigt.

let category = options.dataViews[0].categorical.categories[0]; 

let dataValue = options.dataViews[0].categorical.values[0]; 

let colorPalette = this.host.colorPalette; 

for (let i = 0, len = Math.max(category.values.length, dataValue.values.length); i < len-1; i++) { 

    const color1: string = getColumnColorByIndex(category, i, colorPalette); 

    const color2: string = getColumnColorByIndex(category, i+1, colorPalette); 

    if (color1 == color2) { 

        this.host.displayWarningIcon('Adjacent columns have the same color.', 'Columns that are next to each other have the same color. To change a column's color, use the data colors option in the Format tab.'); 
    } 

}

Überlegungen und Einschränkungen

  • Einige Fehler und Warnungen werden nicht durch das Visual verursacht. Die Fehlermeldung Too many values. Not showing all data (Zu viele Werte. Nicht alle Daten werden angezeigt) wird vom Power BI-Dienst abgeleitet. Solche Fehler und Warnungen werden zuvor an die Aufrufe Ihres Visuals weitergegeben. Sie haben Vorrang vor Fehlern, die aus dem Code Ihres Visuals stammen. Wenn beim Laden von Daten ein Fehler auftritt, bevor der Code des Visuals ausgeführt wird und die Bedingung des Anzeigewarnsymbols erfüllt ist, zeigt das Visual diesen Fehler anstelle des Anzeigewarnsymbolfehlers an.

  • Die Anzeigewarnung wird bei jedem Rendering des Visuals gelöscht, z. B. wenn neue Daten in das Visual gezogen werden. Die Methode update() des Visuals wird aufgerufen, nachdem das Visual gerendert wurde. Wenn die Warnung des Visuals basierend auf einer Bedingung ausgelöst wird, die in der Updatemethode überprüft wird, wird jedes Mal beim Rendern des Visuals, wenn die Bedingung erfüllt ist, die Warnung erneut angezeigt.

  • Das Ändern der Größe eines Visuals wirkt sich nicht auf das Warnsymbol aus.

Die folgenden Einschränkungen beziehen sich auf den Anzeigesymboltext:

  • Die maximale Länge des Namens beträgt 70 Zeichen

  • Die maximale Länge des Namens beträgt 2.000 Zeichen

  • Der Text wird nur als Nur-Text angezeigt

Zugehöriger Inhalt

DataViewUtils