En esta página, se destacan formas útiles de usar el campo parameter de Looker con algunos de los subparámetros label que aceptan variables de Liquid.
Los ejemplos de esta página requieren que comprendas Liquid. Para obtener información sobre el uso de Liquid en Looker, visita nuestra página de documentación de referencia de variables de Liquid.
Usa view_label para nombres de vistas dinámicos
El parámetro view_label de Looker se usa para agrupar dimensiones con un nombre más contextual y fácil de usar en el selector de campos de la exploración. Para obtener más información sobre las etiquetas de vista, visita la view_label (para campos) página de documentación.
Asignar la misma view_label a las dimensiones simplifica las exploraciones para los usuarios. Los grupos de campos claros y descriptivos garantizan que los usuarios puedan encontrar los datos que necesitan.
Ejemplo: Escribe código DRY (no te repitas) con una view_label de Liquid
Por ejemplo, supongamos que tienes campos organizados en el view_label Finance & Accounting
en una exploración llamada Inventory Items:
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 ;;
}
¿Qué sucede si quieres cambiar la view_label Finance & Accounting
a The Money Zone
para los usuarios? El uso de Liquid puede evitar la reescritura repetitiva del código.
Puedes crear un tipo de seudovariable del nombre de vista deseado con el campo parameter de Looker. Una vez que cambies el nombre de la vista en el parameter, se actualizarán todos los campos.
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: Si no quieres que aparezcan las comillas en el menú, parameter debe configurarse como type:unquoted, y el default_value debe ser una cadena sin espacios, por ejemplo, The_Money_Zone. Si el parámetro es type:string, aparecerán las comillas.
Etiquetas de campo dinámicas
Es posible que tengas varios grupos de usuarios que interpreten el nombre de un campo de manera diferente. Por ejemplo, algunos usuarios podrían referirse a un margen bruto como un margen operativo, y otros usuarios podrían referirse a un margen bruto como un margen estándar, según su caso de uso.
El nombre de un campo puede verse diferente para distintos usuarios según la forma en que combines los atributos de usuario y las variables de Liquid.
Ejemplo: Diferentes etiquetas para diferentes atributos de usuario
Si extrapolamos el ejemplo anterior, puedes adaptarte a las diferencias en la lógica empresarial haciendo que el campo Gross Margin aparezca como Standard Margin para algunos usuarios y Operating Margin para otros. El siguiente LookML aprovecha los atributos de usuario y las variables de 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} ;;
}
Según el LookML, el campo Gross Margin aparece como Operating Margin en un selector de campos de exploración para el Usuario A.
Según el LookML, el campo Gross Margin aparece como Standard Margin en un selector de campos de exploración para el Usuario B.
Este patrón también se puede usar para crear una localización de bajo nivel usuario por usuario, como se muestra en el siguiente ejemplo.
Ejemplo: Nombres de campos personalizados para varias exploraciones
En este ejemplo, se combinan las técnicas de los ejemplos anteriores para crear una exploración con etiquetas de campo que varían según la región de un usuario.
En este ejemplo, hay dos equipos regionales (Finance East y Finance West) que usan una exploración llamada Company Sales. Ambos equipos deben usar las medidas Total Profit y Total Revenue en sus consultas:
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
}
Sin embargo, cada equipo desea que el nombre del campo refleje la región de su equipo.
Los desarrolladores pueden hacer que los nombres de los campos se vean de una manera para los usuarios de Finance East y de otra manera para los usuarios de Finance West. Para ello, pueden usar LookML DRY con los siguientes parámetros de Liquid:
from especifica la vista subyacente para las exploraciones.
explore_label se usa para mostrar el mismo nombre para las dos exploraciones con alias ("Company Sales") para crear una experiencia de exploración idéntica para ambos equipos.
{{ _explore._name}}, que capturará y mostrará el nombre de la exploración.
Las exploraciones:
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"
}
Cuando explore, el equipo de Finance East verá el campo Total profit como Finance_East: Profit y el campo Total Revenue como Finance_East: Revenue.
Cuando explore, el equipo de Finance West verá el campo Total profit como Finance_West: Profit y el campo Total Revenue como Finance_West: Revenue.
Para obtener más formas de personalizar la forma en que los campos aparecen para los usuarios, visita la página de documentación Cómo cambiar el menú Explorar y el selector de campos.