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á valores para os dois campos quando um usuário passar o cursor sobre o estado da Califórnia.
No entanto, e se você quiser incluir na dica campos diferentes do padrão para que os usuários possam ter mais informações ou contexto sobre um ponto de dados sem precisar procurar em outro lugar?
É possível personalizar a dica para exibir valores de vários campos especificados, incluindo aqueles que não estão na consulta Explore.
Componentes
- Variáveis líquidas: renderizam os valores de outros campos em conjunto com a consulta "Explore".
- Parâmetro
html
: os campos definidos no parâmetrohtml
de uma medida serão renderizados na dica quando um usuário passar o cursor sobre uma visualização. - Visualização: a dica aparece quando um usuário passa o cursor sobre um ponto de dados em certos tipos de visualização.
Pré-requisitos
A personalização da dica requer o seguinte:
- Permissões para criar Explores e permissões para desenvolver LookML.
- Conhecimento de 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 dohtml
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)
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 no parâmetro
sql
da medida. - Ao usar qualquer medida formatada (uma medida de
type: percent_of_total
ou uma com um parâmetrovalue_format_name
ouvalue_format
), use a sintaxe líquida para o valor renderizado{{ field_name._rendered_value }}
, em quefield_name
é o nome real da medida ou dimensão.
Exemplo
Por padrão, a dica dos pontos de dados de visualização vai incluir os valores de Margem bruta total e Estado. Mas e se você quisesse oferecer aos usuários informações adicionais que não estão indicadas no mapa ou incluídas na consulta do Explore? E se você quisesse 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 com a 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 ;;
}
No Modo de Desenvolvimento, navegue até a definição do LookML do campo que você quer personalizar.
É possível navegar diretamente para a definição do LookML de um campo em "Explore".
Determine os campos e valores que você quer incluir na dica, além do campo original. Por exemplo, Porcentagem da margem bruta total.
Adicione um parâmetro
html
à medida original que é referenciada na consulta do Explore e exibida na dica. Nesse caso, a medida que está atualmente na consulta do Explore e exibida na dica é Margem bruta total.No parâmetro
html
, crie uma expressão com variáveis líquidas que anexe os outros campos ao valor da medida atual.- Esse exemplo usa a variável Liquid
_rendered_value
para mostrar valores formatados do Looker. Por exemplo,total_gross_margin
usa a formatação do Looker para dois números decimais epercent_of_total_gross_margin
usa a formatação do Looker para porcentagem com dois decimais. - É possível usar uma barra vertical,
|
, para separar os valores de campos diferentes. - Também é possível acrescentar outras palavras que possam esclarecer o significado dos valores renderizados na dica. Nesse caso,
of total
é adicionado para esclarecer o que o valor percentual significa.
- Esse exemplo usa a variável Liquid
Salve, valide e envie seu código para produção depois de verificar se ele funciona conforme o esperado.
A dica agora mostra dois valores quando um usuário passa 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ê poderá compartilhá-la com outras pessoas: