Dodawanie ikony ostrzeżenia wyświetlania do wizualizacji

W wizualizacji usługi Power BI ikona wyświetlania ostrzeżenia może powiadomić użytkownika o możliwym problemie lub błędzie. Wyświetlanie ikon ostrzeżeń może być przydatne w wielu przypadkach, takich jak:

• Wizualizacja mapy może wyświetlać ikonę ostrzeżenia, gdy wartości znajdują się poza prawidłowym zakresem szerokości geograficznej lub długości geograficznej.

• Wizualizacja wykresu kołowego może wyświetlać ikonę ostrzeżenia, gdy wyświetla wartości ujemne, które są mieszane z dodatnimi.

• Wykres kartezjański może wyświetlać ikonę ostrzeżenia, gdy wartości nieskończoności są obliczane. Na przykład jeśli wartość Y jest równa zero, podczas dzielenia wartości X przez Y wynik jest nieskończoność.

Gdy pojawi się ikona, użytkownik może umieścić nad nim wskaźnik myszy, aby wyświetlić tytuł komunikatu ostrzegawczego.

Gdy użytkownik wybierze ikonę ostrzeżenia, w oknie podręcznym pojawi się komunikat opisujący problem.

Tworzenie ikony ostrzeżenia

Możesz utworzyć ikonę ostrzeżenia z dostosowanym komunikatem dla wizualizacji niestandardowej. Decyzja o tym, czy podnieść ikonę ostrzeżenia, czy nie, jest dla Ciebie. Jak pokazano w tych przykładach, wizualizacja będzie nadal działać po wyświetleniu ikony ostrzeżenia.

Dodawanie wywołania metody update

Aby dodać ikonę ostrzeżenia wyświetlanego do wizualizacji, wywołaj metodę displayWarningIcon . Metoda jest częścią IVisualHost metody i jest uwidaczniona przy użyciu metody powerbi-visuals-api.

Dodaj następujący import do pliku:

import powerbiVisualsApi from "powerbi-visuals-api"; 

Po dodaniu importu dodaj warunek określający, kiedy wyświetlić ikonę ostrzeżenia. Skorzystaj z przykładów w tym artykule, aby wyświetlić dwa opcjonalne warunki.

Przykład 1. Sprawdzanie zgodności języka

Lokalizacja służy do wyświetlania wizualizacji w języku natywnym klienta, który jest odstraszany przez ustawienia systemu operacyjnego.

W tym przykładzie wizualizacja porównuje język wizualizacji, który jest ustawiony na angielski w Stanach Zjednoczonych, na język systemu operacyjnego. Jeśli języki nie są zgodne, zostanie wyświetlona ikona ostrzeżenia.

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

Przykład 2. Porównanie kolorów w sąsiednich kolumnach

W tym przykładzie wyświetlana ikona ostrzeżenia jest wyświetlana, gdy dwie kolumny, które znajdują się obok siebie, mają ten sam kolor.

Metoda getColumnColorByIndex iteruje wszystkie kolumny. Jeśli dwie sąsiadujące kolumny mają ten sam kolor, zostanie wyświetlona ikona ostrzeżenia.

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

} 

Rozważania i ograniczenia

• Niektóre błędy i ostrzeżenia nie są spowodowane przez wizualizację. Na przykład za dużo wartości. Brak wyświetlania wszystkich błędów danych pochodzi z usługa Power BI. Takie błędy i ostrzeżenia są propagowane przed wywołaniami wizualizacji. Mają pierwszeństwo przed błędami pochodzącymi z kodu wizualizacji. Jeśli podczas ładowania danych wystąpi błąd, zanim zostanie uruchomiony kod wizualizacji i zostanie spełniony warunek ikony ostrzeżenia wyświetlanego, wizualizacja wyświetla ten błąd zamiast błędu ikony ostrzeżenia wyświetlanego.

• Ostrzeżenie o wyświetlaniu jest czyszczone podczas każdego renderowania wizualizacji, na przykład po przeciągnięciu nowych danych do wizualizacji. Metoda wizualizacji jest wywoływana update() po renderowaniu wizualizacji. Jeśli ostrzeżenie wizualizacji jest wywoływane na podstawie warunku zaewidencjonowanego w metodzie aktualizacji, za każdym razem, gdy wizualizacja zostanie wyrenderowana, jeśli warunek zostanie spełniony, wizualizacja ponownie wyświetli ostrzeżenie.

• Zmiana rozmiaru wizualizacji nie ma wpływu na ikonę ostrzeżenia.

Następujące ograniczenia dotyczą tekstu ikony wyświetlania:

• Maksymalna długość tytułu to 70 znaków

• Maksymalna długość tekstu wynosi 2000 znaków

• Tekst jest wyświetlany tylko jako zwykły tekst

Powiązana zawartość

DataViewUtils