Parametri del grafico box plot per le dashboard LookML

Questa pagina mostra come aggiungere e personalizzare un elemento della dashboard LookML di type: looker_boxplot con i parametri della dashboard LookML in un file dashboard.lkml.

Per informazioni sulla creazione di un grafico box plot tramite l'interfaccia utente di Looker, consulta la pagina della documentazione Opzioni dei grafici box plot.

Esempio di utilizzo

Un N indica che è richiesto un valore numerico. Le virgolette singole indicano il testo descrittivo e non devono essere incluse nel codice pubblicato.

## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_boxplot
height: N
width: N
top: N
left: N
row: N
col: N
refresh: N (seconds | minutes | hours | days)
note:
  text: 'note text'
  state: collapsed | expanded
  display: above | below | hover

## QUERY PARAMETERS
model: model_name
explore: explore_name
fields: [view_name.field_name, view_name.field_name, view_name.field_name, …]
dimensions: [view_name.field_name, view_name.field_name, …]
measures: [view_name.field_name, view_name.field_name, …]
sorts: [view_name.field_name asc | desc, view_name.field_name, …]
limit: N
filters:
  view_name.field_name: 'looker filter expression'
listen:
  dashboard_filter_name: view_name.field_name
query_timezone: 'specific timezone' | user_timezone
hidden_fields: [view_name.field_name, view_name.field_name, …]

## SERIES PARAMETERS

color_application:
  collection_id: 'collection ID'
  palette_id: 'palette ID'
  options:
    reverse: true | false

## STYLE PARAMETERS

show_view_names: true | false

## X-AXIS PARAMETERS

show_x_axis_label: true | false
x_axis_label: 'desired x-axis label'
show_x_axis_ticks: true | false
x_axis_gridlines: true | false
x_axis_reversed: true | false
x_axis_zoom: true | false

## Y-AXIS PARAMETERS

show_y_axis_labels: true | false
y_axis_labels: ['desired y-axis label']
show_y_axis_ticks: true | false
y_axis_gridlines: true | false
y_axis_min: ['N']
y_axis_max: ['N']
y_axis_tick_density: default | custom
y_axis_tick_density_custom: 'N'
y_axis_reversed: true | false
y_axis_value_format: ['Excel-style formatting']
y_axis_zoom: true | false

## ADVANCED VISUALIZATION CONFIGURATION PARAMETERS
advanced_vis_config: 'Highcharts JSON snippet'

Definizioni dei parametri

Nome parametro	Descrizione
Parametri di base
name (per gli elementi)	Crea un elemento
title (per gli elementi)	Modifica il modo in cui il nome di un elemento viene visualizzato dagli utenti
type (per gli elementi)	Determina il tipo di visualizzazione da utilizzare nell'elemento
height (per gli elementi)	Definisce l'altezza di un elemento, in unità di tile_size, per le dashboard layout: tile e layout: static
width (per gli elementi)	Definisce la larghezza di un elemento, in unità di tile_size, per le dashboard layout: tile e layout: static
top	Definisce la posizione dall'alto verso il basso di un elemento, in unità di tile_size, per le dashboard layout: static
left	Definisce la posizione da sinistra a destra di un elemento, in unità di tile_size, per le dashboard layout: static
row	Definisce la posizione dall'alto verso il basso di un elemento, in unità di righe, per le dashboard layout: newspaper
col	Definisce la posizione da sinistra a destra di un elemento, in unità di colonne, per le dashboard layout: newspaper
refresh (per gli elementi)	Imposta l'intervallo di aggiornamento automatico dell'elemento
note	Avvia una sezione di LookML per definire una nota per un elemento. Questo parametro ha i sottoparametri text, state e display.
Parametri di query
model	Definisce il modello da utilizzare per la query dell'elemento
explore (per gli elementi)	Definisce l'esplorazione da utilizzare per la query dell'elemento
fields	Definisce i campi da utilizzare per la query dell'elemento. Può essere utilizzato al posto di dimensions e measures.
dimensions	Definisce le dimensioni da utilizzare per la query dell'elemento
measures	Definisce le misure da utilizzare per la query dell'elemento
sorts	Definisce gli ordinamenti da utilizzare per la query dell'elemento
limit	Definisce il limite di righe da utilizzare per la query dell'elemento
filters (per gli elementi)	Definisce i filtri che non possono essere modificati per la query dell'elemento
listen	Definisce i filtri che possono essere modificati per la query dell'elemento, se sono stati creati filters (per la dashboard)
query_timezone	Definisce il fuso orario da utilizzare quando viene eseguita la query
hidden_fields	Specifica i campi da utilizzare nella query, ma da nascondere nel grafico
Parametri delle serie
color_application	Applica una raccolta di colori e una tavolozza al grafico
Parametri di stile
show_view_names	Mostra o nasconde i nomi delle visualizzazioni dalle etichette dei grafici
Parametri dell'asse X
show_x_axis_label	Mostra o nasconde l'etichetta dell'asse X
x_axis_label	Definisce un'etichetta personalizzata per l'asse X
show_x_axis_ticks	Mostra i valori sull'asse X
x_axis_gridlines	Estende le linee della griglia dall'asse X
x_axis_reversed	Inverte la direzione dell'asse X
x_axis_zoom	Specifica se consentire lo zoom lungo l'asse X
Parametri dell'asse Y
show_y_axis_labels	Mostra o nasconde l'etichetta dell'asse Y
y_axis_labels	Definisce un'etichetta dell'asse Y personalizzata
show_y_axis_ticks	Mostra i valori sull'asse Y
y_axis_gridlines	Estende le linee della griglia dall'asse Y
y_axis_min	Definisce un valore minimo per l'asse Y
y_axis_max	Definisce un valore massimo per l'asse Y
y_axis_tick_density	Attiva l'opzione per impostare una densità dei segni di graduazione dell'asse Y personalizzata con il parametro y_axis_tick_density_custom
y_axis_tick_density_custom	Definisce la densità delle tacche dell'asse Y quando y_axis_tick_density è impostato su custom
y_axis_reversed	Inverte la direzione dell'asse Y
y_axis_value_format	Definisce il formato numerico dei valori dell'asse Y
y_axis_zoom	Specifica se consentire lo zoom lungo l'asse Y. Disattivata se x_axis_zoom: false.
Parametri di configurazione della visualizzazione avanzata
advanced_viz_config	Accetta uno snippet JSON HighCharts che può eseguire l'override di diverse impostazioni di visualizzazione

Parametri base

Quando definisci un elemento della dashboard LookML, devi specificare i valori almeno per i parametri di base name e type. Altri parametri di base, come title, height e width, influiscono sull'aspetto e sulla posizione di un elemento in una dashboard.

name

Questa sezione si riferisce al parametro name, che fa parte di un elemento della dashboard.

name può essere utilizzato anche come parte di un filtro della dashboard, descritto nella pagina della documentazione dedicata ai parametri della dashboard.

Ogni dichiarazione name crea un nuovo elemento della dashboard e gli assegna un nome. I nomi degli elementi devono essere univoci. A volte i nomi vengono indicati nel parametro elements quando utilizzi le dashboard layout: grid o nel parametro group degli elementi secondari quando organizzi gli elementi in un gruppo di riquadri (type: group).

- name: orders_by_date

title

Questa sezione si riferisce al parametro title, che fa parte di un elemento della dashboard.

title può essere utilizzato anche nell'ambito di una dashboard, come descritto nella pagina della documentazione dedicata ai parametri della dashboard.

title può essere utilizzato anche come parte di un filtro della dashboard, descritto nella pagina della documentazione dedicata ai parametri della dashboard.

Il parametro title ti consente di modificare il modo in cui il nome di un elemento viene visualizzato dagli utenti. Se non specificato, il titolo predefinito è l'elemento name.

Considera questo esempio:

- name: sales_overview
  title: '1) Sales Overview'

Se hai utilizzato questo formato, l'elemento non verrà visualizzato come Panoramica delle vendite, ma come 1) Panoramica delle vendite.

type

Questa sezione si riferisce al parametro type, che fa parte di un elemento della dashboard.

type può essere utilizzato anche come parte di un filtro della dashboard, descritto nella pagina della documentazione dedicata ai parametri della dashboard.

type può essere utilizzato anche nell'ambito di un join, come spiegato nella pagina della documentazione dedicata al parametro type (per i join).

type può essere utilizzato anche come parte di una dimensione, come descritto nella pagina della documentazione Tipi di dimensioni, filtri e parametri.

type può essere utilizzato anche come parte di una misura, descritta nella pagina della documentazione Tipi di misure.

Il parametro type determina il tipo di visualizzazione da utilizzare nell'elemento.

- name: element_name
  type: text | looker_grid | table | single_value | looker_single_record |
        looker_column | looker_bar | looker_scatter | looker_line | looker_area |
        looker_pie | looker_donut_multiples | looker_funnel | looker_timeline |
        looker_map | looker_google_map | looker_geo_coordinates | looker_geo_choropleth |
        looker_waterfall | looker_wordcloud | looker_boxplot | button | group

Per una panoramica dei diversi tipi di elementi della dashboard LookML, consulta la pagina della documentazione type (per le dashboard LookML).

height

Questa sezione si riferisce al parametro height, che fa parte di un elemento della dashboard.

height può essere utilizzato anche come parte di una riga della dashboard, descritta nella pagina della documentazione relativa ai parametri della dashboard.

Per le dashboard con layout tile o static

Il parametro height definisce l'altezza di un elemento, in unità di tile_size (definita in pixel), per le dashboard layout: tile e layout: static.

Ad esempio, il codice seguente specifica tile_size: 100 e height: 4, rendendo l'elemento orders_by_date alto 400 pixel.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    height: 4
    ...

Per le dashboard con layout newspaper

Il parametro height definisce l'altezza di un elemento, in unità di row, per le dashboard layout: newspaper.

Per impostazione predefinita, una dashboard con layout di giornale ha un'altezza degli elementi di 6 righe o circa 300 pixel. L'altezza minima è di 1 riga per le dashboard con un parametro preferred viewer impostato su dashboards-next. L'altezza minima è di 2 righe per le dashboard con un parametro preferred viewer impostato su dashboards.

Ad esempio, il seguente codice imposta un elemento in modo che sia alto 12 righe, ovvero il doppio rispetto agli altri elementi impostati sul valore predefinito:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    height: 12
    ...

width

Questa sezione si riferisce al parametro width, che fa parte di un elemento della dashboard.

width può essere utilizzato anche nell'ambito di una dashboard, come descritto nella pagina della documentazione dedicata ai parametri della dashboard.

Il parametro width definisce la larghezza di un elemento, in unità di tile_size, per le dashboard layout: tile e layout: static.

Ad esempio, il seguente codice specifica tile_size: 100 e width: 4, rendendo l'elemento orders_by_date largo 400 pixel.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    width: 4
    ...

Il parametro width definisce la larghezza di un elemento, in unità di colonne, per le dashboard layout: newspaper.

Una dashboard con layout di tipo giornale ha una larghezza predefinita di 24 colonne.

Ad esempio, il seguente codice imposta l'elemento su metà della larghezza della dashboard:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    width: 12
    ...

top

Il parametro top definisce la posizione dall'alto verso il basso di un elemento, in unità di tile_size, per le dashboard layout: static.

Ad esempio, il seguente codice specifica tile_size: 100 e top: 4, posizionando il bordo superiore dell'elemento orders_by_date a 400 pixel dalla parte superiore della dashboard.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    top: 4
    ...

left

Il parametro left definisce la posizione da sinistra a destra di un elemento, in unità di tile_size, per le dashboard layout: static.

Ad esempio, il codice seguente specifica tile_size: 100 e left: 4, posizionando il bordo sinistro dell'elemento orders_by_date a 400 pixel dal lato sinistro della dashboard.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    left: 4
    ...

row

Per le dashboard layout: newspaper, il parametro row definisce la riga su cui viene posizionato il bordo superiore di un elemento. Se l'elemento viene inserito in un gruppo di riquadri utilizzando il parametro group, row definisce la posizione della riga dell'elemento rispetto alla parte superiore del contenitore del gruppo (row: 0).

Una dashboard inizia con la riga 0 nella parte superiore. Una dashboard con layout di tipo giornale ha un'altezza predefinita degli elementi di 6 righe, il che significa che gli elementi della dashboard nella parte superiore di una dashboard (row: 0) occuperebbero per impostazione predefinita le righe 0-5.

Ogni riga è alta 50 pixel, il che significa che l'altezza predefinita dell'elemento di 6 righe è di 300 pixel.

Ad esempio, il seguente codice imposta un elemento da inserire nella seconda riga di elementi della dashboard, supponendo che gli elementi siano impostati sull'altezza predefinita:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    row: 6
    ...

col

Per le dashboard layout: newspaper, il parametro col definisce la colonna in cui è posizionato il bordo sinistro dell'elemento. Se l'elemento viene inserito in un gruppo di riquadri utilizzando il parametro group, col definisce la posizione della colonna dell'elemento rispetto al bordo sinistro del contenitore del gruppo (col: 0).

Le dashboard sono suddivise in 24 colonne. Una dashboard inizia con la colonna 0 a sinistra. Una dashboard con layout di tipo giornale ha una larghezza predefinita degli elementi di 8 colonne, il che significa che gli elementi della dashboard a sinistra di una dashboard (col: 0) occuperebbero per impostazione predefinita le colonne 0-7.

Ad esempio, il seguente codice imposta un elemento da inserire nella terza colonna di elementi della dashboard:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    col: 16
    ...

refresh

Questa sezione si riferisce al parametro refresh, che fa parte di un elemento della dashboard.

refresh può essere utilizzato anche nell'ambito di una dashboard, come descritto nella pagina della documentazione dedicata ai parametri della dashboard.

Il parametro refresh consente a un elemento di ricaricarsi automaticamente a intervalli regolari, recuperando così dati aggiornati. Questa opzione è spesso utile in contesti in cui una dashboard viene visualizzata costantemente, ad esempio sulla TV di un ufficio. Tieni presente che la dashboard deve essere aperta in una finestra del browser affinché questo parametro abbia effetto. Questa impostazione non viene eseguita in background per "pre-riscaldare" la cache della dashboard.

La frequenza di aggiornamento può essere un numero qualsiasi (senza decimali) di secondi, minuti, ore o giorni. Ad esempio:

- name: orders_by_date
  refresh: 2 hours

Presta attenzione quando imposti intervalli di aggiornamento brevi. Se la query alla base dell'elemento richiede molte risorse, alcuni elementi potrebbero sovraccaricare il database più del previsto.

note

Puoi aggiungere note descrittive agli elementi in questo modo:

- name: element_name
  note:
    text: 'note text'
    state: collapsed | expanded
    display: above | below | hover

note ha i sottoparametri text, state e display.

text

Il sottoparametro text specifica il testo visualizzato nella nota. Il testo può essere localizzato.

state

Il sottoparametro state determina se la nota verrà collapsed o expanded se è troppo grande per essere inserita in una singola riga all'interno della larghezza dell'elemento. Se scegli collapsed e la nota è troppo lunga, terminerà con dei puntini di sospensione cliccabili (...) che possono essere utilizzati per leggere la nota completa.

display

Il sottoparametro display determina dove viene visualizzata la nota su un elemento. above posiziona la nota nella parte superiore di un elemento, below la posiziona nella parte inferiore di un elemento e hover richiede all'utente di passare il mouse sopra l'elemento per visualizzare la nota.

Parametri di query

Quando definisci un elemento della dashboard LookML, devi specificare i valori almeno per i parametri di ricerca model e explore.

Gli elementi di type: looker_boxplot richiedono anche almeno una dimensione e due, tre o cinque dei seguenti tipi di misure (che devono essere elencati in questo ordine):

• Minimo: una misura che rappresenta il valore minimo dei dati. Puoi definirlo in LookML come misura di type: min.
• 25° percentile: una misura che rappresenta il 25° percentile o il primo quartile. Un quarto dei valori dei dati è inferiore o uguale a questo valore. Questo può essere definito in LookML come una misura di type: percentile con il valore di percentile impostato su 25.
• Mediana: una misura che rappresenta la mediana o il punto medio del set di dati o il secondo quartile. Metà dei valori dei dati è inferiore o uguale a questo valore. Puoi definirlo in LookML come misura di type: median.
• 75° percentile: una misura che rappresenta il 75° percentile o il terzo quartile. Tre quarti dei valori dei dati sono inferiori o uguali a questo valore. Può essere definita in LookML come misura di type: percentile con il valore di percentile impostato su 75.
• Massimo: una misura che rappresenta il valore massimo. Puoi definirlo in LookML come misura di type: max.

Puoi utilizzare il parametro fields o entrambi i parametri dimensions e measures per specificare le dimensioni e le misure su cui si basa un elemento box plot. Per saperne di più sulla creazione di un grafico box plot nell'interfaccia utente di Looker, consulta la sezione Creazione di un grafico box plot della pagina della documentazione Opzioni dei grafici box plot.

Puoi utilizzare gli altri parametri di ricerca descritti in questa sezione per controllare il modo in cui i dati vengono visualizzati in un elemento della dashboard.

model

Il parametro model definisce il modello da utilizzare per la query dell'elemento. Se non specificato, il valore predefinito sarà il modello in cui si trova la dashboard.

- name: orders_by_date
  model: ecommerce

Il parametro model accetta le costanti LookML. Puoi definire una costante nel file manifest del progetto, quindi utilizzare la sintassi "@{constant_name}" per impostare la costante come valore per model. L'utilizzo di una costante consente di definire il nome di un modello in un unico punto, il che è particolarmente utile se stai aggiornando il nome di un modello utilizzato da più elementi della dashboard.

Per ulteriori informazioni e un esempio di utilizzo delle costanti con le dashboard LookML, consulta la pagina della documentazione del parametro constant.

explore

Questa sezione si riferisce al parametro explore, che fa parte di un elemento della dashboard.

explore può essere utilizzato anche nell'ambito di un modello, come spiegato nella pagina della documentazione dedicata al parametro explore.

explore può essere utilizzato anche come parte di un filtro della dashboard, descritto nella pagina della documentazione dedicata ai parametri della dashboard.

Il parametro explore definisce l'esplorazione da utilizzare per la query dell'elemento.

- name: orders_by_date
  explore: order

Il parametro explore accetta le costanti LookML. Puoi definire una costante nel file manifest del progetto, quindi utilizzare la sintassi "@{constant_name}" per impostare la costante come valore per explore. L'utilizzo di una costante consente di definire il nome di un'esplorazione in un unico punto, il che è particolarmente utile se stai aggiornando il nome di un'esplorazione utilizzata da più elementi della dashboard.

Per ulteriori informazioni e un esempio di utilizzo delle costanti con le dashboard LookML, consulta la pagina della documentazione del parametro constant.

fields

Il parametro fields definisce i campi da utilizzare per la query dell'elemento. Utilizza la sintassi view_name.dimension_name per specificare i campi.

## single field example
- name: orders_by_date
  fields: order.order_date

## multiple fields example
- name: orders_by_date
  fields: [order.order_date, order.order_count]

Se utilizzi il parametro fields, non è necessario utilizzare i parametri dimensions e measures.

dimensions

Il parametro dimensions definisce la dimensione o le dimensioni da utilizzare per la query dell'elemento. Utilizza la sintassi view_name.dimension_name per specificare la dimensione. Non includere dimensions se la query non ne ha.

## single dimension example
- name: orders_by_date
  dimensions: order.order_date

## multiple dimension example
- name: orders_by_date
  dimensions: [order.order_date, customer.name]

measures

Il parametro measures definisce la misura o le misure da utilizzare per la query dell'elemento. Utilizza la sintassi view_name.measure_name per specificare la misura. Non includere measures se la query non ne ha.

## single measure example
- name: orders_by_date
  measures: order.count

## multiple measure example
- name: orders_by_date
  measures: [order.count, order_item.count]

sorts

Il parametro sorts definisce il comportamento di ordinamento per la query dell'elemento. Elenca prima il campo di ordinamento principale, seguito da eventuali campi di ordinamento secondari. Utilizza la sintassi view_name.field_name per specificare la dimensione o la misura in base alla quale ordinare.

Se ometti il parametro sorts, l'elemento utilizza l'ordinamento predefinito di Looker. Gli ordinamenti crescenti non richiedono un suffisso, mentre quelli decrescenti richiedono il suffisso desc.

L'esempio seguente definisce un singolo ordinamento:

- name: orders_by_date
  sorts: order.order_date desc

L'esempio seguente definisce più ordinamenti:

- name: orders_by_date
  sorts: [order.order_date desc, customer.name]

Se utilizzi le dimensioni pivot, puoi ordinare i risultati della query specificando il nome della misura, la direzione di ordinamento e il numero di indice basato su 0 della colonna di destinazione nella tabella dei dati. Ad esempio, il seguente elemento ordina in base alla prima colonna pivot utilizzando l'indice 0:

- name: orders_by_category
  sorts: [orders.count desc 0]

Per ordinare in base al totale della riga, specifica l'indice della colonna dei totali. Ad esempio, il seguente elemento ordina in base al totale della riga utilizzando l'indice 2, che rappresenta la colonna dei totali per una query con due colonne pivot:

- name: orders_by_cohort
  sorts: [users.count desc 2]

limit

Il parametro limit definisce il limite di righe da utilizzare per la query dell'elemento. Il limite si applica al numero di righe prima dell'applicazione di eventuali pivot.

- name: orders_by_date
  limit: 100

filters

Questa sezione si riferisce al parametro filters, che fa parte di un elemento della dashboard.

filters può essere utilizzato anche nell'ambito di una dashboard, come descritto nella pagina della documentazione dedicata ai parametri della dashboard.

filters può essere utilizzato anche nell'ambito di una misura, come descritto nella pagina della documentazione dedicata al parametro filters.

Il parametro filters definisce i filtri non modificabili da utilizzare per la query dell'elemento. Se vuoi che i filtri possano essere modificati da un utente nella dashboard, devi configurarli utilizzando filters per le dashboard, quindi applicarli agli elementi utilizzando listen.

La sintassi di filters è:

- name: element_name
  filters:
    orders.created_date: 2020/01/10 for 3 days
    orders.status: Shipped
    # You can create multiple filter statements

Ogni filtro può accettare un'espressione di filtro di Looker o una costante di valore. Puoi anche utilizzare le variabili Liquid _localization o _user_attributes nell'espressione di filtro per valori di filtro flessibili.

listen

I filtri della dashboard consentono ai visualizzatori di perfezionare in modo interattivo i dati visualizzati negli elementi della dashboard. Definisci i filtri della dashboard con il parametro filters per le dashboard LookML. Poi, utilizza il parametro listen per collegare gli elementi della dashboard al filtro della dashboard.

La sintassi di listen è la seguente:

- name: element_name
  listen:
    filter_name_goes_here: dimension or measure on which to apply
                           the filter using view_name.field_name syntax
    # You can add more than one listen statement

Aggiungi il parametro listen a un elemento, quindi fornisci il nome del filtro seguito da due punti e un riferimento al campo a cui applicare il filtro, utilizzando la sintassi view_name.field_name. Ad esempio, potresti creare un filtro denominato Data che richiede a un utente di inserire una data nel campo del filtro nell'interfaccia utente. Puoi quindi applicare il valore inserito dall'utente all'elemento orders_by_date in questo modo:

- dashboard: sales_overview
  ...

  filters:
  - name: date
    type: date_filter

  elements:
 - name: orders_by_date
    listen:
      date: order.order_date
    ...

Se il filtro ascoltato è configurato con il parametro vis_filter: true, il controllo del filtro viene visualizzato in una barra dei filtri direttamente nella parte superiore del riquadro di visualizzazione, anziché nella barra dei filtri della dashboard in alto.

Per altri esempi di utilizzo dei parametri filters e listen per applicare i filtri della dashboard ai singoli elementi della dashboard, consulta Creazione di dashboard LookML.

query_timezone

Il parametro query_timezone specifica il fuso orario in cui verrà eseguita la query. Le opzioni relative ai fusi orari sono mostrate nella pagina della documentazione Valori per timezone. Se vuoi che la query venga eseguita utilizzando il fuso orario del visualizzatore, puoi assegnare il valore user_timezone.

- name: orders_by_date
  query_timezone: America/Los Angeles

- name: orders_by_customer
  query_timezone: user_timezone

hidden_fields

Il parametro hidden_fields indica quali campi, se presenti, vengono utilizzati nella query, ma nascosti nel grafico. I campi nascosti verranno visualizzati nella sezione della tabella dati di un'esplorazione.

hidden_fields: [inventory_items.count, distribution_centers.id]

Parametri delle serie

color_application

Il parametro color_application e i relativi sottoparametri collection_id e palette_id possono essere utilizzati per applicare una raccolta di colori e una tavolozza specifiche a un elemento della dashboard. Per una panoramica delle raccolte di colori native di Looker, consulta la pagina della documentazione Raccolte di colori.

Se hai l'ID raccolta e l'ID tavolozza della tavolozza che vuoi utilizzare, puoi inserire questi ID nei sottoparametri collection_id e palette_id. Un ID collezione o un ID tavolozza può essere un codice alfanumerico o basarsi sul nome della collezione di colori. I codici alfanumerici vengono utilizzati per le raccolte native di Looker. Sono specifici per l'istanza e hanno il seguente aspetto:

color_application:
  collection_id: 1297dk12-86a7-4xe0-8dfc-82de20b3806a
  palette_id: 93c8aeb7-3f8a-4ca7-6fee-88c3617516a1

Le raccolte di colori personalizzate utilizzano ID raccolta e tavolozza basati sul nome della raccolta di colori, che sono trasferibili tra le istanze e hanno il seguente aspetto:

color_application:
  collection_id: blue-tone-collection
  palette_id: blue-tone-collection-categorical-0

Puoi anche utilizzare la UI per trovare i colori, le raccolte o le tavolozze che preferisci e generare il codice LookML per aggiungerli alla tua dashboard. Vai a un contenuto definito dall'utente (ad esempio un look, una dashboard o un'esplorazione) e applica i colori, la raccolta o la tavolozza che preferisci alla visualizzazione di quel contenuto utilizzando l'interfaccia utente. A questo punto, puoi seguire i passaggi per ottenere il LookML della dashboard, copiare il LookML generato e incollarlo nella sezione color_application.

Per impostazione predefinita, il primo colore della tavolozza designata viene applicato all'intero elemento box plot. Il sottoparametro facoltativo reverse imposta l'applicazione sull'ultimo colore della tavolozza.

color_application:
  collection_id: blue-tone-collection
  palette_id: blue-tone-collection-categorical-0
  options:
    reverse: true

Parametri di stile

show_view_names

Il parametro show_view_names determina se i nomi delle visualizzazioni vengono mostrati nelle etichette dei grafici, ad esempio i nomi degli assi e delle colonne.

show_view_names: true | false

## default value: true

Parametri dell'asse X

show_x_axis_label

Questo parametro determina se l'etichetta dell'asse X viene visualizzata.

show_x_axis_label: true | false

## default value: true

x_axis_label

Questo parametro specifica un'etichetta per l'asse X. Puoi utilizzare questo parametro quando show_x_axis_label è impostato su true.

x_axis_label: Order Date

show_x_axis_ticks

Questo parametro determina se le etichette dei valori vengono visualizzate sull'asse X.

show_x_axis_ticks: true | false

## default value: true

x_axis_gridlines

Questo parametro determina se le linee della griglia vengono estese dall'asse X.

x_axis_gridlines: true | false

## default value: false

x_axis_reversed

Questo parametro imposta la direzione dell'asse X. Quando x_axis_reversed è impostato su false, i valori aumentano da sinistra a destra. Se è impostata su true, i valori diminuiscono da sinistra a destra.

x_axis_reversed: true | false

x_axis_zoom

Questo parametro specifica se gli utenti possono aumentare lo zoom sull'asse X della visualizzazione. Quando x_axis_zoom è impostato su true, lo zoom è disponibile. Quando x_axis_zoom è impostato su false, lo zoom non è disponibile.

Se x_axis_zoom è impostato su false, y_axis_zoom è disattivato.

x_axis_zoom: true | false

# default value: true

Parametri dell'asse Y

show_y_axis_labels

Questo parametro determina se le etichette vengono visualizzate sull'asse Y.

show_y_axis_labels: true | false

## default value: true

y_axis_labels

Questo parametro specifica un'etichetta per l'asse Y. Puoi utilizzare questo parametro quando show_y_axis_labels è impostato su true.

y_axis_labels: ['label']

show_y_axis_ticks

Questo parametro determina se i valori vengono visualizzati sull'asse Y.

show_y_axis_ticks: true | false

## default value: true

y_axis_gridlines

Questo parametro determina se le linee della griglia vengono estese dall'asse Y.

y_axis_gridlines: true | false

## default value: true

y_axis_min

Questo parametro definisce il valore minimo per l'asse Y.

y_axis_min: ['10']

## default value: true

y_axis_max

Questo parametro definisce il valore massimo per l'asse Y.

y_axis_max: ['100']

## default value: true

y_axis_tick_density

Questo parametro attiva l'opzione per impostare una densità dei segni di graduazione dell'asse Y. Imposta y_axis_tick_density su custom per attivare questa funzionalità, quindi utilizza il parametro y_axis_tick_density_custom per impostare la densità.

y_axis_tick_density: default | custom

## default value: default

y_axis_tick_density_custom

Questo parametro consente di impostare la densità dei segni di graduazione dell'asse Y, se y_axis_tick_density è impostato su custom. Accetta un numero intero che rappresenta il numero di segni di graduazione che vuoi visualizzare.

y_axis_tick_density_custom: 10

## default value: 5

y_axis_reversed

Questo parametro imposta la direzione dell'asse Y. Quando y_axis_reversed è impostato su false, i valori aumentano lungo l'asse. Se è impostato su true, i valori diminuiscono lungo l'asse.

## y_axis_reversed: true | false

# default value: false

y_axis_value_format

Questo parametro specifica il formato numerico dei valori dell'asse Y, indipendentemente dalla dimensione o dalla misura sottostante. Il parametro accetta la formattazione in stile Excel. Se non viene specificata alcuna formattazione, il valore verrà visualizzato nel formato della dimensione o della misura sottostante.

Il valore specificato per il parametro y_axis_value_format deve essere racchiuso tra virgolette doppie:

y_axis_value_format: "*00#.00"

Puoi leggere la guida completa di Excel su come specificare questi formati nella relativa documentazione. Tuttavia, al momento la formattazione della data e del colore non è supportata in Looker.

Di seguito sono riportate alcune delle opzioni di formattazione più comuni:

Formato valore	Significato
#	Numero intero (123)
*00#	Numero intero con zero iniziale fino a 3 cifre (001)
0.##	Numero con un massimo di 2 decimali (1. o 1.2 o 1.23)
0.00	Numero con esattamente due decimali (1,23)
*00#.00	Numero con spaziatura interna di zeri fino a 3 posizioni ed esattamente 2 decimali (01.23)
#,###	Numero con virgola tra le migliaia (1,234)
#,##0.00	Numero con virgola tra le migliaia e due decimali (1,234.00)
0.000,," M"	Numero in milioni con tre decimali (1,234 Mln). La divisione per 1 milione avviene automaticamente.
$#	Dollari con 0 decimali ($123)
$0.00	Dollari con due decimali (123,00 $)
$#,##0.00	Dollari con virgola tra le migliaia e 2 decimali ($1,234.00)
#%	Percentuale con 0 decimali (1%). La moltiplicazione per 100 avviene automaticamente.
0.00%	Percentuale con due decimali (1,00%). La moltiplicazione per 100 avviene automaticamente.
0.00\%	Percentuale con due decimali (1,00%). La moltiplicazione per 100 NON avviene automaticamente.

y_axis_zoom

Questo parametro specifica se gli utenti possono aumentare lo zoom sull'asse Y della visualizzazione. Quando y_axis_zoom è impostato su true, lo zoom è disponibile.

Quando y_axis_zoom è impostato su false, gli utenti non possono aumentare lo zoom su porzioni più piccole dell'asse Y. Tuttavia, gli utenti potrebbero comunque essere in grado di aumentare lo zoom su porzioni più piccole dell'asse X se il parametro x_axis_zoom è impostato su true.

Se x_axis_zoom è impostato su false, y_axis_zoom è disattivato.

y_axis_zoom: true | false

# default value: true

Configurazione avanzata della visualizzazione

I parametri descritti in questa sezione corrispondono agli override facoltativi della configurazione del grafico, che puoi applicare a un grafico facendo clic sul pulsante Modifica configurazione grafico nella sezione Traccia dell'editor di visualizzazione.

advanced_vis_config

Questo parametro accetta uno snippet JSON HighCharts che sostituisce diverse impostazioni di visualizzazione e apre nuove funzionalità. Consulta la pagina della documentazione Personalizzazione delle visualizzazioni utilizzando l'editor di configurazione dei grafici per esempi di utilizzo del JSON di HighCharts per ottenere casi d'uso comuni.

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

# This example changes the color to orange for any series value that is greater than or equal to 50.

# default value: null