Modi interessanti per utilizzare Liquid nelle etichette

Questa pagina evidenzia modi utili per utilizzare il campo parameter di Looker con alcuni dei label parametri secondari che accettano variabili Liquid.

Gli esempi in questa pagina richiedono una conoscenza di Liquid. Per informazioni sull'utilizzo di Liquid in Looker, visita la pagina della documentazione Riferimento alle variabili Liquid.

Utilizzo di view_label per i nomi delle visualizzazioni dinamiche

Il parametro view_label di Looker viene utilizzato per raggruppare le dimensioni in base a un nome più contestuale e intuitivo nel selettore campi Esplora. Per saperne di più sulle etichette delle visualizzazioni, visita la pagina della documentazione view_label (per i campi).

L'assegnazione dello stesso view_label alle dimensioni semplifica le esplorazioni per gli utenti. Gruppi di campi chiari e descrittivi consentono agli utenti di trovare i dati di cui hanno bisogno.

Esempio: scrivere codice DRY (non ripetere) con un view_label Liquid

Ad esempio, supponiamo di avere campi organizzati nella sezione view_label Finanza e contabilità in un'esplorazione chiamata Articoli di inventario:

dimension: cost {
  view_label: "Finance & Accounting"
  type: number
  sql: ${TABLE}.COST ;;
}

dimension: cost_ex_vat { view_label: "Finance & Accounting" type: number sql: ${TABLE}.COST_EX_VAT ;; }

dimension: cost_eur { view_label: "Finance & Accounting" type: number sql: ${TABLE}.COST_EUR ;; }

Cosa succederebbe se volessi cambiare view_label Finanza e contabilità in The Money Zone per gli utenti? L'utilizzo di Liquid può evitare la riscrittura ripetitiva del codice.

Puoi creare un tipo di pseudo-variabile del nome della visualizzazione che preferisci utilizzando il campo parameter di Looker. Una volta modificato il nome della visualizzazione in parameter, tutti i campi verranno aggiornati.

parameter: view_label {
  type: string
  default_value: "The Money Zone"
}

dimension: cost { view_label: "{% parameter view_label %}" type: number sql: ${TABLE}.COST ;; }

dimension: cost_ex_vat { view_label: "{% parameter view_label %}" type: number sql: ${TABLE}.COST_EX_VAT ;; }

dimension: cost_eur { view_label: "{% parameter view_label %}" type: number sql: ${TABLE}.COST_EUR ;; }

Il selettore dei campi Esplora elementi di inventario che mostra Costo, Costo euro e Costo al netto dell'IVA organizzati nell'etichetta della visualizzazione "La zona dei soldi".

Nota:se non vuoi che le virgolette vengano visualizzate nel menu, parameter deve essere impostato come type:unquoted e default_value deve essere una stringa senza spazi, ad esempio The_Money_Zone. Se il parametro è type:string, verranno visualizzate le virgolette.

Etichette dei campi dinamici

Potresti avere più gruppi di utenti che potrebbero interpretare il nome di un campo in modo diverso. Ad esempio, alcuni utenti potrebbero fare riferimento a un margine lordo come margine operativo, mentre altri potrebbero fare riferimento a un margine lordo come margine standard, a seconda del caso d'uso.

Il nome di un campo può apparire diverso per utenti diversi a seconda di come combini gli attributi utente e le variabili Liquid.

Esempio: etichette diverse per attributi utente diversi

Estrapolando dall'esempio precedente, puoi tenere conto delle differenze nella logica di business facendo in modo che il campo Margine lordo venga visualizzato come Margine standard per alcuni utenti e Margine operativo per altri. Il seguente codice LookML utilizza gli attributi utente e le variabili Liquid.

dimension: gross_margin {
  label: "{% if _user_attributes['customer'] == 'A' %} Standard Margin
    {% elsif _user_attributes['customer'] == 'B' %} Operating Margin
    {% else %} Gross Margin
    {% endif %}"
  type: number
  value_format_name: usd
  sql: ${sale_price} - ${inventory_items.cost} ;;
}

In base a LookML, il campo Margine lordo viene visualizzato come Margine operativo in un selettore di campi Esplora per Utente A.

In base a LookML, il campo Margine lordo viene visualizzato come Margine standard in un selettore di campi Esplora per l'utente B.

Questo pattern può essere utilizzato anche per creare una localizzazione di basso livello utente per utente, come mostrato nell'esempio successivo.

Esempio: nomi dei campi personalizzati per più esplorazioni

Questo esempio combina le tecniche degli esempi precedenti per creare un'esplorazione con etichette dei campi che variano a seconda della regione di un utente.

In questo esempio, ci sono due team regionali, Finance East e Finance West, che utilizzano un'esplorazione chiamata Company Sales. Entrambe le squadre devono utilizzare le misure Utile totale e Entrate totali nelle query:

measure: total_profit {
  label: "{{ _explore._name}}: Profit"
  type: sum
  sql: ${profit} ;;
}

measure: total_revenue { label: "{{ _explore._name}}: Revenue" type: sum sql: ${sale_price} ;; value_format_name: usd }

Tuttavia, ogni team vorrebbe che il nome del campo riflettesse la regione del team.

Gli sviluppatori possono fare in modo che i nomi dei campi vengano visualizzati in un modo per gli utenti di Finance East e in un altro modo per gli utenti di Finance West. Possono farlo con DRY LookML utilizzando i seguenti parametri Liquid:

  • Il parametro from specifica la visualizzazione sottostante per le esplorazioni.
  • explore_label viene utilizzato per visualizzare lo stesso nome per le due esplorazioni con alias ("Vendite aziendali") per creare un'esperienza di esplorazione identica per entrambi i team.
  • Le etichette delle misure possono essere modificate in base alla regione di un team utilizzando la variabile Liquid {{ _explore._name}}, che acquisisce e visualizza il nome di Esplora.
  • The Explores:

    explore: Finance_East{
      from: order_items
      label: "Company Sales"
      view_label: "The Money Zone"
    }
    

    explore: Finance_West{ from: order_items label: "Company Sales" view_label: "The Money Zone" }

    Durante l'esplorazione, il team di Finance East vedrà il campo Utile totale come Finance_East: Utile e il campo Entrate totali come Finance_East: Entrate.

    Durante l'esplorazione, il team di Finance West vedrà il campo Utile totale come Finance_West: Profitto e il campo Entrate totali come Finance_West: Entrate.

    Per altri modi per personalizzare la visualizzazione dei campi per gli utenti, visita la pagina della documentazione Modificare il menu Esplora e il selettore di campi.