Como aproveitar ao máximo o manual de visualizações do Looker: personalização de formatação condicional

Observação:esta página faz parte do Manual do Looker: Como aproveitar ao máximo as visualizações do Looker.

Dica:a partir do Looker 24.0, é possível usar o Editor de configuração de gráficos para formatar valores usando regras mais robustas e em visualizações que não sejam de cálculos de tabela.

O destaque visual dos valores que atendem (ou não) a determinadas condições permite que os usuários identifiquem rapidamente as tendências de dados. Esse padrão costuma ser chamado de formatação condicional no Excel ou em outros aplicativos de planilha.

Por exemplo, esta visualização de tabela da seção Como usar a formatação condicional diretamente nas configurações de visualização nesta página ajuda os usuários a identificar onde o crescimento pode ser positivo ou negativo:

O Looker oferece suporte à formatação condicional nas visualizações de várias maneiras diferentes:

• Com cálculos de tabelas e emojis. Essa abordagem é ideal quando as condições que determinam a formatação precisam ser criadas diretamente em uma Análise do Looker. Consulte a página de práticas recomendadas Formatação condicional usando cálculos de tabela para saber como aplicar a formatação personalizada a visualizações com cálculos de tabela.
• Com opções integradas que estão nas configurações de visualização de gráficos de texto e de tabela.
• Com o parâmetro html do LookML. Isso é ideal para formatar valores quando as condições que orientam a formatação são consistentes na análise de um determinado campo.

Este livro de receitas oferece tutoriais para as duas últimas opções:

• Usar a formatação condicional diretamente nas configurações de visualização
• Como usar formatação condicional com o parâmetro html do LookML

Dica: considere o contraste de cores para acessibilidade do conteúdo.

Formatação condicional com configurações de visualização

É possível usar as configurações de visualização para aplicar a formatação condicional em gráficos de tabela, visualizações de valor único e visualizações de registro único.

Nesta seção, apresentamos um guia para usar a formatação condicional em gráficos de tabela com as configurações disponíveis no menu Editar.

Consulte o roteiro Apresentação de muitas informações com uma visualização de valor único do manual Como aproveitar ao máximo as visualizações no manual do Looker para conferir um guia explicativo sobre formatação condicional em visualizações de valor único.

Componentes

• Analisar consulta
• Visualização de tabela

Pré-requisitos

Para criar uma visualização de tabela com formatação condicional, é necessário o seguinte:

• Permissões para criar Análises e familiaridade com a Análise de dados
• Permissões para criar cálculos de tabela ou campos personalizados, se necessário para seu caso de uso
• Familiaridade com as configurações de visualização de tabelas
• Permissões para salvar conteúdo (se quiser salvar a visualização como um Look ou dashboard)

Exemplo

Uma equipe de marketing quer ver o número de novos usuários a cada mês, segmentados por faixas etárias, para entender melhor a resposta aos apelos de marketing que são lançados a cada mês.

A visualização da tabela padrão pode ser difícil para alguns usuários. Você pode usar a formatação condicional nas configurações de visualização para comparar e contrastar valores em relação às metas ou definir regras, o que ajudará a tornar os dados mais claros para os usuários entenderem.

Neste exemplo, a equipe de Marketing quer comparar os valores na tabela com as seguintes condições:

• Crescimento positivo (verde): meses e faixas etárias com 50 ou mais usuários novos
• Crescimento médio (amarelo): meses e faixas etárias com 25 a 50 novos usuários
• Baixo crescimento (vermelho): meses e faixas etárias com 25 novos usuários ou menos

Conclua as etapas a seguir para aplicar a formatação condicional a uma visualização de tabela usando as configurações no menu Editar:

1. Abra o menu Editar na barra Visualização.
2. Selecione as opções de estilo de tabela na guia Plot como quiser, incluindo a escolha do tema de tabela no menu suspenso Tema da tabela ou se você quer ou não exibir números de linhas marcando ou desmarcando a opção Mostrar números de linha.
3. Na guia Gráfico, selecione a opção Visualização de células para desativá-la. A Visualização de células precisa estar desativada para aplicar a formatação condicional aos valores da tabela.
4. Na guia Formatação, selecione o botão de alternância Ativar formatação condicional para habilitar a formatação condicional e acessar as configurações de formatação condicional.
   • Você também pode escolher uma paleta de cores no menu suspenso Coleção da seção Cores da guia Formatação. Também é possível personalizar o tamanho da linha em pixels no campo Linha e o alinhamento do texto do cabeçalho da coluna, tamanho da fonte e cor no campo Cabeçalho na seção Personalizações, acima das configurações de formatação condicional.
   • Neste exemplo, a opção Incluir valores nulos como zero é selecionada para incluir nulos como zeros.
5. Crie suas regras de formatação condicional. Selecione o botão Adicionar uma regra para adicionar quantas regras de formatação condicional você quiser.
   • No menu suspenso Aplicar a, selecione os valores que você quer aplicar à regra.

6. Na lista suspensa Formato, selecione o formato para aplicar à regra. * É possível deixar o formato padrão ao longo da escala. Os valores serão destacados em um gradiente com base na paleta de cores e nas configurações de valores que você escolher. Saiba mais sobre a codificação de cores em uma reduzir escalonamento horizontal seção Formatação condicional da página de documentação das opções do gráfico de tabela.

   • Especifique os valores de Cor do plano de fundo, Cor da fonte e Estilo da fonte para cada regra, conforme desejar. Considere o contraste de cores para acessibilidade do conteúdo.

   • Neste exemplo, três regras são criadas:

     • Opção Formatar Se o valor for maior que 49, com uma opção Cor de fundo verde selecionada.
     • Opção Formatar Se o valor estiver entre 24 e 50, com uma opção Cor de fundo amarela selecionada.
     • Opção Formatar Se o valor for menor que 25, com uma opção vermelha Cor de fundo selecionada.
     Dica: o intervalo não inclui os valores especificados.

A visualização resultante mostra a contagem de usuários em cada coluna da faixa etária com base nos critérios especificados pela equipe de Marketing:

• Crescimento positivo (verde): meses e faixas etárias com 50 ou mais usuários novos
• Crescimento médio (amarelo): meses e faixas etárias com 25 a 50 novos usuários
• Baixo crescimento (vermelho): meses e faixas etárias com 25 novos usuários ou menos

Formatação condicional no LookML com o parâmetro html

Além de usar as configurações do menu Editar da visualização, é possível fixar no código a formatação condicional diretamente no LookML de um campo. Isso é útil para a formatação condicional consistente em toda a análise de um determinado campo, já que evita a necessidade de redefinir as configurações de visualização de relatórios individuais.

Cuidado :a formatação HTML só é renderizada em visualizações de gráficos de tabela, tabela (legado) e valor único e dicas de visualização quando vários campos são combinados. Os conteúdos interativos colocados na dica de um gráfico do mapa com o parâmetro html não poderão ser acessados nos dashboards que usam a nova experiência do painel, embora possam ser acessados em Looks e Explores.

Componentes

• Variáveis líquidas: renderizam os valores dos campos em conjunto com a formatação HTML especificada.
• Parâmetro html: o estilo HTML codificado no parâmetro html de um campo será renderizado na tabela de dados da Análise e na visualização.
• Visualização de tabela: a formatação condicional aparecerá para os usuários na visualização.

Pré-requisitos

A codificação condicional no parâmetro html requer o seguinte:

• Permissões para criar Análises.
• Permissões para desenvolver LookML e familiaridade com o desenvolvimento em SQL e LookML.
• Conhecimento básico sobre o uso do Liquid no Looker e em programação HTML. Acesse a seção Como usar variáveis líquidas no parâmetro html da página de documentação do html para conferir as informações básicas necessárias.
• Permissões para salvar conteúdo (se quiser salvar a visualização como um Look ou dashboard)

Exemplo

Imagine que você tem um campo nos seus dados chamado status, que fornece o status de cada pedido. Estes são os valores possíveis para status:

• "cancelado"
• “concluído”
• "pending"

Para destacar o status do pedido para os usuários que visualizam relatórios que incluem o campo Status, adicione uma cor de plano de fundo exclusiva para destacar cada status.

Para codificar a formatação condicional em um campo do LookML:

dimension: status {
  type: string
  sql: ${TABLE}.status ;;
  html:
    {% dynamic if value == 'complete' %}
      <p style="color: black; background-color: lightgreen;">{{ value }}</p>
    {% elsif value == 'pending' %}
      <p style="color: black; background-color: orange;">{{ value }}</p>
    {% dynamic else %}
      <p style="color: white; background-color: red;">{{ value }}</p>
    {% dynamic endif %}
  ;;
  description: "The current status of an existing order."
}

1. No Modo de Desenvolvimento, navegue até o campo LookML em que você quer adicionar a formatação condicional.
   • É possível navegar diretamente para a definição do LookML de um campo em "Explore".
2. Adicione um parâmetro html ao campo. Nesse caso, o campo é status.
3. No parâmetro html, crie uma expressão com sintaxe de tag líquida que defina condições para valores específicos do campo.
   • Neste exemplo, a variável líquida value é usada para gerar o valor do campo. Use _rendered_value para exibir todos os valores para campos que usam a formatação de valor do Looker.
   • Considere o contraste de cores para acessibilidade do conteúdo.
   • Você pode adicionar qualquer outro estilo HTML compatível com o Looker (link em inglês). Consulte a página de documentação do parâmetro html para ver mais exemplos.
4. Salve, valide e envie seu código para produção depois de verificar se ele funciona conforme o esperado.

O resultado são os valores de Status destacados em vermelho, verde ou laranja, dependendo do status, em qualquer relatório do Looker que inclua o campo.

As cores de fundo também aparecem em outros gráficos. Por exemplo, um gráfico de colunas para uma consulta que agrupa Contagem de pedidos por Status dos pedidos exibirá as cores de fundo codificadas para cada valor de Status dos pedidos.

Estilo adicional

Você pode usar a mesma sintaxe do exemplo anterior para adicionar ícones ou imagens com base nos valores de campo. O exemplo a seguir adiciona um ícone de verificação "x" vermelho para um Status dos pedidos "cancelado", um ícone de verificação verde para um Status dos pedidos "concluído" e um ícone de relógio para um Status dos pedidos "pendente":

    dimension: status {
      type: string
      sql: ${TABLE}.status ;;
      html:
        {% dynamic if value == 'complete' %}
          <p><img src="https://findicons.com/files/icons/573/must_have/48/check.png" height=20 width=20>{{ rvalue }}</p>
        {% elsif value == 'pending' %}
          <p><img src="https://findicons.com/files/icons/1681/siena/128/clock_blue.png" height=20 width=20>{{ value }}</p>
        {% dynamic else %}
           <p><img src="https://findicons.com/files/icons/719/crystal_clear_actions/64/cancel.png" height=20 width=20>{{ value }}</p>
        {% dynamic endif %}
      ;;
      description: "The current status of an existing order."
    }

O resultado são valores de Status com um ícone X vermelho, um ícone de verificação verde ou um ícone de relógio ao lado do valor, dependendo do status, em qualquer relatório do Looker que inclua o campo.

Próximas etapas

Depois de criar sua visualização de tabela com formatação condicional, você pode compartilhá-la com outras pessoas:

• Salvar suas Análises como um Look
• Adicionar o Explore a um painel
• Compartilhar a Análise com um URL