Personalizar visualizaciones con el Editor de configuración de gráficos

Puedes usar el Editor de configuración de gráficos para personalizar las opciones de formato en las visualizaciones de Looker que usan la API de HighCharts. Esto incluye la mayoría de los gráficos cartesianos, como el gráfico de columnas, el gráfico de barras y el gráfico de líneas, entre otros.

Requisitos previos

Para acceder al Editor de configuración de gráficos, debes tener el permiso can_override_vis_config.

Personaliza una visualización

Para personalizar una visualización con el Editor de configuración de gráficos, sigue estos pasos:

  1. Mira una visualización en una exploración o edita una visualización en una Vista o panel.
  2. Abre el menú Editar en la visualización.

  3. Haz clic en el botón Editar configuración del gráfico en la pestaña Trazado. Looker muestra el diálogo Editar configuración del gráfico.

    • El panel Configuración del gráfico (fuente) contiene el JSON original de tu visualización y no se puede editar.

    • El panel Configuración del gráfico (anular) contiene el archivo JSON que debe anular el JSON de origen. Cuando abres por primera vez el diálogo Edit Chart Config, Looker propaga el panel con algún JSON predeterminado. Puedes comenzar con este JSON o borrarlo y, luego, ingresar cualquier JSON de HighCharts válido.

  4. Selecciona la sección Configuración de gráficos (anular) y, luego, ingresa un JSON de HighCharts válido. Los valores nuevos anularán cualquier valor de la sección Configuración del gráfico (fuente).

    • Consulta la sección Ejemplos de este artículo para ver ejemplos de JSON de HighCharts válidos.
    • Looker acepta cualquier valor JSON válido. Looker no acepta funciones, fechas ni valores indefinidos.

  5. Haz clic en <> (Format code) para permitir que Looker formatee tu JSON adecuadamente.

  6. Haz clic en Vista previa para probar los cambios.

  7. Haz clic en Aplicar para aplicar los cambios. La visualización se mostrará con los valores JSON personalizados.

Una vez que hayas personalizado tu visualización, puedes guardarla. Si viste la visualización en una exploración, guárdala. Si editaste una vista o un panel, haz clic en Guardar.

Si desea editar las opciones de visualización predeterminadas, primero quite todos los cambios realizados en el Editor de configuración de gráficos y reemplácelos más tarde. En particular, sigue estos pasos:

  1. Haz clic en el botón Editar configuración del gráfico en la pestaña Trazado. Looker muestra el diálogo Editar configuración del gráfico.
  2. Copia el texto del panel Configuración del gráfico (anular).
  3. Haz clic en el botón Clear Chart Overrides para borrar todos los cambios.
  4. Haz clic en Aplicar.
  5. Edita tu visualización con las opciones de visualización predeterminadas.
  6. Haz clic en el botón Editar configuración del gráfico en la pestaña Trazado. Looker muestra el diálogo Editar configuración del gráfico.
  7. Ingresa algún JSON de HighCharts válido en el panel Chart Config (Override). Puedes usar el texto que copiaste en el paso 2 como plantilla, pero asegúrate de probar los cambios con el botón Vista previa para asegurarte de que no haya conflictos.
  8. Haz clic en Aplicar.

Formato condicional con series formatters

El Editor de configuración de gráficos acepta la mayoría de los JSON de HighCharts válidos. También acepta el atributo series formatters, que solo existe en Looker. Cada serie puede tener varios formateadores para combinar diferentes reglas de estilo.

El atributo series formatters acepta dos atributos: select y style.

  • Ingresa una expresión lógica en el atributo select para indicar a qué valores de datos se les dará formato.
  • Ingresa algún JSON en el atributo style para indicar cómo dar formato a los valores de datos.

Por ejemplo, el siguiente JSON colorea cada valor de datos de color naranja si es mayor o igual que 380:

{
  series: [{
    formatters: [{
      select: 'value >= 380',
      style: {
        color: 'orange'
      }
    }]
  }]
}

En las siguientes secciones, se describen los posibles valores de los atributos select y style con más detalle.

El atributo select

Puedes usar los siguientes valores en una expresión select:

  • value: Esta variable muestra el valor de la serie. Por ejemplo, puedes usar select: value > 0 para segmentar todos los valores positivos o value = 100 para que solo coincida con las series con un valor de 100.
  • max: Usa select: max para orientar al valor de la serie que tiene el valor máximo.
  • min: Usa select: min para orientar al valor de la serie que tiene el valor mínimo.
  • percent_rank: Esta variable se orienta al valor de la serie con un percentil especificado. Por ejemplo, puedes usar select: percent_rank >= 0.9 para orientar los valores de la serie en el percentil noventa.
  • name: Esta variable muestra el valor de dimensión de la serie. Por ejemplo, si tienes un informe que muestra los pedidos vendidos, cancelados y devueltos, podrías usar select: name = Sold para segmentar la serie en la que se vende el valor de la dimensión.
  • AND/OR Usa AND y OR para combinar varias expresiones lógicas.

Para ver estas expresiones implementadas en el Editor de configuración de gráficos, consulta el ejemplo Cómo colorear los valores máximos, mínimos y percentiles.

El atributo style

El atributo style se puede usar para aplicar estilos compatibles con HighCharts. Por ejemplo, puedes establecer valores de series de colores con style.color, bordes de la serie de colores con style.borderColor y establecer el ancho de bordes de la serie con style.borderWidth. Para obtener una lista más completa de opciones de estilo, consulta Opciones de Highcharts para series.column.data.

Para las visualizaciones de líneas, usa style.marker.fillColor y style.marker.lineColor en lugar de style.color. Para obtener una lista más completa de opciones de estilo de línea, consulta Opciones de gráficos altos para series.line.data.marker.

Para ver los formatos de color implementados en el Editor de configuración de gráficos, consulta el ejemplo Colorear los valores máximos, mínimos y percentiles.

Ejemplos

En las siguientes secciones, se proporcionan ejemplos de algunos casos de uso comunes del Editor de configuración de gráficos. Para obtener una lista completa de los atributos que puedes editar, consulta la documentación de la API de HighCharts.

Cómo cambiar el color de fondo y el color del texto de los ejes

Para cambiar el color de fondo de una visualización, usa el atributo chart.backgroundColor.

De manera similar, para cambiar el color del texto de los ejes en una visualización, usa los siguientes atributos:

El siguiente JSON de HighCharts cambia el color de fondo de la visualización a púrpura, y el texto de los títulos de los ejes y las etiquetas a blanco.

{
  chart: {
    backgroundColor: "purple"
  },

  xAxis: {
    labels: {
      style: {
        color: "white"
      }
    },
    title: {
      style: {
        color: "white"
      }
    }
  },

  yAxis: {
    labels: {
      style: {
        color: "white"
      }
    },
    title: {
      style: {
        color: "white"
      }
    }
  }
}

Personalizar color del cuadro de información

Para personalizar el color de la información sobre la herramienta, usa los siguientes atributos:

El siguiente JSON de HighCharts cambia el color de fondo de la información sobre la herramienta a cian y cambia el color del texto del cuadro de información a negro.

{
  tooltip: {
    backgroundColor: "cyan",
    style: {
      color: "black"
    }
  }
}

Personaliza el contenido y los estilos de la información sobre la herramienta

Para personalizar el contenido de la información sobre la herramienta, usa los siguientes atributos:

El siguiente JSON de HighCharts cambia el formato de información sobre la herramienta de modo que el valor del eje X aparezca en la parte superior de la información con una fuente más grande, seguido de una lista de todos los valores de la serie en ese punto.

En este ejemplo, se usan las siguientes funciones y variables de HighCharts:

  • {key} es una variable que muestra el valor del eje X del punto seleccionado. (en este ejemplo, el mes y el año).
  • {#each points}{/each} es una función que repite el código incluido para cada serie del gráfico.
  • {series.name} es una variable que muestra el nombre de la serie.
  • {y:.2f} es una variable que muestra el valor del eje Y del punto seleccionado, redondeado a dos decimales.
    • {y} es una variable que muestra el valor del eje Y del punto seleccionado.
    • {variable:.2f} redondea variable a dos decimales. Consulta la documentación sobre plantillas de Highcharts para ver más ejemplos de formato de valores.
{
  tooltip: {
    format: '<span style="font-size: 1.8em">{key}</span><br/>{#each points}<span style="color:{color}; font-weight: bold;">\u25CF {series.name}: </span>{y:.2f}<br/>{/each}',
    shared: true
  },
}

Agrega anotaciones y leyendas a los gráficos

Para agregar una anotación, usa el atributo annotations. Para agregar una leyenda al gráfico, usa el atributo caption.

Para obtener las coordenadas de un punto, haz clic en Inspect Point Metadata en la parte superior del diálogo Edit Chart Config. Luego, mantén el puntero sobre el punto de datos que deseas anotar. Looker muestra un ID de punto, que puedes usar en el atributo annotations.labels.point.

El siguiente JSON de HighCharts agrega dos anotaciones al gráfico para explicar una disminución en los elementos del inventario después de determinados períodos. También agrega una leyenda a la parte inferior del gráfico para explicar las anotaciones con más detalle.

{
  caption: {
    text: 'Items go on clearance after 60 days, and are thrown away after 80 days. Thus we see large drops in inventory after these events.'
  },
  annotations: [{
    labels: [{
        point: "inventory_items.count-60-79",
        text: "Clearance sale"
      },
      {
        point: "inventory_items.count-80+",
        text: "Thrown away"
      },
    ]
  }]
}

Agrega bandas de referencia verticales

Para agregar una banda de referencia vertical, usa el atributo xAxis.plotBands.

En el siguiente archivo JSON de HighCharts, se agrega una banda de referencia vertical entre el 24 y el 29 de noviembre de 2022 para indicar un período de venta. También agrega una leyenda a la parte inferior del gráfico para explicar la importancia de la banda.

Ten en cuenta que los atributos to y from de xAxis.plotBands deben corresponder a los valores de datos del gráfico. En este ejemplo, dado que los datos se basan en el tiempo, los atributos aceptan valores de marca de tiempo Unix (1669680000000 para el 29 de noviembre de 2022 y 1669248000000 para el 24 de noviembre de 2022). Los formatos de fecha basados en cadenas, como DD/MM/AAAA y DD-MM-AA no se admiten en los atributos HighCharts to y from.

{
  caption: {
    text: 'This chart uses the HighCharts plotBands attribute to display a band around the Black Friday Cyber Monday sale period.'
  },
  xAxis: {
    plotBands: [{
      to: 1669680000000,
      from: 1669248000000,
      label: {
        text: 'BFCM Sale Period'
      }
    }]
  },
}

Colorea los valores máximos, mínimos y percentiles

Consulta la página Aprovecha al máximo las visualizaciones de Looker: personalización del formato condicional en gráficos cartesianos para ver un ejemplo detallado sobre cómo colorear los valores máximos, mínimos y percentiles de una visualización cartesiana.

Crea nuevos tipos de visualizaciones

Puedes usar el Editor de configuración del gráfico para crear tipos de visualizaciones que no están incluidos en los tipos de visualizaciones predeterminados de Looker. Los siguientes artículos proporcionan ejemplos de algunas de las visualizaciones que puedes diseñar con el Editor de configuración de gráficos: