Adicionar um ícone de aviso de exibição ao seu visual

Em um visual do Power BI, um ícone de aviso de exibição pode notificar o usuário sobre um possível problema ou erro. Exibir ícones de aviso pode ser útil em muitos casos, como:

• Um visual de mapa pode exibir um ícone de aviso quando os valores estão fora do intervalo válido de latitude ou longitude.

• Um visual de gráfico de pizza pode exibir um ícone de aviso quando estiver exibindo valores negativos misturados com valores positivos.

• Um gráfico cartesiano pode exibir um ícone de aviso quando valores infinitos são calculados. Por exemplo, se Y é zero, ao dividir X por Y, o resultado é infinito.

Quando o ícone aparece, o usuário pode passar o mouse sobre ele para ver o título da mensagem de aviso.

Quando o usuário seleciona o ícone de aviso, uma mensagem que descreve o problema aparece em uma janela pop-up.

Criar um ícone de aviso

Você pode criar um ícone de aviso com uma mensagem personalizada para um visual personalizado. A decisão de levantar ou não o ícone de aviso é sua. Como estes exemplos demonstram, o visual continua a funcionar quando o ícone de aviso é exibido.

Adicionar uma chamada ao método de atualização

Para adicionar um ícone de aviso de exibição ao visual, invoque o displayWarningIcon método. O método faz parte e IVisualHost é exposto usando powerbi-visuals-api.

Adicione a seguinte importação ao seu ficheiro:

import powerbiVisualsApi from "powerbi-visuals-api"; 

Depois de adicionar a importação, adicione uma condição que determine quando exibir o ícone de aviso. Use os exemplos neste artigo para exibir duas condições opcionais.

Exemplo 1: Verificar a compatibilidade linguística

A localização é usada para exibir elementos visuais no idioma nativo do cliente, o que é impedido pelas configurações do sistema operacional.

Neste exemplo, o visual compara o idioma do visual, que é definido como inglês dos EUA, com o idioma do sistema operacional. Se os idiomas não corresponderem, o ícone de aviso será exibido.

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

Exemplo 2: Comparar cores em colunas adjacentes

Neste exemplo, o ícone de aviso de exibição aparece quando duas colunas próximas uma da outra têm a mesma cor.

O getColumnColorByIndex método itera através de todas as colunas. Se duas colunas adjacentes tiverem a mesma cor, um ícone de aviso será exibido.

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

} 

Considerações e limitações

• Alguns erros e avisos não são causados pelo visual. Por exemplo, os valores Demasiados. O erro de não mostrar todos os dados é derivado do serviço do Power BI. Tais erros e avisos são propagados antes das chamadas do seu visual. Eles têm precedência sobre os erros que se originam do código do seu visual. Se ocorrer um erro durante o carregamento de dados, antes que o código do visual seja executado e a condição do ícone de aviso de exibição seja atendida, o visual exibirá esse erro em vez do erro do ícone de aviso de exibição.

• O aviso de exibição é apagado durante cada renderização do visual, por exemplo, quando novos dados são arrastados para o visual. O método do update() visual é invocado depois que o visual é renderizado. Se o aviso do visual for gerado com base em uma condição verificada no método de atualização, cada vez que o visual for renderizado, se a condição for atendida, o visual exibirá o aviso novamente.

• O redimensionamento de um visual não afeta o ícone de aviso.

As limitações a seguir referem-se ao texto do ícone de exibição:

• O comprimento máximo do título é de 70 caracteres

• O comprimento máximo do texto é de 2.000 caracteres

• O texto é exibido apenas como texto sem formatação

Conteúdos relacionados

DataViewUtils