Føj et advarselsikon til din visualisering

I en Power BI-visualisering kan et visningsadvarselsikon give brugeren besked om et muligt problem eller en fejl. Visningsadvarselsikoner kan være nyttige i mange tilfælde, f.eks.:

• En kortvisualisering kan vise et advarselsikon, når værdier ligger uden for det gyldige breddegrads- eller længdegradsområde.

• Et visuelt element i et cirkeldiagram kan vise et advarselsikon, når der vises negative værdier, der er blandet med positive værdier.

• Et kartesisk diagram kan vise et advarselsikon, når uendelighedsværdier beregnes. Hvis Y f.eks. er nul, er resultatet uendeligt, når X divideres med Y.

Når ikonet vises, kan brugeren holde markøren over det for at se titlen på advarselsmeddelelsen.

Når brugeren vælger advarselsikonet, vises en meddelelse, der beskriver problemet, i et pop op-vindue.

Opret et advarselsikon

Du kan oprette et advarselsikon med en tilpasset meddelelse for en brugerdefineret visualisering. Beslutningen om at hæve advarselsikonet eller ej er op til dig. Som disse eksempler viser, fungerer visualiseringen fortsat, når advarselsikonet vises.

Føj et kald til opdateringsmetoden

Hvis du vil føje et visningsadvarselsikon til din visualisering, skal du aktivere displayWarningIcon metoden . Metoden er en del af IVisualHost og vises ved hjælp af powerbi-visuals-api.

Føj følgende import til filen:

import powerbiVisualsApi from "powerbi-visuals-api"; 

Når du har tilføjet importen, skal du tilføje en betingelse, der bestemmer, hvornår advarselsikonet skal vises. Brug eksemplerne i denne artikel til at få vist to valgfrie betingelser.

Eksempel 1: Kontrollér sprogkompatibilitet

Lokalisering bruges til at få vist visualiseringer på kundens oprindelige sprog, hvilket er en afskrækkelse af operativsystemets indstillinger.

I dette eksempel sammenligner visualiseringen sproget i visualiseringen, som er angivet til amerikansk engelsk, med sproget i operativsystemet. Hvis sprogene ikke stemmer overens, vises advarselsikonet.

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

Eksempel 2: Sammenlign farver i tilstødende kolonner

I dette eksempel vises ikonet for visningsadvarsel, når to kolonner ved siden af hinanden har samme farve.

Metoden getColumnColorByIndex gentages gennem alle kolonnerne. Hvis to tilstødende kolonner har samme farve, vises der et advarselsikon.

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

} 

Overvejelser og begrænsninger

• Nogle fejl og advarsler skyldes ikke visualiseringen. For mange værdier. Ikke viser alle datafejl er afledt fra Power BI-tjeneste. Sådanne fejl og advarsler overføres før til din visualiserings kald. De har forrang frem for fejl, der stammer fra din visualiserings kode. Hvis der opstår en fejl under indlæsning af data, før visualiseringens kode køres, og betingelsen for visningsadvarselsikonet er opfyldt, viser visualiseringen fejlen i stedet for fejlmeddelelsen for visningsadvarselsikonet.

• Visningsadvarslen ryddes under hver gengivelse af visualiseringen, f.eks. når nye data trækkes ind i visualiseringen. Metoden for visualiseringen aktiveres update() , når visualiseringen gengives. Hvis visualiseringens advarsel udløses på baggrund af en betingelse, der er tjekket ind i opdateringsmetoden, vises advarslen igen, hver gang visualiseringen gengives, hvis betingelsen er opfyldt.

• Ændring af størrelsen på en visualisering påvirker ikke advarselsikonet.

Følgende begrænsninger refererer til teksten til visningsikonet:

• Titlen må højst være på 70 tegn

• Den maksimale længde på teksten er 2.000 tegn

• Teksten vises kun som almindelig tekst

Relateret indhold

DataViewUtils