Questa pagina illustra modi utili per utilizzare il campo parameter di Looker con alcuni dei parametri secondari label che accettano variabili Liquid.
Gli esempi in questa pagina richiedono una conoscenza di Liquid. Per scoprire di più sull'utilizzo di Liquid in Looker, consulta 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 sotto un nome più contestuale e facile da usare nel selettore dei campi di esplorazione. Per scoprire di più sulle etichette delle visualizzazioni, consulta la pagina della documentazione di view_label (per i campi).
L'assegnazione della stessa view_label alle dimensioni semplifica le esplorazioni per gli utenti. Gruppi di campi chiari e descrittivi assicurano che gli utenti possano trovare i dati di cui hanno bisogno.
Esempio: scrittura di codice DRY (Don't Repeat Yourself) con un view_label Liquid
Ad esempio, supponiamo che tu abbia campi organizzati in view_label Finanza e contabilità
in un'esplorazione denominata Elementi dell'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 ;;
}
E se volessi cambiare view_label Finanza e contabilità
in La tua Zona Finanza
per gli utenti? L'utilizzo di Liquid può impedire la riscrittura ripetitiva del codice.
Puoi creare un tipo di pseudo-variabile del nome della visualizzazione che ti interessa 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 ;;
}
Nota: se non vuoi che le virgolette vengano visualizzate nel menu, parameter deve essere impostato su type:unquoted e default_value deve essere una stringa senza spazi, ad esempio The_Money_Zone. Se il parametro è type:string, vengono 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, a seconda del caso d'uso, alcuni utenti potrebbero fare riferimento a un margine lordo come margine operativo, mentre altri potrebbero fare riferimento a un margine lordo come margine standard.
Il nome di un campo può avere un aspetto diverso per utenti diversi a seconda di come combini gli attributi utente e le variabili Liquid.
Esempio: etichette diverse per attributi utente diversi
Facendo una extrapolazione dell'esempio precedente, puoi adattarti alle differenze nella logica aziendale facendo in modo che il campo Margine lordo venga visualizzato come Margine standard per alcuni utenti e Margine operativo per altri utenti. Il seguente codice LookML sfrutta 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 al codice LookML, il campo Margine lordo viene visualizzato come Margine operativo in un selettore di campi di esplorazione per l'utente A.
In base al codice LookML, il campo Margine lordo viene visualizzato come Margine standard in un selettore di campi di esplorazione per l'utente B.
Questo pattern può essere utilizzato anche per creare localizzazioni a basso livello su base utente, come dimostrato nell'esempio seguente.
Esempio: nomi di campi personalizzati per più esplorazioni
Questo esempio combina le tecniche degli esempi precedenti per creare un'esplorazione con etichette dei campi che variano in base alla regione dell'utente.
In questo esempio, ci sono due team regionali, Finanza Est e Finanza Ovest, che utilizzano un'esplorazione denominata Vendite aziendali. Entrambi i team devono utilizzare le misure Profitto totale ed 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 rispecchi la regione del team.
Gli sviluppatori possono mostrare i nomi dei campi in un modo per gli utenti di Finanza Est e in un altro per gli utenti di Finanza Ovest. Possono farlo con DRY LookML utilizzando i seguenti parametri Liquid:
from specifica la vista sottostante per le esplorazioni.
explore_label viene utilizzato per visualizzare lo stesso nome per le due esplorazioni con alias ("Vendite dell'azienda") per creare un'esperienza di esplorazione altrimenti identica per entrambi i team.
{{ _explore._name}}, che acquisisce e mostra il nome dell'esplorazione.
Le esplorazioni:
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 Finance East vedrà il campo Profitto totale come Finance_East: Profit e il campo Entrate totali come Finance_East: Revenue.
Durante l'esplorazione, il team Finance West vedrà il campo Profitto 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.