Personalizzazione delle visualizzazioni con l'editor di configurazione dei grafici

Puoi utilizzare l'editor di configurazione dei grafici per personalizzare le opzioni di formattazione nelle visualizzazioni di Looker che utilizzano l'API HighCharts. È inclusa la maggior parte dei grafici cartesiani, tra cui ad esempio i grafici a colonne, il grafico a barre e il grafico a linee.

Prerequisiti

Per accedere all'editor di configurazione del grafico, devi disporre dell'autorizzazione can_override_vis_config.

Personalizzazione di una visualizzazione

Per personalizzare una visualizzazione con l'editor di configurazione dei grafici:

  1. Visualizza una visualizzazione in un'esplorazione oppure modificane una in un Look o in una dashboard.
  2. Apri il menu Modifica nella visualizzazione.

  3. Fai clic sul pulsante Modifica configurazione grafico nella scheda Traccia. Looker mostra la finestra di dialogo Modifica configurazione grafico.

    • Il riquadro Configurazione grafico (origine) contiene il file JSON originale della visualizzazione e non può essere modificato.

    • Il riquadro Configurazione grafico (override) contiene il codice JSON che deve sostituire quello di origine. Quando apri per la prima volta la finestra di dialogo Modifica configurazione grafico, Looker compila il riquadro con alcuni file JSON predefiniti. Puoi iniziare con questo JSON oppure puoi eliminarlo e inserire un qualsiasi JSON HighCharts valido.

  4. Seleziona la sezione Configurazione grafico (override) e inserisci un file JSON HighCharts valido. I nuovi valori sostituiranno tutti i valori nella sezione Configurazione del grafico (origine).

    • Consulta la sezione Esempi di questo articolo per trovare esempi di JSON HighCharts valido.
    • Looker accetta qualsiasi valore JSON valido. Looker non accetta funzioni, date o valori non definiti.

  5. Fai clic su <> (Formatta codice) per consentire a Looker di formattare correttamente il tuo JSON.

  6. Fai clic su Anteprima per verificare le modifiche.

  7. Fai clic su Applica per applicare le modifiche. La visualizzazione verrà mostrata utilizzando i valori JSON personalizzati.

Dopo aver personalizzato la visualizzazione, puoi salvarla. Se hai visualizzato la visualizzazione durante un'esplorazione, salva l'esplorazione. Se hai modificato un Look o una dashboard, fai clic su Salva.

Per modificare le opzioni di visualizzazione predefinite, rimuovi prima tutte le modifiche apportate nell'editor di configurazione dei grafici e poi sostituiscile in un secondo momento. In particolare, segui questi passaggi:

  1. Fai clic sul pulsante Modifica configurazione grafico nella scheda Traccia. Looker mostra la finestra di dialogo Modifica configurazione grafico.
  2. Copia il testo nel riquadro Configurazione grafico (override).
  3. Fai clic sul pulsante Cancella override grafico per eliminare tutte le modifiche.
  4. Fai clic su Applica.
  5. Modifica la visualizzazione utilizzando le opzioni di visualizzazione predefinite.
  6. Fai clic sul pulsante Modifica configurazione grafico nella scheda Traccia. Looker mostra la finestra di dialogo Modifica configurazione grafico.
  7. Inserisci un file JSON HighCharts valido nel riquadro Configurazione grafico (override). Puoi utilizzare il testo copiato nel passaggio 2 come modello, ma assicurati di testare le modifiche utilizzando il pulsante Anteprima per assicurarti che non ci siano conflitti.
  8. Fai clic su Applica.

Formattazione condizionale con series formatters

L'editor di configurazione dei grafici accetta il codice JSON HighCharts più valido. Accetta anche l'attributo series formatters, che esiste solo in Looker. Ogni serie può avere più formattatori per combinare regole di stile diverse.

L'attributo series formatters accetta due attributi: select e style.

  • Inserisci un'espressione logica nell'attributo select per indicare i valori dei dati che verranno formattati.
  • Inserisci alcuni JSON nell'attributo style per indicare come formattare i valori dei dati.

Ad esempio, il seguente JSON colora ogni valore di dati in arancione se è maggiore o uguale a 380:

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

Le seguenti sezioni descrivono in maggiore dettaglio i valori potenziali degli attributi select e style.

Attributo select

In un'espressione select puoi utilizzare i seguenti valori:

  • value: questa variabile restituisce il valore della serie. Ad esempio, puoi utilizzare select: value > 0 per scegliere come target tutti i valori positivi oppure value = 100 per creare corrispondenze solo per le serie con un valore pari a 100.
  • max: utilizza select: max per scegliere come target il valore della serie che contiene il valore massimo.
  • min: utilizza select: min per scegliere come target il valore della serie con il valore minimo.
  • percent_rank: questa variabile ha come target il valore della serie con un percentile specificato. Ad esempio, potresti utilizzare select: percent_rank >= 0.9 per scegliere come target i valori delle serie nel novantesimo percentile.
  • name: questa variabile restituisce il valore della dimensione della serie. Ad esempio, se avessi un report che mostra ordini venduti, annullati e restituiti, potresti utilizzare select: name = Sold per scegliere come target la serie in cui il valore della dimensione è venduto.
  • AND/OR Utilizza AND e OR per combinare più espressioni logiche.

Per vedere l'implementazione di queste espressioni nell'editor di configurazione dei grafici, fai riferimento all'esempio Colore dei valori massimo, minimo e percentile.

Attributo style

L'attributo style può essere utilizzato per applicare gli stili supportati da HighCharts. Ad esempio, puoi colorare i valori delle serie utilizzando style.color, i bordi delle serie utilizzando style.borderColor e impostare la larghezza dei bordi della serie utilizzando style.borderWidth. Per un elenco più completo di opzioni di stile, consulta le opzioni di Highcharts per series.column.data.

Per le visualizzazioni a linee, utilizza style.marker.fillColor e style.marker.lineColor anziché style.color. Per un elenco più completo di opzioni di stile delle linee, vedi le opzioni di Highcharts per series.line.data.marker.

Per visualizzare la formattazione dei colori implementata nell'editor di configurazione dei grafici, fai riferimento all'esempio Applicare colori ai valori massimo, minimo e percentile.

Esempi

Le sezioni seguenti forniscono esempi di alcuni casi d'uso comuni per l'editor di configurazione dei grafici. Per un elenco completo degli attributi che puoi modificare, consulta la documentazione dell'API HighCharts.

Modificare il colore dello sfondo e del testo dell'asse

Per modificare il colore di sfondo di una visualizzazione, utilizza l'attributo chart.backgroundColor.

Allo stesso modo, per modificare il colore del testo degli assi in una visualizzazione, utilizza i seguenti attributi:

Il seguente JSON HighCharts cambia il colore di sfondo della visualizzazione in viola e il testo dei titoli e delle etichette degli assi in bianco.

{
  chart: {
    backgroundColor: "purple"
  },

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

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

Personalizza colore descrizione comando

Per personalizzare il colore della descrizione comando, utilizza i seguenti attributi:

Il seguente JSON HighCharts cambia il colore di sfondo della descrizione comando in ciano e il colore del testo della descrizione comando in nero.

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

Personalizza contenuti e stili della descrizione comando

Per personalizzare il contenuto della descrizione comando, utilizza i seguenti attributi:

Il seguente JSON HighCharts modifica il formato della descrizione comando in modo che il valore dell'asse X venga visualizzato nella parte superiore della descrizione comando con un carattere più grande, seguito da un elenco di tutti i valori della serie in quel punto.

Questo esempio utilizza le seguenti funzioni e variabili HighCharts:

  • {key} è una variabile che restituisce il valore dell'asse x del punto selezionato. (in questo esempio, mese e anno).
  • {#each points}{/each} è una funzione che ripete il codice racchiuso per ogni serie nel grafico.
  • {series.name} è una variabile che restituisce il nome della serie.
  • {y:.2f} è una variabile che restituisce il valore dell'asse y del punto selezionato, arrotondato a due cifre decimali.
    • {y} è una variabile che restituisce il valore dell'asse y del punto selezionato.
    • {variable:.2f} arrotonda variable a due cifre decimali. Consulta la documentazione relativa ai modelli Highcharts per altri esempi di formattazione dei valori.
{
  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
  },
}

Aggiungere annotazioni e didascalie al grafico

Per aggiungere un'annotazione, utilizza l'attributo annotations. Per aggiungere una didascalia al grafico, utilizza l'attributo caption.

Per ottenere le coordinate di un punto, fai clic su Ispeziona metadati punti nella parte superiore della finestra di dialogo Modifica configurazione grafico. Poi, tieni il puntatore sopra il punto dati da annotare. Looker visualizza un ID punto che puoi utilizzare nell'attributo annotations.labels.point.

Il seguente JSON HighCharts aggiunge due annotazioni al grafico per spiegare una diminuzione degli articoli dell'inventario dopo determinati periodi di tempo. Viene inoltre aggiunta una didascalia nella parte inferiore del grafico per spiegare le annotazioni in modo più dettagliato.

{
  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"
      },
    ]
  }]
}

Aggiungere bande di riferimento verticali

Per aggiungere una banda di riferimento verticale, utilizza l'attributo xAxis.plotBands.

Il seguente JSON HighCharts aggiunge una banda di riferimento verticale tra il 24 e il 29 novembre 2022 per indicare un periodo di vendita. Inoltre, è stata aggiunta una didascalia nella parte inferiore del grafico per spiegare il significato del cinturino.

Tieni presente che gli attributi to e from di xAxis.plotBands devono corrispondere ai valori dei dati nel grafico. In questo esempio, poiché i dati sono basati sul tempo, gli attributi accettano i valori del timestamp Unix (1669680000000 per il 29 novembre 2022 e 1669248000000 per il 24 novembre 2022). I formati della data basati su stringhe, come MM/GG/AAAA e GG-MM-AA, non sono supportati negli attributi to e from HighCharts.

{
  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'
      }
    }]
  },
}

Colorare i valori massimo, minimo e percentile

Consulta la pagina Come ottenere il massimo dalle visualizzazioni di Looker: personalizzazione della formattazione condizionale nei grafici cartesiani per un esempio approfondito su come colorare i valori massimo, minimo e percentile di una visualizzazione cartesiana.

Creazione di nuovi tipi di visualizzazione

Puoi utilizzare l'editor di configurazione dei grafici per creare tipi di visualizzazione che non sono inclusi nei tipi di visualizzazione predefiniti di Looker. I seguenti articoli forniscono esempi di alcune delle visualizzazioni che puoi progettare con l'editor di configurazione dei grafici: