Formas interessantes de usar o Liquid em rótulos

Esta página destaca maneiras úteis de usar o campo parameter do Looker com alguns dos subparâmetros label que aceitam variáveis Liquid.

Os exemplos nesta página exigem o entendimento do Liquid. Para saber como usar o Liquid no Looker, acesse a página de documentação Referência de variáveis do Liquid.

Como usar view_label para nomes de visualização dinâmica

O parâmetro view_label do Looker é usado para agrupar dimensões com um nome mais contextual e fácil de usar no seletor de campo da Análise. Para saber mais sobre os identificadores de visualização, acesse a página de documentação view_label (para campos).

Atribuir o mesmo view_label às dimensões simplifica as análises para os usuários. Grupos de campos claros e descritivos garantem que os usuários encontrem os dados de que precisam.

Exemplo: escrever código DRY (não se repita) com um view_label do Liquid

Por exemplo, digamos que você tenha campos organizados em view_label Finanças e contabilidade em uma análise detalhada chamada Itens de inventário:

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 você quisesse mudar o view_label Finanças e contabilidade para The Money Zone para os usuários? Usar o Liquid pode evitar a reescrita repetitiva de código.

É possível criar um tipo de pseudovariável do nome da visualização desejada usando o campo parameter do Looker. Depois que você mudar o nome da visualização no parameter, todos os campos serão atualizados.

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 ;; }

Seletor de campos do recurso Detalhar itens de inventário mostrando "Custo", "Custo EUR" e "Custo sem IVA" organizados no rótulo da visualização "The Money Zone".

Observação:se você não quiser que as aspas apareçam no menu, parameter precisa ser definido como type:unquoted, e o default_value precisa ser uma string sem espaços, por exemplo, The_Money_Zone. Se o parâmetro for type:string, as aspas vão aparecer.

Rótulos de campo dinâmicos

Você pode ter vários grupos de usuários que interpretam o nome de um campo de maneira diferente. Por exemplo, alguns usuários podem se referir a uma margem bruta como uma margem operacional, e outros podem se referir a ela como uma margem padrão, dependendo do caso de uso.

O nome de um campo pode ter uma aparência diferente para usuários diferentes, dependendo de como você combina atributos do usuário e variáveis do Liquid.

Exemplo: rótulos diferentes para atributos de usuário diferentes

Extrapolando o exemplo anterior, você pode acomodar diferenças na lógica de negócios fazendo com que o campo Margem bruta apareça como Margem padrão para alguns usuários e Margem operacional para outros. O LookML a seguir usa atributos de usuário e variáveis 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} ;;
}

Com base na LookML, o campo Margem bruta aparece como Margem operacional em um seletor de campos da análise detalhada para Usuário A.

Com base no LookML, o campo Margem bruta aparece como Margem padrão em um seletor de campos da análise detalhada para o Usuário B.

Esse padrão também pode ser usado para criar localização de baixo nível para cada usuário, conforme demonstrado no próximo exemplo.

Exemplo: nomes de campos personalizados para várias análises detalhadas

Este exemplo combina as técnicas dos exemplos anteriores para criar uma análise detalhada com rótulos de campo que variam de acordo com a região do usuário.

Neste exemplo, há duas equipes regionais, Finanças Leste e Finanças Oeste, que usam uma análise detalhada chamada Vendas da empresa. As duas equipes precisam usar as medidas Lucro total e Receita total nas 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 }

No entanto, cada equipe quer que o nome do campo reflita a região dela.

Os desenvolvedores podem fazer com que os nomes dos campos apareçam de uma forma para os usuários da Finance East e de outra para os usuários da Finance West. Eles podem fazer isso com a LookML DRY usando os seguintes parâmetros do Liquid:

  • O parâmetro from especifica a visualização subjacente das análises detalhadas.
  • O explore_label é usado para mostrar o mesmo nome para as duas análises detalhadas com alias ("Vendas da empresa") e criar uma experiência de análise idêntica para as duas equipes.
  • Os rótulos das métricas podem ser alterados de acordo com a região de uma equipe usando a variável Liquid {{ _explore._name}}, que captura e mostra o nome da análise detalhada.
  • As análises detalhadas:

    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" }

    Ao fazer análises detalhadas, a equipe da Finance East vai encontrar o campo Lucro total como Finance_East: Profit e o campo Receita total como Finance_East: Revenue.

    Ao fazer análises detalhadas, a equipe da Finance West vai encontrar o campo Lucro total como Finance_West: Profit e o campo Receita total como Finance_West: Revenue.

    Para outras maneiras de personalizar a aparência dos campos para os usuários, acesse a página de documentação Mudar o menu "Explorar" e o seletor de campos.