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. Ver una visualización en una exploración o editar una visualización en una vista o un panel
  2. Abre el menú Editar en la visualización.

  3. Haz clic en el botón Edit Chart Config en la pestaña Plot. Looker muestra el diálogo Edit Chart Config.

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

    • El panel Chart Config (Override) contiene el 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 válido de HighCharts.

  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 válidos de JSON de HighCharts.
    • Looker acepta cualquier valor JSON válido. Looker no acepta funciones, fechas ni valores no definidos.

  5. Haz clic en <> (Format code) para permitir que Looker aplique el formato correcto a tu JSON.

  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 la visualización, podrás guardarla. Si viste la visualización en una exploración, guarda la exploración. Si editaste una vista o un panel, haz clic en Guardar.

Si intentas obtener una vista previa del código que contiene un JSON no válido, Looker mostrará un mensaje de error Invalid JSON detected . Puedes limpiar el JSON no válido con la opción Autofix code en la parte inferior del panel Chart Config (Override).

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. Específicamente, 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 Edit Chart Config.
  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 Edit Chart Config.
  7. Ingresa un JSON de HighCharts válido en el panel Configuración del gráfico (anulación). 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 valores potenciales 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 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 segmentar el 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 segmentar valores de series en el percentil noventa.
  • name: Esta variable muestra el valor de la dimensión de la serie. Por ejemplo, si tuvieras un gráfico que muestre los pedidos vendidos, cancelados y devueltos, podrías usar select: name = Sold para segmentar la serie en la que el valor de la dimensión es vendido.
  • 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 que admite 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 las opciones de diseño, consulta las 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 las opciones de estilo de línea, consulta las opciones de Highcharts para series.line.data.marker.

Para ver los formatos de color implementados en el Editor de configuración de gráficos, consulta el ejemplo Cómo 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 del fondo y el color del texto de los ejes

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

Del mismo modo, 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 y las etiquetas del eje a blanco.

{
  chart: {
    backgroundColor: "purple"
  },

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

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

Personaliza el color de la información sobre herramientas

Para personalizar el color de la información sobre herramientas, 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 las ventanas de información

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

El siguiente JSON de HighCharts cambia el formato de la información sobre herramientas de modo que el valor del eje x aparezca en la parte superior de la información sobre herramientas en 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 cuadro de diálogo Edit Chart Config. Luego, coloca el puntero sobre el dato 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 artículos del inventario después de ciertos 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.

El siguiente JSON de HighCharts agrega una banda de referencia vertical entre el 24 de noviembre de 2022 y el 29 de noviembre de 2022 para indicar un período de oferta. También agrega una leyenda a la parte inferior del gráfico para explicar el significado 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'
      }
    }]
  },
}

Agrega líneas punteadas y discontinuas

Para cambiar las líneas continuas a líneas punteadas o punteadas, usa el atributo series.dashStyle.

El siguiente JSON de HighCharts cambia el atributo dashStyle de la serie Customers a una línea punteada, y el atributo dashStyle de la serie Sales a una línea de puntos.

{
  series: [{
    name: 'Customers',
    dashStyle: 'Dash'
  }, {
    name: 'Sales',
    dashStyle: 'Dot'
  }]
}

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

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

Cómo crear nuevos tipos de visualización

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: