Zdieľať cez


Pridanie ikony upozornenia zobrazenia do vizuálu

Ikona upozornenia zobrazenia môže vo vizuáli služby Power BI informovať používateľa o možnom probléme alebo o chybe. Ikony upozornenia zobrazenia môžu byť užitočné v mnohých prípadoch, ako napríklad:

  • Vizuál mapy môže zobraziť ikonu upozornenia, keď sú hodnoty mimo platnej šírky alebo dĺžky platného rozsahu.

  • Vizuál koláčového grafu môže zobraziť ikonu upozornenia, keď zobrazuje záporné hodnoty, ktoré sú zmiešané s pozitívnymi.

  • Kartézsky graf môže zobraziť ikonu upozornenia, keď sa vypočítavajú hodnoty nekonečna. Ak je napríklad hodnota Y nula, pri delení X číslom Y je výsledkom nekonečná hodnota.

Keď sa ikona zobrazí, používateľ môže na nej ukázať myšou a zobraziť tak názov upozorňujúci hlásenia.

A screenshot showing a warning icon in a Power BI visual.

Keď používateľ vyberie ikonu upozornenia, v kontextovom okne sa zobrazí správa s popisom problému.

A screenshot showing a warning message triggered by selecting a warning icon in a Power BI visual.

Vytvorenie ikony upozornenia

Môžete vytvoriť ikonu upozornenia s prispôsobenou správou pre vlastný vizuál. Rozhodnutie o tom, či sa má ikona upozornenia zvýšiť alebo nie, je na vás. Ako ukazujú tieto príklady, vizuál bude aj naďalej fungovať, keď sa zobrazí ikona upozornenia.

Pridanie volania do metódy update

Ak chcete do vizuálu pridať ikonu upozornenia zobrazenia, vyvolajte metódu displayWarningIcon . Metóda je súčasťou IVisualHost a je vystavená pomocou powerbi-visuals-apimetódy .

Do súboru pridajte nasledujúci import:

import powerbiVisualsApi from "powerbi-visuals-api"; 

Po pridaní importu pridajte podmienku, ktorá určí, kedy sa má zobraziť ikona upozornenia. Pomocou príkladov v tomto článku zobrazíte dve voliteľné podmienky.

Príklad 1: Kontrola kompatibility jazyka

Lokalizácia sa používa na zobrazenie vizuálov v natívnom jazyku zákazníka, čo odradí nastavenia operačného systému.

V tomto príklade vizuál porovná jazyk vizuálu, ktorý je nastavený na možnosť Angličtina v USA, s jazykom operačného systému. Ak sa jazyky nezhoduje, zobrazí sa ikona upozornenia.

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

A screenshot showing the language mismatch warning message.

Príklad 2: Porovnanie farieb v susediacich stĺpcoch

V tomto príklade sa ikona upozornenia zobrazí, keď dva stĺpce, ktoré sú vedľa seba, majú rovnakú farbu.

Metóda getColumnColorByIndex iteruje cez všetky stĺpce. Ak majú dva susediace stĺpce rovnakú farbu, zobrazí sa ikona upozornenia.

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

} 

Dôležité informácie a obmedzenia

  • Niektoré chyby a upozornenia nie sú spôsobené vizuálom. Napríklad hodnoty Príliš veľa. Chyba všetky údaje sa nezobrazuje z služba Power BI. Tieto chyby a upozornenia sa rozšíria ešte predtým, ako sa vyvolá váš vizuál. Majú prednosť pred chybami pochádzajúcimi z kódu vášho vizuálu. Ak pri načítavaní údajov nastane chyba ešte pred spustením kódu vizuálu a splnená podmienka ikony upozornenia, vizuál zobrazí túto chybu namiesto ikony upozornenia na zobrazenie.

  • Upozornenie na zobrazenie sa vymaže pri každom vykresľovaní vizuálu, napríklad keď sa do vizuálu presunú nové údaje. Metóda vizuálu update() sa vyvolá po vykreslení vizuálu. Ak sa upozornenie vizuálu zobrazí na základe podmienky začiarknutej v metóde update, pri každom vykreslení vizuálu, ak je splnená podmienka, vizuál zobrazí upozornenie znova.

  • Zmena veľkosti vizuálu nemá vplyv na ikonu upozornenia.

Nasledujúce obmedzenia odkazujú na text ikony zobrazenia:

  • Maximálna dĺžka názvu je 70 znakov.

  • Maximálna dĺžka textu je 2 000 znakov.

  • Text sa zobrazí iba ako obyčajný text

DataViewUtils