Näyttövaroituskuvakkeen lisääminen visualisointiin

Power BI :n visualisoinnissa näytön varoituskuvake voi ilmoittaa käyttäjälle mahdollisesta ongelmasta tai virheestä. Näyttövaroituskuvakkeet voivat olla hyödyllisiä monissa tapauksissa, kuten:

• Kartan visualisointi voi näyttää varoituskuvakkeen, kun arvot ovat leveys- tai pituusasteen sallitun alueen ulkopuolella.

• Ympyräkaavio-visualisointi voi näyttää varoituskuvakkeen, kun se näyttää negatiivisia arvoja, jotka on yhdistetty positiivisiin.

• Karteesinen kaavio voi näyttää varoituskuvakkeen, kun äärettömät arvot lasketaan. Jos esimerkiksi Y on nolla, kun X jaetaan Y:llä, tulos on ääretön.

Kun kuvake tulee näkyviin, käyttäjä voi liikuttaa hiiren osoitinta sen päällä, jolloin varoitussanoman otsikko tulee näkyviin.

Kun käyttäjä valitsee varoituskuvakkeen, ongelmasta kertova viesti tulee näkyviin ponnahdusikkunassa.

Varoituskuvakkeen luominen

Voit luoda varoituskuvakkeen mukautetun visualisoinnin mukautetulla viestillä. Päätät, haluatko korottaa varoituskuvakkeen vai et, on sinun. Kuten näissä esimerkeissä osoitetaan, visualisointi toimii edelleen, kun varoituskuvake tulee näkyviin.

Lisää kutsu päivitysmenetelmään

Jos haluat lisätä visualisointiin näyttövaroituskuvakkeen, käynnistä - displayWarningIcon menetelmä. -menetelmä on osa IVisualHost -menetelmää, ja se näytetään :n avulla powerbi-visuals-api.

Lisää seuraava tuonti tiedostoosi:

import powerbiVisualsApi from "powerbi-visuals-api"; 

Kun olet lisännyt tuonnin, lisää ehto, joka määrää, milloin varoituskuvake näytetään. Tämän artikkelin esimerkkien avulla voit tarkastella kahta valinnaista ehtoa.

Esimerkki 1: Kielen yhteensopivuuden tarkistaminen

Lokalisointia käytetään visualisointien näyttämiseen asiakkaan alkuperäisellä kielellä, mikä määräytyy käyttöjärjestelmän asetusten perusteella.

Tässä esimerkissä visualisointi vertaa visualisoinnin kieltä, jonka kieleksi on määritetty yhdysvaltain englanti, käyttöjärjestelmän kieleen. Jos kielet eivät täsmää, näyttöön tulee varoituskuvake.

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

Esimerkki 2: Vertaa värejä vierekkäisissä sarakkeissa

Tässä esimerkissä näyttöön tulee varoituskuvake, kun kaksi vierekkäistä saraketta ovat samanvärisiä.

- getColumnColorByIndex menetelmä iteroi kaikki sarakkeet. Jos kahdella vierekkäisillä sarakkeilla on sama väri, näkyviin tulee varoituskuvake.

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

} 

Huomioitavat asiat ja rajoitukset

• Visualisointi ei aiheuttamaa joitain virheitä ja varoituksia. Esimerkiksi Liian monta -arvot. Jos kaikkia tietovirhejä ei näytetä, ne johdetaan Power BI -palvelu. Tällaiset virheet ja varoitukset välitetään ennen visualisoinnin kutsuja. Ne ohittavat visualisoinnin koodista peräisin olevat virheet. Jos tietoja ladattaessa ilmenee virhe ennen visualisoinnin koodin suorittamista ja näytön varoituskuvakkeen ehto täyttyy, visualisointi näyttää kyseisen virheen näyttövaroituskuvakevirheen sijaan.

• Näyttövaroitus tyhjennetään jokaisen visualisoinnin hahmonnuksen aikana, esimerkiksi kun uusia tietoja vedetään visualisointiin. Visualisoinnin update() -menetelmä käynnistetään, kun visualisointi on hahmontettu. Jos visualisoinnin varoitus esitetään päivitysmenetelmässä tarkastetun ehdon perusteella, visualisointi näyttää varoituksen uudelleen aina, kun visualisointi hahmonnetaan, jos ehto täyttyy.

• Visualisoinnin koon muuttaminen ei vaikuta varoituskuvakkeeseen.

Seuraavat rajoitukset koskevat näyttökuvakkeen tekstiä:

• Otsikon enimmäispituus on 70 merkkiä.

• Tekstin enimmäispituus on 2 000 merkkiä.

• Teksti näytetään vain pelkkänä tekstinä

Liittyvä sisältö

DataViewUtils