Přidání ikony upozornění zobrazení do vizuálu

Ve vizuálu Power BI může ikona upozornění zobrazení upozornit uživatele na možný problém nebo chybu. Ikony upozornění zobrazení můžou být užitečné v mnoha případech, například:

• Vizuál mapy může zobrazit ikonu upozornění, pokud jsou hodnoty mimo platnou zeměpisnou šířku nebo délku.

• Vizuál výsečového grafu může zobrazit ikonu upozornění, když zobrazuje záporné hodnoty, které jsou smíšené s kladnými hodnotami.

• Kartézský graf může při výpočtu nekonečna zobrazit ikonu upozornění. Pokud je například Y nula, při dělení XY je výsledek nekonečno.

Když se zobrazí ikona, uživatel na ni může najet myší, aby se zobrazil název zprávy upozornění.

Když uživatel vybere ikonu upozornění, zobrazí se v automaticky otevíraných oknech zpráva s popisem problému.

Vytvoření ikony upozornění

Můžete vytvořit ikonu upozornění s přizpůsobenou zprávou pro vlastní vizuál. Rozhodnutí, jestli chcete vyvolat ikonu upozornění nebo ne, je na vás. Jak ukazují tyto příklady, vizuál bude dál fungovat, když se zobrazí ikona upozornění.

Přidání volání metody aktualizace

Pokud chcete do vizuálu přidat ikonu upozornění zobrazení, vyvoláte metodu displayWarningIcon . Metoda je součástí IVisualHost a je vystavena pomocí powerbi-visuals-api.

Do souboru přidejte následující import:

import powerbiVisualsApi from "powerbi-visuals-api"; 

Po přidání importu přidejte podmínku, která určuje, kdy se má zobrazit ikona upozornění. Příklady v tomto článku slouží k zobrazení dvou volitelných podmínek.

Příklad 1: Kontrola kompatibility jazyka

Lokalizace se používá k zobrazení vizuálů v nativním jazyce zákazníka, což je odstrašující nastavením operačního systému.

V tomto příkladu vizuál porovnává jazyk vizuálu, který je nastavený na angličtinu v USA, s jazykem operačního systému. Pokud se jazyky neshodují, zobrazí se ikona upozornění.

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

Příklad 2: Porovnání barev v sousedních sloupcích

V tomto příkladu se zobrazí ikona upozornění zobrazení, když dva sloupce vedle sebe mají stejnou barvu.

Metoda getColumnColorByIndex prochází všechny sloupce. Pokud mají dva sousední sloupce stejnou barvu, zobrazí se ikona upozornění.

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

} 

Úvahy a omezení

• Některé chyby a upozornění nejsou způsobené vizuálem. Například příliš mnoho hodnot. Nezobrazuje se chyba všech dat odvozená z služba Power BI. Tyto chyby a upozornění se před voláním vizuálu rozšíří. Mají přednost před chybami, které pocházejí z kódu vizuálu. Pokud při načítání dat dojde k chybě, před spuštěním kódu vizuálu a splněnou podmínkou ikony upozornění zobrazení se zobrazí tato chyba místo chyby ikony upozornění zobrazení.

• Upozornění na zobrazení se vymaže při každém vykreslování vizuálu, například při přetažení nových dat do vizuálu. Metoda vizuálu update() se vyvolá po vykreslení vizuálu. Pokud je upozornění vizuálu vyvoláno na základě podmínky, která je vrácena v metodě aktualizace, při každém vykreslení vizuálu, pokud je podmínka splněna, vizuál znovu zobrazí upozornění.

• Změna velikosti vizuálu nemá vliv na ikonu upozornění.

Následující omezení odkazují na text ikony zobrazení:

• Maximální délka názvu je 70 znaků.

• Maximální délka textu je 2 000 znaků.

• Text se zobrazí jenom jako prostý text.

Související obsah

DataViewUtils