Descrizioni comando personalizzate

Questo prodotto o funzionalità sono soggetti ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Puoi personalizzare le descrizioni comando che vengono visualizzate quando gli utenti passano il mouse sopra gli elementi nelle visualizzazioni di Looker. Le descrizioni comando personalizzate ti consentono di fornire più contesto, visualizzare metriche aggiuntive e personalizzare le informazioni presentate agli utenti. La funzionalità di Labs Descrizioni comando personalizzate ti consente di configurare le descrizioni comando nell'editor di visualizzazione Esplora utilizzando una combinazione di impostazioni dell'interfaccia utente e un editor HTML che supporta i modelli Liquid.

Questa pagina fornisce indicazioni per attivare e utilizzare la funzionalità di Labs Descrizioni comando personalizzate nell'istanza di Looker (original). Questa pagina include le seguenti sezioni:

• Fornire feedback o ricevere assistenza
• Requisiti utente e istanza
• Limitazioni
• Attivare le descrizioni comando personalizzate
• Come utilizzare le descrizioni comando personalizzate
• Esempi
• Risorse correlate

Fornire feedback o ricevere assistenza

Puoi fornire feedback o richiedere assistenza compilando e inviando questo modulo Problemi di anteprima delle descrizioni comando personalizzate di Looker.

Requisiti utente e istanza

Per attivare e utilizzare la funzionalità di Labs Descrizioni comando personalizzate, devi soddisfare i seguenti requisiti:

• L'istanza di Looker (original) deve eseguire Looker 26.0 o versioni successive ed essere ospitata da Looker.
• Per attivare la funzionalità di Labs Descrizioni comando personalizzate, devi disporre del ruolo Amministratore.
• Per creare descrizioni comando personalizzate in Esplora, devi disporre dell'autorizzazione explore e dell'accesso al modello LookML sottostante.

Limitazioni

La funzionalità di Labs Descrizioni comando personalizzate presenta le seguenti limitazioni:

• Le descrizioni comando personalizzate sono supportate solo per i grafici a tabella, i grafici a valore singolo e i grafici cartesiani. Le descrizioni comando personalizzate non sono supportate per i grafici a torta, a scatola e baffi o a cascata.
• Le descrizioni comando personalizzate possono fare riferimento solo ai campi inclusi in una query Esplora.
• Le descrizioni comando possono visualizzare solo la stessa granularità dei dati di un determinato campo. Se gli utenti vogliono visualizzare un livello di granularità dei dati più dettagliato di quello disponibile nella descrizione comando, devono utilizzare la funzionalità di visualizzazione in dettaglio.
• Le descrizioni comando personalizzate vengono salvate a livello di visualizzazione. Non possono essere salvate a livello di Esplora.
• Se rimuovi un campo da una query Esplora con una descrizione comando personalizzata, un utente può comunque visualizzare la descrizione comando se la query Esplora è condivisa con lui e aggiunge di nuovo il campo alla query Esplora.
• Il codice HTML visualizzato nelle descrizioni comando personalizzate è soggetto alle regole di sanificazione HTML di Looker.
• Non tutte le variabili Liquid potrebbero essere supportate per le descrizioni comando personalizzate.
• Le personalizzazioni delle descrizioni comando sostituiranno qualsiasi tema applicato a una dashboard interna (non incorporata) o a una dashboard incorporata.

Attivare le descrizioni comando personalizzate

La funzionalità di Labs Descrizioni comando personalizzateè attiva per impostazione predefinita.

Se la funzionalità di Labs Descrizioni comando personalizzate è stata disattivata in precedenza, gli amministratori di Looker possono attivarla seguendo questi passaggi:

1. In Looker, fai clic sull'opzione Amministrazione nel menu di navigazione principale.
2. Fai clic sull'opzione Labs nella sezione Generale per aprire la pagina Labs.
3. Seleziona il pulsante di attivazione/disattivazione Descrizioni comando personalizzate per attivare la funzionalità di Labs.

Come utilizzare le descrizioni comando personalizzate

Se disponi delle autorizzazioni appropriate, puoi personalizzare la descrizione comando per una serie nella visualizzazione Esplora. Per personalizzare la descrizione comando, segui questi passaggi:

1. Apri o crea una query Esplora e seleziona un tipo di visualizzazione supportato.
2. Fai clic su Modifica nella scheda Visualizzazione di Esplora per aprire l'editor di visualizzazione.
3. Seleziona la scheda Serie.
4. Nella sezione Personalizzazioni, individua la serie a cui vuoi aggiungere la descrizione comando. Se sono presenti più serie, espandi quella a cui vuoi aggiungere una descrizione comando.
5. Seleziona il pulsante Descrizione comando personalizzata per attivare la funzionalità di descrizione comando personalizzata per quella serie specifica.
6. Nella sezione Descrizione comando personalizzata, puoi modificare l'aspetto di base della descrizione comando utilizzando le opzioni fornite:
   • Dimensioni carattere: imposta le dimensioni del carattere della descrizione comando.
   • Famiglia di caratteri: imposta la famiglia di caratteri della descrizione comando.
   • Colore sfondo descrizione comando: imposta il colore di sfondo della descrizione comando.
   • Colore carattere: imposta il colore del carattere della descrizione comando.
   • Raggio bordo: imposta l'arrotondamento dei bordi della descrizione comando. Più alto è il numero, più arrotondati sono i bordi della descrizione comando.
   • Ombra bordo: imposta l'ombra della descrizione comando.
   • Allineamento testo: imposta l'allineamento del carattere della descrizione comando.
7. In aggiunta o in alternativa alle opzioni precedenti, puoi applicare opzioni di stile più avanzate facendo clic su Modifica contenuti descrizione comando per aprire l'editor HTML Modifica contenuti descrizione comando.

8. Nell'editor Modifica contenuti descrizione comando, puoi utilizzare le variabili HTML e Liquid per strutturare e popolare la descrizione comando.

   • Utilizza i tag HTML standard per formattare i contenuti della descrizione comando (ad esempio, <div>, <span>, <strong>, <table>,<ul>, <ol>). Tieni presente che il codice HTML visualizzato è soggetto alle regole di sanificazione HTML di Looker.
   • Non tutte le variabili Liquid potrebbero essere supportate per le descrizioni comando personalizzate.

9. Mentre modifichi i contenuti della descrizione comando personalizzata, puoi visualizzarne l'anteprima facendo clic su Anteprima (o utilizzando le scorciatoie da tastiera Comando-Invio per Mac o Ctrl+Invio per PC) e passando il mouse sopra i punti dati nel riquadro di anteprima della visualizzazione.

10. Fai clic su Salva nell'editor HTML, quindi salva l'Esplora come Look o come riquadro della dashboard per rendere permanenti le modifiche.

Esempi

I seguenti esempi mostrano casi d'uso per diversi livelli di personalizzazione delle descrizioni comando:

• Descrizione comando personalizzata con più valori di misura
• Descrizione comando personalizzata con valori nascosti strutturati come tabella
• Descrizione comando personalizzata con funzioni Liquid comuni

Descrizione comando personalizzata con più valori di misura

Le descrizioni comando personalizzate possono essere utili nei casi in cui vuoi fornire agli utenti maggiori informazioni su un punto dati visualizzato in una visualizzazione. Ad esempio, un grafico a valore singolo mostra il valore di una sola misura. Con una descrizione comando personalizzata, puoi visualizzare più dati e fornire agli utenti maggiori informazioni sui dati nel grafico.

In questo esempio, un grafico a valore singolo intitolato "Conteggio degli ordini nel 2025" mostra il valore di Conteggio ordini per il Paese degli utenti "Stati Uniti" e si basa su una query Esplora che include anche Conteggio articoli ordinati. Tuttavia, il valore di Conteggio articoli ordinati non viene visualizzato nel grafico.

Il seguente codice HTML viene inserito nell'editor Modifica contenuti descrizione comando per la serie Conteggio ordini e imposta i contenuti in modo da includere il valore Conteggio articoli ordinati nella descrizione comando:

<div style="padding: 5px; font-family: Arial, sans-serif; font-size: 13px;">
  <div>
    <strong>Order Items Count:</strong> {{ order_items.count }}
  </div>
  <div>
    <strong>Orders Count:</strong> {{ orders.count }}
  </div>
</div>

Gli utenti possono visualizzare i valori di entrambi i campi, Conteggio ordini e Conteggio articoli ordinati, e avere maggiori informazioni sui dati visualizzati nel grafico.

Descrizione comando personalizzata con valori nascosti strutturati come tabella

Come indicato nelle informazioni sulle limitazioni in questa pagina, le descrizioni comando personalizzate possono fare riferimento solo ai campi inclusi in una query Esplora. Tuttavia, potresti non voler visualizzare tutti i campi Esplora in un grafico. Con una descrizione comando personalizzata, puoi visualizzare i dati dei campi che sono nascosti dalle visualizzazioni per gli utenti, senza aggiungerli a un grafico.

In questo esempio, una tabella di dati Esplora include le misure Conteggio ordini e Conteggio articoli ordinati, raggruppate in base alle dimensioni Stato degli utenti e Stato degli ordini. Lo sviluppatore vuole visualizzare una piccola tabella per gli utenti e nasconde i campi Stato degli ordini e Conteggio articoli ordinati dal grafico a tabella. Tuttavia, lo sviluppatore vuole comunque che gli utenti vedano i valori Stato degli ordini e Conteggio articoli ordinati associati a un determinato Conteggio ordini.

Il seguente codice HTML viene inserito nell'editor Modifica contenuti descrizione comando per la serie Conteggio ordini e imposta i contenuti in modo da includere i valori di Stato degli ordini e Conteggio articoli ordinati nella descrizione comando, strutturati come tabella:

<div>
    <div>
        <table border="1">
          <!-- Table Body -->
          <tbody>
            <!-- Row 1 -->
            <tr>
              <td>
                <strong>Order status</strong>
              </td>
              <td>
                {{ orders.status }}
              </td>
            </tr>
            <!-- Row 2 -->
            <tr>
              <td>
                <strong>State</strong>
              </td>
              <td>
                {{ users.state }}
              </td>
            </tr>
            <!-- Row 3 -->
            <tr>
              <td>
                <strong>Count of orders</strong>
              </td>
              <td>
                {{ orders.count }}
              </td>
            </tr>
            <!-- Row 4 -->
            <tr>
              <td>
                <strong>Count of order items</strong>
              </td>
              <td>
                {{ order_items.count }}
              </td>
            </tr>
          </tbody>
        </table>
      </div>
  </div>

Gli utenti possono visualizzare tutti i dati della query Esplora, senza i campi aggiuntivi visualizzati nel grafico a tabella.

Descrizione comando personalizzata con funzioni Liquid comuni

Le descrizioni comando personalizzate supportano le funzioni Liquid comuni, come l'utilizzo di pipe e le istruzioni di downcast. In questo esempio, un grafico a colonne mostra Conteggio ordini raggruppato per Stato degli ordini. Lo sviluppatore vuole formattare la descrizione comando in modo che gli utenti possano identificare rapidamente la differenza tra il Conteggio ordini per uno Stato degli ordini "ANNULLATO" e uno Stato degli ordini "COMPLETATO".

Il seguente codice HTML e Liquid viene inserito nell'editor Modifica contenuti descrizione comando per la serie Conteggio ordini e imposta il valore della descrizione comando in modo che venga visualizzato in rosso per i conteggi degli ordini con stato "ANNULLATO" e in verde per gli ordini con stato "COMPLETATO". Il codice utilizza un'assegnazione di variabili e pipe per garantire l'accuratezza della stringa e applicare la formattazione condizionale specificata:

Nota: per garantire l'accuratezza delle istruzioni condizionali, applica le trasformazioni dei dati durante l'assegnazione delle variabili.

{% assign my_variable = orders.status | downcase | strip %}
{% if my_variable == "completed" %}
  <span style="color:green">{{orders.count}}</span>
{% else %}
  <span style="color:red">{{orders.count}}</span>
{% endif %}

Il valore Conteggio ordini per la colonna Stato degli ordini "COMPLETATO" visualizza il testo in verde nella descrizione comando.

Il valore Conteggio ordini per la colonna Stato degli ordini "ANNULLATO" visualizza il testo in rosso nella descrizione comando.

Gli utenti possono distinguere rapidamente tra gli ordini annullati e completati visualizzati nel grafico a colonne.

Risorse correlate

• Scopri di più sulla creazione di visualizzazioni.
• Consulta la pagina della documentazione di riferimento delle variabili Liquid per scoprire altri modi per utilizzare Liquid in Looker.
• Consulta la pagina della documentazione Sanificazione HTML per ulteriori informazioni sui tag HTML supportati da Looker.