Een waarschuwingspictogram voor weergave toevoegen aan uw visual

In een Power BI-visual kan een waarschuwingspictogram voor weergave de gebruiker op de hoogte stellen van een mogelijk probleem of een fout. Waarschuwingspictogrammen weergeven kan in veel gevallen handig zijn, zoals:

• Een kaartvisual kan een waarschuwingspictogram weergeven wanneer waarden buiten het geldige bereik voor breedtegraad of lengtegraad vallen.

• Een cirkeldiagramvisual kan een waarschuwingspictogram weergeven wanneer er negatieve waarden worden weergegeven die worden gemengd met positieve waarden.

• Een cartesisch diagram kan een waarschuwingspictogram weergeven wanneer oneindige waarden worden berekend. Als Y bijvoorbeeld nul is bij het delen van X door Y, is het resultaat oneindig.

Wanneer het pictogram wordt weergegeven, kan de gebruiker de muisaanwijzer erop bewegen om de titel van het waarschuwingsbericht weer te geven.

Wanneer de gebruiker het waarschuwingspictogram selecteert, wordt er een bericht weergegeven waarin het probleem wordt beschreven in een pop-upvenster.

Een waarschuwingspictogram maken

U kunt een waarschuwingspictogram maken met een aangepast bericht voor een aangepast visueel element. De beslissing of u het waarschuwingspictogram wilt verhogen of niet aan u is. Zoals deze voorbeelden laten zien, blijft de visual functioneren wanneer het waarschuwingspictogram wordt weergegeven.

Een aanroep toevoegen aan de updatemethode

Als u een waarschuwingspictogram voor de weergave wilt toevoegen aan uw visual, roept u de displayWarningIcon methode aan. De methode maakt deel uit van IVisualHost en wordt weergegeven met behulp van powerbi-visuals-api.

Voeg de volgende import toe aan uw bestand:

import powerbiVisualsApi from "powerbi-visuals-api"; 

Nadat u de import hebt toegevoegd, voegt u een voorwaarde toe die bepaalt wanneer het waarschuwingspictogram moet worden weergegeven. Gebruik de voorbeelden in dit artikel om twee optionele voorwaarden weer te geven.

Voorbeeld 1: Taalcompatibiliteit controleren

Lokalisatie wordt gebruikt om visuals weer te geven in de systeemeigen taal van de klant, wat afstelt door de instellingen van het besturingssysteem.

In dit voorbeeld vergelijkt de visual de taal van de visual, die is ingesteld op Amerikaans Engels, met de taal van het besturingssysteem. Als de talen niet overeenkomen, wordt het waarschuwingspictogram weergegeven.

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

Voorbeeld 2: Kleuren in aangrenzende kolommen vergelijken

In dit voorbeeld wordt het waarschuwingspictogram voor de weergave weergegeven wanneer twee kolommen naast elkaar dezelfde kleur hebben.

De getColumnColorByIndex methode doorloopt alle kolommen. Als twee aangrenzende kolommen dezelfde kleur hebben, wordt er een waarschuwingspictogram weergegeven.

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

} 

Overwegingen en beperkingen

• Sommige fouten en waarschuwingen worden niet veroorzaakt door de visual. Bijvoorbeeld de te veel waarden. Niet alle gegevensfouten worden weergegeven op basis van de Power BI-service. Dergelijke fouten en waarschuwingen worden doorgegeven voordat deze worden doorgegeven aan de aanroepen van uw visual. Ze hebben voorrang op fouten die afkomstig zijn van de code van uw visual. Als er een fout optreedt tijdens het laden van gegevens, voordat de code van de visual wordt uitgevoerd en aan de voorwaarde voor het waarschuwingspictogram voor de weergave wordt voldaan, wordt die fout weergegeven in plaats van de fout met het waarschuwingspictogram.

• De weergavewaarschuwing wordt gewist tijdens elke weergave van de visual, bijvoorbeeld wanneer nieuwe gegevens naar de visual worden gesleept. De methode van update() de visual wordt aangeroepen nadat de visual is weergegeven. Als de waarschuwing van de visual wordt gegenereerd op basis van een voorwaarde die is ingecheckt in de updatemethode, geeft de visual telkens wanneer aan de voorwaarde wordt voldaan de waarschuwing weer.

• Het wijzigen van het formaat van een visual heeft geen invloed op het waarschuwingspictogram.

De volgende beperkingen verwijzen naar de tekst van het weergavepictogram:

• De maximale lengte van de titel is 70 tekens

• De maximale lengte van de tekst is 2000 tekens

• De tekst wordt alleen weergegeven als tekst zonder opmaak

Gerelateerde inhoud

DataViewUtils