Aggiungere un'icona di avviso di visualizzazione all'oggetto visivo

In un oggetto visivo di Power BI un'icona di avviso di visualizzazione può notificare all'utente un possibile problema o un errore. Le icone di avviso di visualizzazione possono essere utili in molti casi, ad esempio:

• Un oggetto visivo mappa può visualizzare un'icona di avviso quando i valori non rientrano nell'intervallo valido di latitudine o longitudine.

• Un oggetto visivo grafico a torta può visualizzare un'icona di avviso quando visualizza valori negativi misti con quelli positivi.

• Un grafico cartesiano può visualizzare un'icona di avviso quando vengono calcolati i valori infinito. Ad esempio, se Y è zero, quando si divide X per Y, il risultato è infinito.

Quando viene visualizzata l'icona, l'utente può passare il puntatore del mouse su di esso per visualizzare il titolo del messaggio di avviso.

Quando l'utente seleziona l'icona di avviso, viene visualizzato un messaggio che descrive il problema in una finestra popup.

Creare un'icona di avviso

È possibile creare un'icona di avviso con un messaggio personalizzato per un oggetto visivo personalizzato. La decisione se generare o meno l'icona di avviso spetta all'utente. Come illustrato in questi esempi, l'oggetto visivo continua a funzionare quando viene visualizzata l'icona di avviso.

Aggiungere una chiamata al metodo update

Per aggiungere un'icona di avviso di visualizzazione all'oggetto visivo, richiamare il displayWarningIcon metodo . Il metodo fa parte di IVisualHost e viene esposto tramite powerbi-visuals-api.

Aggiungere l'importazione seguente al file:

import powerbiVisualsApi from "powerbi-visuals-api"; 

Dopo aver aggiunto l'importazione, aggiungere una condizione che determina quando visualizzare l'icona di avviso. Usare gli esempi in questo articolo per visualizzare due condizioni facoltative.

Esempio 1: Verificare la compatibilità della lingua

La localizzazione viene usata per visualizzare gli oggetti visivi nella lingua nativa del cliente, che è scoraggiato dalle impostazioni del sistema operativo.

In questo esempio, l'oggetto visivo confronta la lingua dell'oggetto visivo, che è impostata sull'inglese degli Stati Uniti, con la lingua del sistema operativo. Se le lingue non corrispondono, viene visualizzata l'icona di avviso.

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

Esempio 2: Confrontare i colori nelle colonne adiacenti

In questo esempio, l'icona di avviso di visualizzazione viene visualizzata quando due colonne accanto all'altra hanno lo stesso colore.

Il getColumnColorByIndex metodo scorre tutte le colonne. Se due colonne adiacenti hanno lo stesso colore, viene visualizzata un'icona di avviso.

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

} 

Considerazioni e limitazioni

• Alcuni errori e avvisi non sono causati dall'oggetto visivo. Ad esempio, troppi valori. La mancata visualizzazione di tutti gli errori di dati deriva dalla servizio Power BI. Tali errori e avvisi vengono propagati prima delle chiamate dell'oggetto visivo. Hanno la precedenza sugli errori che hanno origine dal codice dell'oggetto visivo. Se si verifica un errore durante il caricamento dei dati, prima che venga eseguito il codice dell'oggetto visivo e venga soddisfatta la condizione dell'icona di avviso di visualizzazione, l'oggetto visivo visualizza tale errore anziché l'errore dell'icona di avviso di visualizzazione.

• L'avviso di visualizzazione viene cancellato durante ogni rendering dell'oggetto visivo, ad esempio quando vengono trascinati nuovi dati nell'oggetto visivo. Il metodo dell'oggetto update() visivo viene richiamato dopo il rendering dell'oggetto visivo. Se l'avviso dell'oggetto visivo viene generato in base a una condizione archiviata nel metodo di aggiornamento, ogni volta che viene eseguito il rendering dell'oggetto visivo, se la condizione viene soddisfatta, l'oggetto visivo visualizza nuovamente l'avviso.

• Il ridimensionamento di un oggetto visivo non influisce sull'icona di avviso.

Le limitazioni seguenti fanno riferimento al testo dell'icona di visualizzazione:

• La lunghezza massima del titolo è di 70 caratteri

• La lunghezza massima del testo è di 2.000 caratteri

• Il testo viene visualizzato solo come testo normale

Contenuto correlato

DataViewUtils