Cómo aprovechar al máximo el libro de recetas de visualizaciones de Looker: personalización de cuadros de información

La información sobre la herramienta de visualización muestra el valor de las dimensiones y las medidas seleccionadas de forma predeterminada y puede ayudar a los usuarios a comprender la importancia de un solo punto de datos.

Por ejemplo, la información sobre la herramienta de 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.

Un usuario coloca el cursor sobre California para mostrar una sugerencia con el valor del estado "California" y el valor del margen de ganancias bruto total "USD 988,018.58".

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 punto de datos sin tener que buscar en otro lugar?

Puedes personalizar la información sobre la herramienta para que muestre valores de varios campos especificados, incluidos los campos que no están en la consulta de exploración.

Componentes

Requisitos previos

Para personalizar la información sobre la herramienta, se requiere lo siguiente:

Consideraciones para la personalización de la información sobre la herramienta

Es importante tener en cuenta lo siguiente cuando personalizas una información sobre la herramienta:

  • 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 usas cualquier medida con formato (una medida de type: percent_of_total o una medida con un parámetro value_format_name o value_format), asegúrate de usar la sintaxis de Liquid para el valor renderizado {{ field_name._rendered_value }} (donde field_name es el nombre real de la medida o dimensión).

Ejemplo

De forma predeterminada, la información sobre la herramienta para los puntos de 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 consulta de exploración? ¿Qué sucede si deseas incluir el valor de un campo llamado Porcentaje del margen bruto total en lugar de estado? Incluir el porcentaje del margen bruto total ayudará a los usuarios a comprender cómo se compara el valor del margen bruto total de un punto de datos 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 ;;
}

  1. 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.

  2. 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.

  3. Agrega un parámetro html a la medida original a la que se hace referencia en la consulta de exploración y que se muestra en la información sobre la herramienta. En este caso, la medida que se encuentra actualmente en la consulta de exploración y que se muestra en la información sobre la herramienta es margen bruto total.

  4. En el parámetro html, crea una expresión con variables de Liquid que agregue los campos adicionales al valor de la medida existente.

    • En este ejemplo, se usa la variable de Liquid _rendered_value para mostrar valores con formato de Looker. Por ejemplo, total_gross_margin usa el formato de Looker para dos decimales, y percent_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 de diferentes campos.
    • También puedes agregar otras palabras que puedan aclarar el significado de los otros valores que se renderizan en la información sobre la herramienta. En este caso, se agrega of total para aclarar lo que significa el valor porcentual.

  5. Guarda, valida y envía tu código a producción después de verificar que funcione según lo esperado.

Ahora, la información sobre la herramienta mostrará dos valores cuando un usuario coloque el cursor sobre un punto de datos con la información sobre la herramienta: el valor total_gross_margin del punto de 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 la herramienta personalizada, puedes compartirla con otras personas: