Cuadros de información personalizados

Puedes personalizar las descripciones emergentes que aparecen cuando los usuarios colocan el cursor sobre los elementos en las visualizaciones de Looker. Las descripciones emergentes personalizadas te permiten proporcionar más contexto, mostrar métricas adicionales y adaptar la información que se presenta a tus usuarios. Con el parámetro de configuración de visualización Información sobre la herramienta personalizada, puedes configurar la información sobre la herramienta en la pestaña Estilo de Explorar (o en el menú Editar de la visualización para las exploraciones clásicas) con una combinación de parámetros de configuración de la IU y un editor de HTML que admita plantillas de Liquid.

En esta página, se proporcionan instrucciones para habilitar y usar el parámetro de configuración de visualización Información sobre la herramienta personalizada en tu instancia de Looker (original). Esta página incluye las siguientes secciones:

Requisitos de usuarios y de instancias

Para acceder al parámetro de configuración de visualización Información sobre la herramienta personalizada, debes cumplir con los siguientes requisitos:

  • Tu instancia de Looker (original) debe ejecutar Looker 26.4 o una versión posterior.
  • Para crear información sobre la herramienta personalizada en Exploraciones, debes tener el permiso explore y acceso al modelo de LookML subyacente.

Limitaciones

La función Información sobre la herramienta personalizada tiene las siguientes limitaciones:

  • Las descripciones emergentes personalizadas se admiten en la mayoría de los tipos de visualizaciones, excepto en los siguientes:
  • Las descripciones emergentes personalizadas solo pueden hacer referencia a los campos que se incluyen en una consulta de exploración.
  • Las descripciones emergentes solo pueden mostrar el mismo nivel de detalle de los datos que un campo determinado. Si los usuarios quieren ver un nivel de datos más detallado que el que está disponible en la información sobre la herramienta, deben usar la función de desglose.
  • Las descripciones emergentes personalizadas se guardan a nivel de la visualización. No se pueden guardar a nivel de Explorar.
  • Si quitas un campo de una consulta de exploración que tiene una información sobre la herramienta personalizada, un usuario aún podrá ver esa información sobre la herramienta si la consulta de exploración se comparte con él y vuelve a agregar el campo a la consulta de exploración.
  • El HTML renderizado en las descripciones emergentes personalizadas está sujeto a las reglas de limpieza de HTML de Looker.
  • Es posible que no todas las variables de Liquid sean compatibles con las descripciones emergentes personalizadas.
  • Las personalizaciones de la información sobre la herramienta anularán cualquier tema que se aplique a un panel interno (no incorporado) o a un panel incorporado.

Cómo usar las descripciones emergentes personalizadas

Si tienes los permisos adecuados, puedes personalizar la información sobre la herramienta para una serie en tu visualización de Explorar. Para personalizar la información sobre la herramienta, sigue estos pasos:

  1. Abre o crea una consulta de Explorar y selecciona un tipo de visualización compatible.
  2. Haz clic en la pestaña Estilo en el panel Configurar para editar la visualización. En el caso de las exploraciones clásicas, haz clic en Editar en la pestaña Visualización de la exploración para abrir el editor de visualizaciones.
  3. Abre el menú Series.
  4. En la sección Personalizaciones, busca la serie a la que deseas agregar la información sobre la herramienta. Si hay varias series, expande la que quieras agregar a una información sobre la herramienta.
  5. Haz clic en el interruptor Cuadro de información personalizado para habilitar la funcionalidad de cuadro de información personalizado para esa serie o gráfico específico.
  6. En la sección Cuadro de información personalizado, puedes ajustar el aspecto básico del cuadro de información con las opciones que se proporcionan:
    • Tamaño de fuente: Establece el tamaño de la fuente de la información sobre la herramienta.
    • Familia de fuentes: Establece la familia de fuentes de la información sobre la herramienta.
    • Radio del borde: Establece la redondez de los bordes de la información sobre la herramienta. Cuanto mayor sea el número, más redondeados serán los bordes de la información sobre la herramienta.
    • Sombra del cuadro: Establece la sombra del cuadro de la información sobre la herramienta.
    • Color de la fuente: Establece el color de la fuente de la información sobre la herramienta.
    • Color de fondo: Establece el color de fondo de la información sobre la herramienta.
    • Color del borde: Establece el color del borde de la información sobre la herramienta.
    • Alineación del texto: Establece la alineación de la fuente de la información sobre la herramienta. Elige Alinear a la izquierda, Alinear al centro o Alinear a la derecha. Alinear a la izquierda es el parámetro de configuración predeterminado.
  7. Además de las opciones anteriores, o como alternativa a ellas, puedes aplicar opciones de diseño más avanzadas. Para ello, haz clic en Editar contenido de la información sobre herramientas para abrir el editor HTML Editar contenido de la información sobre herramientas.

  8. En el editor Editar contenido de la información sobre la herramienta, puedes usar HTML y variables de Liquid para estructurar y propagar la información sobre la herramienta.

    • Usa etiquetas HTML estándar para dar formato al contenido de la información sobre la herramienta (por ejemplo, <div>, <span>, <strong>, <table>,<ul>, <ol>). Ten en cuenta que el HTML renderizado está sujeto a las reglas de limpieza de HTML de Looker.
    • Es posible que no todas las variables de Liquid sean compatibles con las descripciones emergentes personalizadas.

  9. A medida que editas el contenido de la información sobre la herramienta personalizada, puedes obtener una vista previa de ella haciendo clic en Vista previa (o con las combinaciones de teclas Comando + Intro en Mac o Ctrl + Intro en PC) y colocando el cursor sobre los datos en el panel de vista previa de la visualización.

  10. Haz clic en Guardar en el editor de HTML y, luego, guarda tu exploración como una vista o como una tarjeta de panel para conservar los cambios.

Ejemplos

En los siguientes ejemplos, se muestran casos de uso para diferentes niveles de personalización de la información sobre la herramienta:

Cuadro de información personalizado con varios valores de medición

Las descripciones emergentes personalizadas pueden ser útiles en los casos en que quieras proporcionar más contexto a los usuarios sobre un dato que se muestra en una visualización. Por ejemplo, un gráfico de valor único muestra el valor de una sola medición. Con una información sobre la herramienta personalizada, puedes mostrar más datos y proporcionar a los usuarios más contexto sobre los datos del gráfico.

En este ejemplo, un gráfico de valor único titulado "Recuento de pedidos en 2025" muestra el valor de Recuento de pedidos para el País de los usuarios "USA" y se basa en una consulta de exploración que también incluye Recuento de artículos del pedido. Sin embargo, el valor de Order Items Count no se muestra en el gráfico.

El siguiente código HTML se ingresa en el editor Editar contenido de la información sobre la herramienta para la serie Recuento de pedidos y establece el contenido para incluir el valor Recuento de artículos del pedido en la información sobre la herramienta:

<div style="padding: 5px; font-family: Arial, sans-serif; font-size: 13px;">
  <div>
    <strong>Order Items Count:</strong> {{ order_items.count }}
  </div>
  <div>
    <strong>Orders Count:</strong> {{ orders.count }}
  </div>
</div>

Una información sobre la herramienta para el gráfico de valor único de Orders Count muestra el valor de Order Items Count de $54,340 y el valor de Orders Count de 39,189.

Los usuarios pueden ver los valores de ambos campos, Recuento de pedidos y Recuento de artículos de pedido, y tener más contexto para los datos que se muestran en el gráfico.

Información sobre la herramienta personalizada con valores ocultos estructurados como una tabla

Como se indica en la información sobre las limitaciones de esta página, las descripciones emergentes personalizadas solo pueden hacer referencia a los campos que se incluyen en una consulta de exploración. Sin embargo, es posible que no quieras mostrar todos los campos de la exploración en un gráfico. Con una información sobre la herramienta personalizada, puedes mostrarles a tus usuarios datos de campos que están ocultos en las visualizaciones sin agregarlos a un gráfico.

En este ejemplo, una tabla de datos de exploración incluye las mediciones Orders Count y Order Items Count, agrupadas por las dimensiones Users State y Orders Status. El desarrollador quiere mostrar una tabla pequeña a los usuarios y oculta los campos Orders Status y Order Items Count del gráfico de tabla. Sin embargo, el desarrollador aún quiere que los usuarios vean los valores de Orders Status y Order Items Count que están asociados con un Orders Count determinado.

El siguiente código HTML se ingresa en el editor Editar contenido de la información sobre la herramienta para la serie Recuento de pedidos y establece el contenido para que incluya los valores de Estado de los pedidos y Recuento de artículos de los pedidos en la información sobre la herramienta, estructurada como una tabla:

<div>
    <div>
        <table border="1">
          <!-- Table Body -->
          <tbody>
            <!-- Row 1 -->
            <tr>
              <td>
                <strong>Order status</strong>
              </td>
              <td>
                {{ orders.status }}
              </td>
            </tr>
            <!-- Row 2 -->
            <tr>
              <td>
                <strong>State</strong>
              </td>
              <td>
                {{ users.state }}
              </td>
            </tr>
            <!-- Row 3 -->
            <tr>
              <td>
                <strong>Count of orders</strong>
              </td>
              <td>
                {{ orders.count }}
              </td>
            </tr>
            <!-- Row 4 -->
            <tr>
              <td>
                <strong>Count of order items</strong>
              </td>
              <td>
                {{ order_items.count }}
              </td>
            </tr>
          </tbody>
        </table>
      </div>
  </div>

Una información sobre la herramienta para el valor de Recuento de pedidos en un gráfico de tabla muestra los valores de Estado de los usuarios, Estado de los pedidos, Recuento de pedidos y Recuento de artículos de pedidos en una tabla de dos columnas.

Los usuarios pueden ver todos los datos de la consulta de Explorar, sin los campos adicionales que se muestran en el gráfico de tabla.

Cuadro de información personalizado con funciones comunes de Liquid

Las descripciones emergentes personalizadas admiten funciones comunes de Liquid, como la canalización y el uso de sentencias de conversión de tipos. En este ejemplo, un gráfico de columnas muestra el recuento de pedidos agrupado por estado de los pedidos. El desarrollador quiere dar formato a la información sobre la herramienta para que los usuarios puedan identificar rápidamente la diferencia entre el Recuento de pedidos para un Estado de pedido "cancelado" y un Estado de pedido "completado".

El siguiente código HTML y Liquid se ingresa en el editor Editar contenido de información sobre la herramienta para la serie Recuento de pedidos y establece el valor de la información sobre la herramienta para que aparezca en rojo para los recuentos de pedidos con un estado "cancelado" y en verde para los pedidos con un estado "completado". El código usa una asignación de variables y una canalización para garantizar la exactitud de la cadena y aplicar el formato condicional especificado:

{% assign my_variable = orders.status | downcase | strip %}
{% if my_variable == "complete" %}
  <span style="color:green">{{orders.count}}</span>
{% else %}
  <span style="color:red">{{orders.count}}</span>
{% endif %}

El valor de Orders Count para la columna Orders Status "complete" muestra texto verde en la información sobre la herramienta.

Aparecerá un cuadro de información con el valor de Orders Count en verde en la columna Estado de pedido de Complete.

El valor de Orders Count de la columna Orders Status "cancelled" muestra texto en rojo en la información sobre la herramienta.

Aparecerá un cuadro de información con el valor de Orders Count en verde en la columna Estado de pedido de Complete.

Los usuarios pueden distinguir rápidamente entre los pedidos cancelados y los completados que se muestran en el gráfico de columnas.