La ventana de información de la visualización muestra el valor de las dimensiones y las métricas seleccionadas de forma predeterminada y puede ayudar a los usuarios a comprender la importancia de un solo dato.
Por ejemplo, una información sobre herramientas para una visualización de mapa que se basa en el margen bruto total agrupado por Estado mostrará los valores de ambos campos cuando un usuario coloque el cursor sobre el estado de California.
Sin embargo, ¿qué sucede si deseas incluir campos distintos de los predeterminados en la información sobre la herramienta para que los usuarios puedan obtener más información o contexto sobre un dato sin necesidad de buscar en otro lugar?
Puedes personalizar el cuadro de información para que muestre valores de varios campos especificados, incluidos aquellos que no están en la consulta de exploración.
Componentes
- Variables líquidas: Estas variables renderizan los valores de otros campos junto con la consulta de exploración existente.
- Parámetro
html
: Los campos que se definen en el parámetrohtml
de una medición se renderizarán en el cuadro de información cuando un usuario coloque el cursor sobre una visualización. - Visualización: La información sobre la herramienta aparecerá cuando un usuario coloque el cursor sobre un dato en ciertos tipos de visualización.
Requisitos previos
Para personalizar la información, necesitas lo siguiente:
- Permisos para crear exploraciones y desarrollar LookML
- Conocimiento sobre desarrollo en SQL y LookML
- Conocimientos básicos sobre el uso de Liquid en Looker y la codificación HTML Visita la sección Cómo usar variables líquidas en el parámetro
html
de la página de documentación dehtml
para obtener la información general necesaria. - Permisos para guardar contenido (si quieres guardar la visualización como una Vista o un panel)
Consideraciones para personalizar la información sobre la herramienta
Es importante tener en cuenta lo siguiente cuando personalizas un cuadro de información:
- Los valores del parámetro
html
se convierten en el eje Y de una visualización. - El valor que deseas mostrar en el eje Y debe ser el valor del parámetro
sql
de la medida. - Cuando uses cualquier medida con formato (una medida de
type: percent_of_total
o una medida con un parámetrovalue_format_name
ovalue_format
), asegúrate de usar la sintaxis de Liquid para el valor renderizado{{ field_name._rendered_value }}
(en el quefield_name
es el nombre real de la medida o dimensión).
Ejemplo
De forma predeterminada, el cuadro de información de los datos de visualización incluirá los valores de Margen bruto total y Estado. Sin embargo, ¿qué sucede si deseas proporcionar a los usuarios información adicional que no se indica en el mapa ni se incluye en la búsqueda de Explorar? ¿Qué pasaría si quisieras incluir el valor de un campo llamado Porcentaje del margen bruto total en lugar de Estado? Si incluyes el Porcentaje de margen bruto total, los usuarios podrán comprender cómo se compara el valor del Margen bruto total de un dato individual con el margen bruto total en el conjunto de datos.
Para personalizar la información sobre la herramienta, sigue estos pasos:
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 ;;
}
En Modo de desarrollo, navega a la definición de LookML para el campo que quieres personalizar.
Puedes navegar directamente a la definición de LookML de un campo desde una exploración.
Determina los campos y valores que deseas incluir en la información sobre herramientas, además del campo original. Por ejemplo, Porcentaje del margen bruto total.
Agrega un parámetro
html
a la métrica original a la que se hace referencia en la consulta Explorar y que se muestra en la información sobre herramientas. En este caso, la medida que se encuentra actualmente en la consulta Explorar y se muestra en el cuadro de información es Margen bruto total.En el parámetro
html
, crea una expresión con variables líquidas que agregue los campos adicionales al valor de la medición existente.- En este ejemplo, se usa la variable Liquid
_rendered_value
para mostrar valores con formato de Looker. Por ejemplo,total_gross_margin
usa el formato de Looker para dos decimales, ypercent_of_total_gross_margin
usa el formato de Looker para el porcentaje con dos decimales. - Puedes usar un carácter de barra vertical,
|
, para separar los valores en diferentes campos. - También puedes agregar otras palabras para aclarar el significado de los otros valores renderizados en la información sobre la herramienta. En este caso, se agrega
of total
para aclarar qué significa el valor porcentual.
- En este ejemplo, se usa la variable Liquid
Guarda, valida y envía tu código a producción después de verificar que funcione como se espera.
El cuadro de información ahora mostrará dos valores cuando un usuario coloque el cursor sobre un dato con el cuadro de información: el valor total_gross_margin
de los datos y el valor percent_of_total_gross_margin
correspondiente.
Próximos pasos
Una vez que hayas creado tu visualización con una información sobre herramientas personalizada, puedes compartirla con otras personas:
- Guarda tu exploración como una vista
- Cómo agregar Explorar a un panel
- Cómo compartir la exploración con una URL