Questa pagina evidenzia modi utili per utilizzare il campo parameter di Looker con alcuni dei sottoparametri label che accettano le variabili Liquid.
Gli esempi in questa pagina richiedono una conoscenza di Liquid. Per saperne di più sull'utilizzo di Liquid in Looker, consulta la pagina della documentazione Informazioni sulle variabili Liquid.
Utilizzo dell'view_label per i nomi delle visualizzazioni dinamiche
Il parametro view_label di Looker viene utilizzato per raggruppare le dimensioni in un nome più contestuale e facile da usare nel selettore di campi Esplora. Per scoprire di più sulla visualizzazione delle etichette, visita la pagina della documentazione relativa a 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 assicurano che gli utenti possano trovare i dati di cui hanno bisogno.
Esempio: scrivere codice DRY (non ripetere tutto da solo) con un Liquid view_label
Ad esempio, supponiamo che tu abbia campi organizzati nella sezione view_label Finanza e contabilità
di un'esplorazione chiamata Articoli 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 il campo view_label Finanza e contabilità
in La zona denaro
per gli utenti? L'utilizzo di Liquid può impedire la ripetitiva riscrittura del codice.
Puoi creare un tipo di pseudo-variabile del nome della vista 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 ;;
}
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, verranno visualizzate le virgolette.
Etichette dei campi dinamici
Potresti avere più gruppi di utenti che interpretano il nome di un campo in modo diverso. Ad esempio, alcuni utenti potrebbero fare riferimento a un margine lordo un margine operativo e altri potrebbero fare riferimento a un margine lordo come margine standard, a seconda del loro caso d'uso.
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
Ricavando l'esempio precedente, puoi soddisfare le differenze nella logica di business mostrando il campo Margine lordo come Margine standard per alcuni utenti e Margine operativo per altri. Il seguente LookML utilizza attributi utente e variabili Liquid.
dimension: gross_margin {
label: "{% dynamic if _user_attributes['customer'] == 'A' %} Standard Margin
{% elsif _user_attributes['customer'] == 'B' %} Operating Margin
{% dynamic else %} Gross Margin
{% dynamic 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 l'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 su base individuale, come mostrato nell'esempio successivo.
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 a seconda della regione dell'utente.
In questo esempio, ci sono due team regionali, Finance East e Finance West, che utilizzano un'esplorazione chiamata Company Sales (Vendite aziendali). Entrambi i team devono utilizzare le misure Profitto totale ed Entrate totali nei report:
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 rifletta la regione del proprio team.
Gli sviluppatori possono fare in modo che i nomi dei campi appaiano un modo per gli utenti di Finance East e un altro per gli utenti di Finance West. Può farlo con LookML DRY utilizzando i seguenti parametri Liquid:
from specifica la vista sottostante le esplorazioni.
explore_label viene utilizzata per mostrare lo stesso nome per le due esplorazioni con alias ("Vendite aziendali") in modo da 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: Entrate.
Durante l'esplorazione, il team di Finance West vedrà il campo Profitto totale come Finance_West: Profit e il campo Total Revenue (Entrate totali) come Finance_West: Revenue.
Per scoprire altri modi per personalizzare l'aspetto dei campi per gli utenti, visita la pagina della documentazione Modificare il menu Esplora e il selettore campi.