Sfruttare al meglio il ricettario delle visualizzazioni di Looker: personalizzazione delle descrizioni comando

Nota: questa pagina fa parte del Ricettario di Looker: ottenere il massimo dalle visualizzazioni di Looker.

Suggerimento: a partire da Looker 26.4, l'impostazione Tooltip personalizzati consente di configurare i tooltip all'interno dell'editor di visualizzazione di Explore utilizzando una combinazione di impostazioni dell'interfaccia utente e un editor HTML che supporta i modelli Liquid. Scopri di più sulle descrizioni comando personalizzate.

Il tooltip 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, un tooltip per una visualizzazione mappa basata su Margine lordo totale raggruppato per Stato mostrerà i valori per entrambi i campi quando un utente passa il mouse sopra lo stato della California.

Tuttavia, cosa succede se vuoi includere nel tooltip 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 il tooltip in modo che mostri i valori di più campi specificati, inclusi i campi che non sono presenti nella query di Esplora.

Attenzione: la formattazione HTML viene visualizzata solo nelle visualizzazioni dei grafici tabella, tabella (legacy), KPI (valore singolo) e valore singolo (legacy) e nei tooltip di visualizzazione quando vengono combinati più campi. I contenuti interattivi inseriti nel tooltip di un grafico a mappa con il parametro html non saranno accessibili nelle dashboard che utilizzano la nuova esperienza delle dashboard, anche se saranno accessibili nei Look e nelle esplorazioni.

Ingredienti

• Variabili Liquid: le variabili Liquid mostrano i valori di altri campi insieme alla query di esplorazione esistente.
• Parametro html: i campi definiti nel parametro html di una misura verranno visualizzati nel tooltip quando un utente passa il mouse sopra una visualizzazione.
• Visualizzazione: la descrizione comando viene visualizzata quando un utente passa il cursore su un punto dati in determinati tipi di visualizzazione.
  • Grafici cartesiani
  • Grafici a torta o ad anello
  • Grafici a progressione
  • Grafici a mappa

Prerequisiti

Per personalizzare la descrizione comando, devi:

• Autorizzazioni per creare esplorazioni e autorizzazioni per sviluppare LookML.
• Conoscenza dello sviluppo di SQL e LookML.
• Conoscenza di base dell'utilizzo di Liquid in Looker e della programmazione HTML. Per informazioni di base necessarie, consulta la sezione Utilizzo delle variabili Liquid nel parametro html della pagina della documentazione di html.
• Autorizzazioni per salvare i contenuti (se vuoi salvare la visualizzazione come Look o dashboard)

Considerazioni per la personalizzazione dei tooltip

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 essere il valore nel parametro sql della misura.
• Quando utilizzi una misura formattata (una misura di type: percent_of_total o una misura con un parametro value_format_name o value_format), assicurati di utilizzare la sintassi Liquid per il valore visualizzato {{ field_name._rendered_value }} (dove field_name è il nome effettivo della misura o della dimensione).

Esempio

Nota: l'esempio in questa sezione estrapola l'esempio di mappa Margine lordo totale raggruppato per Stato introdotto in precedenza in questa pagina.

Per impostazione predefinita, il tooltip per i punti dati della visualizzazione includerà i valori di Margine lordo totale e Stato. Tuttavia, cosa succede se vuoi fornire agli utenti informazioni aggiuntive che non sono indicate sulla mappa o incluse nella query di Esplora? E se volessi includere il valore di un campo denominato Percent of Total Gross Margin (Percentuale del margine lordo totale) anziché State (Stato)? L'inclusione della Percentuale del margine lordo totale aiuterà gli utenti a capire come il valore del Margine lordo totale per un singolo punto dati si confronta 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 ;;
}

1. In modalità di sviluppo, vai alla definizione di LookML per il campo che vuoi personalizzare.

   Puoi accedere direttamente alla definizione LookML di un campo da un'esplorazione.

2. Determina i campi e i valori che vuoi includere nel tooltip oltre al campo originale. Ad esempio, Percentuale del margine lordo totale.

3. Aggiungi un parametro html alla misura originale a cui viene fatto riferimento nella query di Esplora e visualizzata nel tooltip. In questo caso, la misura attualmente presente nella query di Esplora e visualizzata nel tooltip è Margine lordo totale.

4. Nel parametro html, crea un'espressione con variabili Liquid che aggiunge i campi aggiuntivi al valore della misura esistente.

   • Questo esempio utilizza la variabile Liquid _rendered_value per visualizzare i valori formattati di Looker. Ad esempio, total_gross_margin utilizza la formattazione di Looker per due decimali e percent_of_total_gross_margin utilizza la formattazione di Looker per la percentuale con due decimali.
   • Puoi utilizzare una barra verticale,|, per separare i valori dei diversi campi.
   • Puoi anche aggiungere altre parole che potrebbero chiarire il significato degli altri valori visualizzati nel tooltip. In questo caso, viene aggiunto of total per chiarire il significato del valore percentuale.

5. Salva, convalida ed esegui il push del codice in produzione dopo aver verificato che funzioni come previsto.

Nota: l'input del parametro html influisce solo sul modo in cui il valore viene visualizzato dagli utenti. Il valore sottostante nel database non viene modificato.

Ora, quando un utente passa il mouse sopra un punto dati con il tooltip, quest'ultimo mostra due valori: 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:

• Salva l'esplorazione come Look
• Aggiungi l'esplorazione a una dashboard
• Condividi l'esplorazione con un URL