Legg til et ikon for visningsadvarsel i visualobjektet

I et Power BI-visualobjekt kan et visningsadvarselsikon varsle brukeren om et mulig problem eller en feil. Vis advarselsikoner kan være nyttige i mange tilfeller, for eksempel:

• Et kartvisualobjekt kan vise et advarselsikon når verdiene er utenfor breddegrad eller lengdegrad.

• Et sektordiagram-visualobjekt kan vise et advarselsikon når det viser negative verdier som er blandet med positive.

• Et kartesisk diagram kan vise et advarselsikon når uendeligverdier beregnes. Hvis Y for eksempel er null, er resultatet uendelig når du deler X med Y.

Når ikonet vises, kan brukeren holde pekeren over det for å se tittelen på advarselen.

Når brukeren velger advarselsikonet, vises en melding som beskriver problemet i et popup-vindu.

Opprett et advarselsikon

Du kan opprette et advarselsikon med en tilpasset melding for et egendefinert visualobjekt. Beslutningen om å heve advarselsikonet eller ikke er opp til deg. Som disse eksemplene viser, fortsetter visualobjektet å fungere når advarselsikonet vises.

Legge til et anrop i oppdateringsmetoden

Hvis du vil legge til et ikon for visningsadvarsel i visualobjektet displayWarningIcon , aktiverer du metoden. Metoden er en del av og eksponeres ved hjelp av IVisualHost powerbi-visuals-api.

Legg til følgende import i filen:

import powerbiVisualsApi from "powerbi-visuals-api"; 

Når du har lagt til importen, legger du til en betingelse som bestemmer når advarselsikonet skal vises. Bruk eksemplene i denne artikkelen til å vise to valgfrie betingelser.

Eksempel 1: Kontrollere språkkompatibilitet

Lokalisering brukes til å vise visualobjekter på kundens morsmål, som er avskrekkende etter innstillingene for operativsystemet.

I dette eksemplet sammenligner visualobjektet språket for visualobjektet, som er satt til amerikansk engelsk, med språket i operativsystemet. Hvis språkene ikke samsvarer, 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: Sammenligne farger i tilstøtende kolonner

I dette eksemplet vises ikonet for visningsadvarsel når to kolonner ved siden av hverandre har samme farge.

Metoden getColumnColorByIndex itererer gjennom alle kolonnene. Hvis to tilstøtende kolonner har samme farge, vises 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.'); 
    } 

} 

Hensyn og begrensninger

• Noen feil og advarsler skyldes ikke visualobjektet. For eksempel for mange verdier. Viser ikke at alle datafeil er avledet fra Power Bi-tjeneste. Slike feil og advarsler overføres før visualobjektets anrop. De har prioritet over feil som stammer fra koden for visualobjektet. Hvis det oppstår en feil under innlasting av data, før koden for visualobjektet kjøres og ikonbetingelsen for visningsadvarselen er oppfylt, viser visualobjektet denne feilen i stedet for feilmeldingen for visningsadvarselsikonet.

• Skjermadvarselen fjernes under hver gjengivelse av visualobjektet, for eksempel når nye data dras inn i visualobjektet. Visualobjektets metode aktiveres update() etter at visualobjektet er gjengitt. Hvis advarselen for visualobjektet heves basert på en betingelse som er sjekket inn i oppdateringsmetoden, viser visualobjektet advarselen på nytt hver gang visualobjektet gjengis.

• Endring av størrelse på et visualobjekt påvirker ikke advarselsikonet.

Følgende begrensninger refererer til visningsikonteksten:

• Den maksimale lengden på tittelen er 70 tegn

• Den maksimale lengden på teksten er 2000 tegn

• Teksten vises bare som ren tekst

Relatert innhold

DataViewUtils