La información sobre la herramienta de visualización muestra el valor de las dimensiones y medidas seleccionadas de forma predeterminada y puede ayudar a los usuarios a comprender la importancia de un solo dato.
Por ejemplo, la información sobre la herramienta para una visualización de mapa basada en el Margen bruto total agrupado por Estado mostrará valores para 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 la información sobre la herramienta para mostrar valores de varios campos especificados, incluidos aquellos que no están en la consulta Explorar.
Componentes
- Variables líquidas: Las variables líquidas renderizan los valores de otros campos junto con la consulta Explorar existente.
- Parámetro
html: Los campos definidos en el parámetrohtmlde una medición se renderizarán en la información sobre la herramienta 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 sobre la herramienta, se requiere lo siguiente:
- Permisos para crear exploraciones y permisos para desarrollar LookML
- Conocimiento del desarrollo de SQL y LookML
- Conocimientos básicos sobre el uso de Liquid en Looker y programación con HTML Consulta la sección Usa variables líquidas en el parámetro
htmlde la página de documentación dehtmlpara obtener la información general necesaria. - Permisos para guardar contenido (si quieres guardar la visualización como una vista o un panel)
Consideraciones para la personalización de la información sobre la herramienta
Cuando personalices un cuadro de información sobre la herramienta, es importante tener en cuenta lo siguiente:
- Los valores del parámetro
htmlse 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
sqlde la medición. - Cuando uses cualquier medida con formato (una medida de
type: percent_of_totalo una medida con un parámetrovalue_format_nameovalue_format), asegúrate de usar la sintaxis Liquid para el valor renderizado{{ field_name._rendered_value }}(dondefield_namees el nombre real de la medida o dimensión).
Ejemplo
De forma predeterminada, la información sobre la herramienta para los datos de visualización incluirá los valores de Margen bruto total y Estado. Sin embargo, ¿qué pasaría si quisieras proporcionar a los usuarios información adicional que no se indica en el mapa ni se incluye en la consulta Explorar? ¿Qué pasaría si quisieras incluir el valor de un campo llamado Porcentaje del margen bruto total en lugar del Estado? Incluir el Porcentaje del margen bruto total ayudará a los usuarios a comprender cómo el valor del Margen bruto total de un dato individual se compara 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 del campo que deseas 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 la herramienta además del campo original. Por ejemplo, Porcentaje del margen bruto total.
Agrega un parámetro
htmla la medición original a la que se hace referencia en la consulta Explorar y que se muestra en la información sobre la herramienta. En este caso, la medida que se encuentra actualmente en la consulta Explorar y que se muestra en el cuadro de información es Margen bruto total.En el parámetro
html, crea una expresión con variables Liquid que agregue los campos adicionales al valor de la medición existente.- En este ejemplo, se usa la variable Liquid
_rendered_valuepara mostrar valores con formato de Looker. Por ejemplo,total_gross_marginusa el formato de Looker para dos decimales ypercent_of_total_gross_marginusa el formato de Looker para porcentajes con dos decimales. - Puedes usar un carácter de barra vertical,
|, para separar los valores de diferentes campos. - También puedes agregar otras palabras que puedan aclarar el significado de los demás valores que aparecen en la información sobre la herramienta. En este caso, se agrega
of totalpara 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 una vez que hayas verificado que funciona 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 del dato y el valor percent_of_total_gross_margin correspondiente.
Próximos pasos
Una vez que hayas creado tu visualización con un cuadro de información personalizado, puedes compartirla con otras personas:
- Cómo guardar tu exploración como vista
- Cómo agregar la función Explorar a un panel
- Cómo compartir la exploración con una URL