Questa pagina descrive i parametri da utilizzare con gli elementi della dashboard LookML di type: single_value in un file dashboard.lkml.
Per informazioni sulla creazione di un grafico a valore singolo tramite l'interfaccia utente di Looker, consulta la pagina della documentazione Opzioni dei grafici KPI (valore singolo) o Opzioni dei grafici a valore singolo (legacy).
Parametri base
Quando definisci un elemento della dashboard LookML, devi specificare i valori almeno per i parametri name e type. Altri parametri di base come title, height e width influiscono sulla posizione e sull'aspetto di un elemento in una dashboard.
name
Questa sezione si riferisce al parametro
name, che fa parte di un elemento della dashboard.
namepuò 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.
titlepuò essere utilizzato anche nell'ambito di una dashboard, come descritto nella pagina della documentazione dedicata ai parametri della dashboard.
titlepuò 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.
typepuò essere utilizzato anche come parte di un filtro della dashboard, descritto nella pagina della documentazione dedicata ai parametri della dashboard.
typepuò essere utilizzato anche nell'ambito di un join, come spiegato nella pagina della documentazione dedicata al parametrotype(per i join).
typepuò essere utilizzato anche come parte di una dimensione, come descritto nella pagina della documentazione Tipi di dimensioni, filtri e parametri.
typepuò 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.
heightpuò 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.
widthpuò 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.
refreshpuò 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 e almeno un campo deve essere specificato utilizzando il parametro dimensions o il parametro measures. Puoi anche utilizzare gli altri parametri di ricerca 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.
explorepuò essere utilizzato anche nell'ambito di un modello, come spiegato nella pagina della documentazione dedicata al parametroexplore.
explorepuò 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.
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]
pivots
Il parametro pivots definisce le dimensioni che devono essere sottoposte a pivot per la query dell'elemento. Utilizza la sintassi view_name.dimension_name per specificare la dimensione. Non includere pivots se la query non ne ha.
## single pivot example
- name: orders_by_date
pivots: customer.gender
## multiple pivot example
- name: orders_by_date
pivots: [customer.gender, customer.age_tier]
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.
filterspuò essere utilizzato anche nell'ambito di una dashboard, come descritto nella pagina della documentazione dedicata ai parametri della dashboard.
filterspuò essere utilizzato anche nell'ambito di una misura, come descritto nella pagina della documentazione dedicata al parametrofilters.
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
merged_queries
Il parametro merged_queries ti consente di combinare i risultati di più query in un unico elemento della dashboard. Definisci ogni query di origine all'interno del parametro merged_queries dell'elemento e utilizza il sottoparametro join_fields per specificare come unire i risultati.
Il seguente codice LookML di esempio crea un elemento dei risultati uniti di type: looker_grid. In questo esempio, il parametro merged_queries viene utilizzato per creare un elemento della dashboard che combina i dati di due query separate in un unico grafico a tabella:
- name: merged_results_element
title: Merged Results Tile
type: looker_grid
merged_queries:
- model: ecommerce
explore: users
type: table
fields: [users.state, users.count, users.city]
sorts: [users.count desc 0]
limit: 5000
column_limit: 50
query_timezone: UTC
listen:
- State: users.state
- model: ecommerce
explore: users
type: table
fields: [users.state, users.city]
sorts: [users.state]
limit: 500
column_limit: 50
query_timezone: UTC
join_fields:
- field_name: users.state
source_field_name: users.state
- field_name: users.city
source_field_name: users.city
listen:
- State: users.state
In questo esempio, l'elemento della dashboard combina i dati di due query di origine basate sull'esplorazione users nel modello ecommerce. La query principale include i campi users.state, users.count e users.city e ordina i risultati in base al campo users.count. La seconda query di origine include i campi users.state e users.city e ordina i risultati in base al campo users.state.
Il parametro join_field unisce le query di origine in base ai valori corrispondenti nei campi users.state e users.city.
Il parametro listen applica un filtro State a entrambe le query, consentendo ai visualizzatori della dashboard di perfezionare i risultati delle query visualizzati nel riquadro della dashboard selezionando uno stato specifico.
Esempio: unione dei dati aziendali
Supponiamo che tu voglia creare una query unita che combini le informazioni sulle aziende di due diverse esplorazioni: company_info e companies. Vuoi unire le query sui campi ipo.stock_symbol, companies.name e companies.contact_email di ogni esplorazione per creare una query che restituisca i risultati per nome dell'azienda, email di contatto dell'azienda, anno dell'IPO, simbolo azionario, numero di dipendenti e numero di job. Puoi definire l'elemento della query unita in LookML nel seguente modo:
- name: merged_results_element
title: Merged Results Tile
merged_queries:
- model: market_research
explore: company_info
fields: [companies.name, companies.contact_email, ipo.public_year, ipo.stock_symbol]
filters:
companies.contact_email: "-NULL"
ipo.valuation_amount: NOT NULL
sorts: [ipo.public_year desc]
- model: company_data
explore: companies
fields: [companies.name, ipo.stock_symbol, companies.contact_email,
companies.number_of_employees, jobs.job_count]
filters:
companies.number_of_employees: NOT NULL
ipo.stock_symbol: "-NULL"
companies.contact_email: "-NULL"
sorts: [jobs.job_count desc]
join_fields:
- field_name: ipo.stock_symbol
source_field_name: ipo.stock_symbol
- field_name: companies.name
source_field_name: companies.name
- field_name: companies.contact_email
source_field_name: companies.contact_email
Applicazione di filtri agli elementi di query uniti
L'esempio precedente di un elemento di query unita mostra come applicare filtri hardcoded direttamente all'interno di ogni query di origine utilizzando il parametro filters. Ad esempio, i filtri companies.contact_email: "-NULL" e ipo.valuation_amount: NOT NULL nella query primaria limitano i risultati alle aziende che hanno email di contatto e valutazioni valide. Questi filtri a livello di query pre-filtrano i dati prima di unire le query e non possono essere modificati dall'utente.
Puoi anche applicare i filtri della dashboard agli elementi delle query unite utilizzando il parametro listen all'interno della definizione di ogni query di origine. Ad esempio, supponiamo che tu abbia un filtro della dashboard denominato Industry che hai definito a livello di dashboard utilizzando il parametro filters per le dashboard LookML:
filters:
- name: Industry
title: Industry
type: field_filter
ui_config:
type: dropdown_menu
display: inline
model: market_research
explore: company_info
field: companies.industry
Per applicare il filtro Industry al campo companies.industry in entrambe le query di origine, aggiungi il parametro listen a ciascuna delle definizioni delle query di origine della query unita come segue:
listen:
Industry: companies.industry
Ad esempio, il seguente codice campione aggiunge il filtro Industry a entrambe le query di origine nell'elemento dei risultati uniti dell'esempio precedente.
- name: merged_results_element
title: Merged Results Tile
merged_queries:
- model: market_research
explore: company_info
fields: [companies.name, companies.contact_email, ipo.public_year, ipo.stock_symbol]
filters:
companies.contact_email: "-NULL"
ipo.valuation_amount: NOT NULL
sorts: [ipo.public_year desc]
listen:
Industry: companies.industry
- model: company_data
explore: companies
fields: [companies.name, ipo.stock_symbol, companies.contact_email,
companies.number_of_employees, jobs.job_count]
filters:
companies.number_of_employees: NOT NULL
ipo.stock_symbol: "-NULL"
companies.contact_email: "-NULL"
sorts: [jobs.job_count desc]
join_fields:
- field_name: ipo.stock_symbol
source_field_name: ipo.stock_symbol
- field_name: companies.name
source_field_name: companies.name
- field_name: companies.contact_email
source_field_name: companies.contact_email
listen:
Industry: companies.industry
Con questa aggiunta, quando un utente interagisce con il filtro della dashboard Industry, la query di origine corrispondente nell'elemento della query unita verrà filtrata di conseguenza.
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 di stile
Questa sezione descrive i parametri che corrispondono alle opzioni nella sezione Stile dell'editor di visualizzazione per i grafici KPI (valore singolo) e valore singolo (legacy).
colors
Il parametro colors specifica un elenco di colori per le serie. Il primo colore nell'elenco corrisponde alla prima serie di dati. Se sono presenti più serie rispetto ai colori elencati, i colori verranno riutilizzati dall'inizio.
colors: [blue, orange, yellow, red, purple]
Per tutti gli attributi del grafico che specificano un colore, il valore del colore può essere una stringa esadecimale, ad esempio #2ca6cd, o una stringa di colore con nome CSS, ad esempio mediumblue.
custom_color_enabled
L'impostazione del parametro custom_color_enabled su true consente di specificare un colore personalizzato per una visualizzazione a valore singolo. Utilizza questo parametro con il parametro custom_color.
custom_color_enabled: true | false
custom_color
Specifica un colore personalizzato per il testo in una visualizzazione a valore singolo.
custom_color: #2ca6cd | mediumblue
show_single_value_title
Quando questo parametro è impostato su true, viene visualizzato un titolo sotto il valore della query. Puoi specificare o modificare il titolo utilizzando il parametro single_value_title.
show_single_value_title: true | false
single_value_title
Specifica un titolo da visualizzare con il valore della query. Il testo del titolo può essere localizzato.
single_value_title: Title
valueFormat
Specifica il formato numerico o della data per il valore. 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.
Parametri di confronto
Questa sezione descrive i parametri che corrispondono alle opzioni della sezione Confronto dell'editor di visualizzazione per i grafici KPI (valore singolo) e valore singolo (legacy).
show_comparison
Se impostato su true, il parametro show_comparison consente di aggiungere informazioni di confronto a un elemento della dashboard di type: single_value.
show_comparison: true | false
comparison_type
Utilizza il parametro comparison_type per specificare come viene utilizzato il campo di confronto in un elemento della dashboard di type: single_value.
Puoi specificare uno dei seguenti valori per il parametro comparison_type:
value: il valore del campo di confronto viene visualizzato nella parte inferiore della visualizzazione.change: il valore del campo di confronto viene visualizzato nella parte inferiore della visualizzazione. Se il valore è negativo, un triangolo punta verso il basso. Se il valore è positivo, il triangolo punta verso l'alto.progress: il valore del campo utilizzato per la visualizzazione di un singolo valore viene diviso per il valore del campo di confronto. Questa percentuale viene visualizzata come barra di avanzamento.progress_percentage: il valore del campo utilizzato per la visualizzazione del valore singolo viene diviso per il valore del campo di confronto. Questa percentuale viene visualizzata come barra di avanzamento. La barra è etichettata con la percentuale e il valore del campo di confronto.
comparison_type: value | change | progress | progress_percentage
show_comparison_label
Specifica se un'etichetta viene mostrata con il campo di confronto. Per impostazione predefinita, l'etichetta è il nome del campo di confronto.
show_comparison_label: true | false
comparison_label
Specifica l'etichetta da visualizzare con il campo di confronto. Il testo dell'etichetta di confronto può essere localizzato.
show_comparison_label: true
comparison_label: Label
comparison_reverse_colors
Se comparison_type è impostato su change, puoi impostare comparison_reverse_colors su true per visualizzare i numeri negativi in un campo di confronto come testo verde con un triangolo verde, mentre i numeri positivi vengono visualizzati come testo rosso con un triangolo rosso.
comparison_type: change
comparison_reverse_colors: true | false