Lägg till en visningsvarningsikon i det visuella objektet

I ett visuellt Power BI-objekt kan en varningsikon meddela användaren om ett möjligt problem eller ett fel. Visningsvarningsikoner kan vara användbara i många fall, till exempel:

• Ett visuellt kartobjekt kan visa en varningsikon när värden ligger utanför det giltiga intervallet latitud eller longitud.

• Ett visuellt cirkeldiagram kan visa en varningsikon när det visar negativa värden som blandas med positiva värden.

• Ett kartesiskt diagram kan visa en varningsikon när oändlighetsvärden beräknas. Om till exempel Y är noll, när du delar X med Y, är resultatet oändligt.

När ikonen visas kan användaren hovra över den för att se varningsmeddelandets rubrik.

När användaren väljer varningsikonen visas ett meddelande som beskriver problemet i ett popup-fönster.

Skapa en varningsikon

Du kan skapa en varningsikon med ett anpassat meddelande för ett anpassat visuellt objekt. Beslutet om du vill höja varningsikonen eller inte är upp till dig. Som dessa exempel visar fortsätter det visuella objektet att fungera när varningsikonen visas.

Lägga till ett anrop till uppdateringsmetoden

Om du vill lägga till en visningsvarningsikon i ditt visuella objekt anropar du displayWarningIcon metoden. Metoden är en del av och exponeras med hjälp av IVisualHostpowerbi-visuals-api.

Lägg till följande import i filen:

import powerbiVisualsApi from "powerbi-visuals-api"; 

När du har lagt till importen lägger du till ett villkor som avgör när varningsikonen ska visas. Använd exemplen i den här artikeln om du vill visa två valfria villkor.

Exempel 1: Kontrollera språkkompatibilitet

Lokalisering används för att visa visuella objekt på kundens modersmål, vilket avskräcks av operativsystemets inställningar.

I det här exemplet jämför det visuella objektet språket för det visuella objektet, som är inställt på amerikansk engelska, med operativsystemets språk. Om språken inte matchar visas varningsikonen.

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.'); 
        }

Exempel 2: Jämför färger i intilliggande kolumner

I det här exemplet visas visningsvarningsikonen när två kolumner som ligger bredvid varandra har samma färg.

Metoden getColumnColorByIndex itererar genom alla kolumner. Om två intilliggande kolumner har samma färg visas en varningsikon.

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.'); 
    } 

} 

Beaktanden och begränsningar

• Vissa fel och varningar orsakas inte av det visuella objektet. Till exempel värdena För många. Alla datafel härleds inte från Power BI-tjänst. Sådana fel och varningar sprids tidigare till det visuella objektets anrop. De har företräde framför fel som kommer från ditt visuella objekts kod. Om ett fel inträffar när data läses in, innan det visuella objektets kod körs och villkoret för visningsvarningsikonen uppfylls, visar det visuella objektet det felet i stället för visningsvarningsikonfelet.

• Visningsvarningen rensas under varje återgivning av det visuella objektet, till exempel när nya data dras in i det visuella objektet. Det visuella objektets metod anropas update() när det visuella objektet återges. Om det visuella objektets varning aktiveras baserat på ett villkor som är incheckat i uppdateringsmetoden, visar det visuella objektet varningen igen varje gång det visuella objektet återges.

• Att ändra storlek på ett visuellt objekt påverkar inte varningsikonen.

Följande begränsningar refererar till visningsikonens text:

• Den maximala längden på rubriken är 70 tecken

• Textens maximala längd är 2 000 tecken

• Texten visas endast som oformaterad text

Relaterat innehåll

DataViewUtils