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 Liquid.
Los ejemplos de esta página requieren una comprensión de Liquid. Si quieres obtener información para usar Liquid en Looker, visita nuestra página de documentación Referencia de variables líquidas.
Cómo usar view_label para los nombres de vistas dinámicas
El parámetro view_label de Looker se usa para agrupar dimensiones en un nombre más contextual y fácil de usar en el selector de campos de Explorar. Para obtener más información sobre las etiquetas de vista, visita la página de documentación view_label (para campos).
Asignar los mismos 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 un view_label líquido
Por ejemplo, supongamos que tienes campos organizados en Finanzas y contabilidad
de view_label en una exploración llamada Elementos de 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 ;;
}
¿Qué pasaría si quisieras cambiar la view_label de Finanzas y contabilidad
a La zona financiera
para los usuarios? El uso de Liquid puede evitar la reescritura repetitiva del código.
Puedes crear un tipo de seudovariable del nombre de la vista deseada con el campo parameter de Looker. Una vez que cambies el nombre de la vista en 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 las comillas aparezcan en el menú, parameter debe establecerse como type:unquoted, y default_value debe ser una string sin espacios, por ejemplo, The_Money_Zone. Si el parámetro es type:string, aparecerán las comillas.
Etiquetas de campos dinámicos
Es posible que tengas varios grupos de usuarios que podrían interpretar el nombre de un campo de manera diferente. Por ejemplo, algunos usuarios podrían referirse a un margen bruto como margen operativo, mientras que otros podrían referirse a un margen bruto como margen estándar, según su caso de uso.
El nombre de un campo puede tener un aspecto diferente para los distintos usuarios según la combinación de los atributos de usuario y las variables liquid.
Ejemplo: Diferentes etiquetas para distintos atributos de usuario
Si extrapola el ejemplo anterior, puede ajustar las diferencias en la lógica empresarial. Para ello, haga que el campo Margen bruto aparezca como Margen estándar para algunos usuarios y Margen operativo para otros. El siguiente LookML aprovecha los atributos de usuario y las variables líquidas.
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} ;;
}
Según LookML, el campo Margen bruto aparece como Margen operativo en un selector de campos de Explorar para el Usuario A.
Según LookML, el campo Margen bruto aparece como Margen estándar en un selector de campos de Explorar para el Usuario B.
Este patrón también se puede usar para crear localización de bajo nivel usuario por usuario, como se demuestra 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 Ganancias totales e Ingresos totales en sus informes:
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 quiere 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. Pueden hacerlo con DRY LookML mediante los siguientes parámetros de Liquid:
from especifica la vista subyacente de las exploraciones.
explore_label se usa para mostrar el mismo nombre para las dos exploraciones con alias ("Ventas de la empresa") a fin de crear una experiencia de exploración idéntica para ambos equipos.
{{ _explore._name}}, que captará y mostrará el nombre de Explorar.
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"
}
Al explorar, el equipo de Finance East verá el campo Ganancia total como Finance_East: Ganancia y el campo Ingresos totales como Finance_East: Ingresos.
Cuando explores la herramienta, el equipo de Finance West verá el campo Ganancia total como Finance_West: Ganancia y el campo Ingresos totales como Finance_West: Ingresos.
Si quieres conocer más formas de personalizar la forma en que se muestran los campos a los usuarios, visita la página de documentación Cómo cambiar el menú Explorar y el selector de campos.