En esta página se destacan formas útiles de usar el campo parameter de Looker con algunos de los labelsubparámetros que aceptan variables de Liquid.
Para entender los ejemplos de esta página, debes conocer Liquid. Para obtener información sobre cómo usar Liquid en Looker, consulta la página de documentación Referencia de variables de Liquid.
Usar view_label para los nombres de las vistas dinámicas
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 Explorar. Para obtener más información sobre las etiquetas de vista, consulta la página de documentación de view_label (para campos).
Asignar el mismo view_label a las dimensiones simplifica Exploraciones para los usuarios. Los grupos de campos claros y descriptivos permiten que los usuarios encuentren los datos que necesitan.
Ejemplo: Escribir código DRY (no te repitas) con un view_label de Liquid
Por ejemplo, supongamos que tienes campos organizados en view_label Finanzas y contabilidad
en una Exploración llamada Artículos 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é ocurriría si quisieras cambiar el nombre view_label Finanzas y contabilidad
a La zona del dinero
para los usuarios? Con Liquid, puedes evitar tener que volver a escribir código repetitivo.
Puedes crear un tipo de pseudovariable con el nombre de la vista que quieras mediante el campo parameter de Looker. Cuando 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 aparezcan comillas en el menú, parameter debe tener el valor type:unquoted y 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
Puede que haya varios grupos de usuarios que interpreten el nombre de un campo de forma diferente. Por ejemplo, algunos usuarios podrían referirse al margen bruto como margen operativo, mientras que otros podrían referirse a él como margen estándar, en función de su caso práctico.
El nombre de un campo puede ser diferente para cada usuario en función de cómo combines los atributos de usuario y las variables de Liquid.
Ejemplo: diferentes etiquetas para distintos atributos de usuario
Extrapolando el ejemplo anterior, puedes adaptarte a las diferencias en la lógica empresarial haciendo que el campo Margen bruto aparezca como Margen estándar para algunos usuarios y como Margen operativo para otros. El siguiente LookML utiliza atributos de usuario y 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 Margen bruto aparece como Margen operativo en el selector de campos de Exploración de Usuario A.
Según el LookML, el campo Gross Margin (Margen bruto) aparece como Standard Margin (Margen estándar) en el selector de campos de Exploración de User B (Usuario B).
Este patrón también se puede usar para crear una localización de bajo nivel de forma individual para cada usuario, como se muestra en el siguiente ejemplo.
Ejemplo: nombres de campos personalizados para varios 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 en función de la región de un usuario.
En este ejemplo, hay dos equipos regionales (Finanzas Este y Finanzas Oeste) que usan una exploración llamada Ventas de la empresa. Ambos equipos deben usar las medidas Beneficio total e Ingresos totales 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 quiere que el nombre del campo refleje la región de su equipo.
Los desarrolladores pueden hacer que los nombres de los campos se muestren de una forma a los usuarios de Finanzas Este y de otra a los de Finanzas Oeste. Para ello, pueden usar LookML DRY con los siguientes parámetros de Liquid:
from especifica la vista subyacente de las exploraciones.
explore_label se usa para mostrar el mismo nombre en los dos Exploraciones con alias ("Ventas de la empresa") y, de esta forma, crear una experiencia de exploración idéntica para ambos equipos.
{{ _explore._name}}, que capturará y mostrará el nombre del Explorador.
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 exploren los datos, el equipo de Finanzas del Este verá el campo Beneficio total como Finanzas_Este: Beneficio y el campo Ingresos totales como Finanzas_Este: Ingresos.
Cuando exploren los datos, el equipo de Finanzas del Oeste verá el campo Beneficio total como Finanzas_Oeste: Beneficio y el campo Ingresos totales como Finanzas_Oeste: Ingresos.
Para ver otras formas de personalizar cómo se muestran los campos a los usuarios, consulta la página de documentación Cambiar el menú Explorar y el selector de campos.