La descrizione comando di visualizzazione mostra per impostazione predefinita il valore delle dimensioni e delle misure selezionate e può aiutare gli utenti a comprendere il significato di un singolo punto dati.
Ad esempio, una descrizione comando per una visualizzazione di mappa basata sul Margine lordo totale raggruppato per Stato mostrerà i valori di entrambi i campi quando un utente passa il mouse sopra lo stato della California.
Tuttavia, cosa succede se nella descrizione comando vuoi includere campi diversi da quelli predefiniti in modo che gli utenti possano ottenere maggiori informazioni o contesto su un punto dati senza dover cercare altrove?
Puoi personalizzare la descrizione comando in modo da visualizzare i valori di più campi specificati, inclusi quelli non presenti nella query Esplora.
Ingredienti
- Variabili Liquid: le variabili Liquid visualizzano i valori di altri campi in combinazione con la query Esplora esistente.
- Parametro
html
: i campi definiti nel parametrohtml
di una misura vengono visualizzati nella descrizione comando quando un utente passa il mouse sopra una visualizzazione. - Visualizzazione: in alcuni tipi di visualizzazione, la descrizione comando viene mostrata quando un utente passa il cursore del mouse sopra un punto dati.
Prerequisiti
Per personalizzare la descrizione comando devi:
- Autorizzazioni per creare esplorazioni e sviluppare LookML.
- Conoscenza dello sviluppo di SQL e LookML.
- Conoscenza di base dell'utilizzo di Liquid in Looker e della programmazione HTML. Per le informazioni di base necessarie, consulta la sezione Utilizzo delle variabili Liquid nel parametro
html
della pagina della documentazione dihtml
. - Autorizzazioni per salvare contenuti (se vuoi salvare la visualizzazione come Look o dashboard)
Considerazioni sulla personalizzazione delle descrizioni comando
Quando personalizzi una descrizione comando, è importante considerare quanto segue:
- I valori nel parametro
html
diventano l'asse y di una visualizzazione. - Il valore che vuoi visualizzare sull'asse y deve corrispondere al valore nel parametro
sql
della misura. - Quando utilizzi una misura formattata (una misura di
type: percent_of_total
o con un parametrovalue_format_name
ovalue_format
), assicurati di utilizzare la sintassi Liquid per il valore visualizzato{{ field_name._rendered_value }}
(dovefield_name
è il nome effettivo della misura o della dimensione).
Esempio
Per impostazione predefinita, la descrizione comando per i punti dati di visualizzazione includerà i valori per Margine lordo totale e Stato. Tuttavia, e se volessi fornire agli utenti informazioni aggiuntive non indicate sulla mappa o incluse nella query Esplora? E se volessi includere il valore per un campo denominato Percentuale del margine lordo totale anziché per Stato? L'inclusione della Percentuale del margine lordo totale aiuterà gli utenti a comprendere come il valore del Margine lordo totale per un singolo punto dati viene confrontato con il margine lordo totale nel set di dati.
Per personalizzare la descrizione comando:
measure: total_gross_margin {
type: sum
value_format_name: decimal_2
sql: ${gross_margin} ;;
html: {{ rendered_value }} | {{percent_of_gross_margin._rendered_value }} of total ;;
}
In Modalità di sviluppo, vai alla definizione di LookML del campo che vuoi personalizzare.
Puoi accedere direttamente alla definizione LookML di un campo da un'esplorazione.
Determina i campi e i valori da includere nella descrizione comando oltre al campo originale. ad esempio Percentuale del margine lordo totale.
Aggiungi un parametro
html
alla misura originale a cui viene fatto riferimento nella query Esplora e che viene visualizzato nella descrizione comando. In questo caso, la misura attualmente presente nella query Esplora e visualizzata nella descrizione comando è Margine lordo totale.Nel parametro
html
, crea un'espressione con variabili Liquid che aggiunga campi aggiuntivi al valore della misura esistente.- In questo esempio viene utilizzata la variabile Liquid
_rendered_value
per visualizzare i valori formattati di Looker. Ad esempio,total_gross_margin
usa la formattazione Looker per due decimali epercent_of_total_gross_margin
usa la formattazione Looker per le percentuali con due decimali. - Puoi utilizzare una barra verticale,
|
, per separare i valori per campi diversi. - Puoi anche aggiungere altre parole che potrebbero chiarire il significato degli altri valori visualizzati nella descrizione comando. In questo caso, viene aggiunto
of total
per chiarire il significato del valore percentuale.
- In questo esempio viene utilizzata la variabile Liquid
Salva, convalida ed esegui il push del codice in produzione dopo aver verificato che funzioni come previsto.
La descrizione comando ora mostrerà due valori quando un utente passa il mouse sopra un punto dati con la descrizione comando: il valore total_gross_margin
del punto dati e il valore percent_of_total_gross_margin
corrispondente.
Passaggi successivi
Dopo aver creato la visualizzazione con una descrizione comando personalizzata, puoi condividerla con altri utenti:
- Salvare l'esplorazione come Look
- Aggiungere l'esplorazione a una dashboard
- Condividere l'esplorazione con un URL