Como aproveitar ao máximo o livro de receitas de visualizações do Looker: personalização de dicas

Observação: esta página faz parte do livro de receitas 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áfico para personalizar ainda mais o estilo e a cor da dica.

A dica de visualização mostra o valor das dimensões e medidas selecionadas por padrão e pode ajudar os usuários a entender a importância de um único ponto de dados.

Por exemplo, uma dica para uma visualização de mapa baseada na Margem bruta total agrupada por Estado exibirá os valores dos dois campos quando um usuário passar o cursor sobre o estado da Califórnia.

No entanto, e se você quiser incluir campos diferentes do padrão na dica de ferramenta para que os usuários tenham mais informações ou contexto sobre um ponto de dados sem precisar procurar em outro lugar?

É possível personalizar a dica para mostrar valores de vários campos especificados, incluindo campos que não estão na consulta da Análise detalhada.

Cuidado: a formatação HTML só é renderizada em visualizações de gráfico tabela, tabela (legado) e valor único e em dicas de ferramentas de visualização quando vários campos são combinados. Qualquer conteúdo interativo inserido na dica do gráfico de mapa com o parâmetro html não poderá ser acessado em dashboards que usam a nova experiência de dashboard, embora o conteúdo possa ser acessado em Looks e Explores.

Componentes

• Variáveis líquidas: as variáveis líquidas renderizam os valores de outros campos em conjunto com a consulta de Análises.
• Parâmetro html: os campos definidos no parâmetro html de uma medição são renderizados na dica quando o usuário passa o cursor sobre uma visualização.
• Visualização: a dica aparece quando o cursor é passado sobre um ponto de dados em determinados tipos de visualização.
  • Gráficos cartesianos
  • Gráficos de pizza ou de rosca
  • Gráficos de progressão
  • Gráficos de mapa

Pré-requisitos

Para personalizar a dica, é necessário:

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

Considerações para a personalização de dicas

É importante considerar o seguinte ao personalizar uma dica:

• Os valores no parâmetro html se tornam o eixo y de uma visualização.
• O valor que você quer mostrar no eixo y precisa ser o valor do parâmetro sql da medida.
• Ao usar qualquer medida formatada (uma medida de type: percent_of_total ou uma medida com um parâmetro value_format_name ou value_format), use a sintaxe do Liquid para o valor renderizado {{ field_name._rendered_value }} (em que field_name é o nome real da medida ou dimensão).

Exemplo

Observação: o exemplo desta seção extrapola o mapa de exemplo Margem bruta total agrupado por Estado apresentado anteriormente nesta página.

Por padrão, a dica dos pontos de dados de visualização inclui os valores de Margem bruta total e Estado. No entanto, e se você quiser fornecer aos usuários informações adicionais que não estão indicadas no mapa ou incluídas na consulta da seção "Explorar"? E se você quiser incluir o valor de um campo chamado Percentual da margem bruta total em vez de Estado? Incluir a Porcentagem da margem bruta total ajuda os usuários a entender como o valor da margem bruta total de um ponto de dados individual se compara à margem bruta total do conjunto de dados.

Para personalizar a dica, siga estas etapas:

measure: total_gross_margin {
  type: sum
  value_format_name: decimal_2
  sql: ${gross_margin} ;;
  html: {{ rendered_value }} | {{percent_of_gross_margin._rendered_value }} of total ;;
}

1. No modo de desenvolvimento, navegue até a definição do LookML para o campo que você quer personalizar.

   É possível navegar diretamente para a definição do LookML de um campo em uma Análise detalhada.

2. Determine os campos e valores que você quer incluir na dica, além do campo original. Por exemplo, Porcentagem da margem bruta total.

3. Adicione um parâmetro html à medida original que é referenciada na consulta da Análise detalhada e exibida na dica. Nesse caso, a medida que está atualmente na consulta "Análise" e exibida na dica é Margem bruta total.

4. No parâmetro html, crie uma expressão com variáveis líquidas que anexe os outros campos ao valor da medida atual.

   • Este exemplo usa a variável _rendered_value do Liquid para mostrar valores formatados do Looker. Por exemplo, total_gross_margin usa a formatação do Looker para dois decimais, e percent_of_total_gross_margin usa a formatação do Looker para porcentagem com dois decimais.
   • Você pode usar uma barra vertical, |, para separar os valores de campos diferentes.
   • Também é possível acrescentar outras palavras que possam esclarecer o significado dos outros valores renderizados na dica. Nesse caso, of total é adicionado para esclarecer o significado do valor percentual.

5. Salve, valide e envie seu código para produção depois de verificar se ele funciona conforme o esperado.

Observação :a entrada do parâmetro html afeta apenas a forma como o valor é renderizado para os usuários. Ele não altera o valor no banco de dados.

A dica agora vai mostrar dois valores quando um usuário passar o cursor sobre um ponto de dados com a dica: o valor total_gross_margin do ponto de dados e o valor percent_of_total_gross_margin correspondente.

Próximas etapas

Depois de criar sua visualização com uma dica personalizada, você pode compartilhá-la com outras pessoas:

• Salvar a Análise como um Look
• Adicionar a Análise a um painel
• Compartilhar a seção "Explorar" com um URL