Maneiras interessantes de usar "Líquido" em rótulos

Nesta página, você verá maneiras úteis de usar o campo parameter do Looker com alguns dos subparâmetros label que aceitam variáveis líquidas.

Os exemplos nesta página exigem uma compreensão do Liquid. Para saber como usar esse recurso no Looker, acesse a página de documentação de referência da variável líquida.

Como usar view_label para nomes de visualizações dinâmicas

O parâmetro view_label do Looker é usado para agrupar dimensões em um nome mais contextual e fácil de usar no seletor de campo "Explorar". Saiba mais sobre os rótulos de visualização na página de documentação view_label (para campos).

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

Exemplo: escrever o código DRY (não se repita) com um líquido view_label

Por exemplo, digamos que você tenha campos organizados em view_label Finanças e contabilidade em uma Análise 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 view_label Finanças e contabilidade para Zona monetária para os usuários? O uso do Liquid pode impedir a reescrita repetitiva de códigos.

É possível criar um tipo de pseudovariável com o 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 ;;
}

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

Rótulos de campo dinâmico

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

O nome de um campo pode ser diferente para usuários distintos de acordo com a combinação de atributos do usuário e variáveis líquidas.

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

Extrapolando o exemplo anterior, você pode acomodar as diferenças na lógica de negócios fazendo o campo Margem bruta aparecer 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 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} ;;
}

Com base no LookML, o campo Margem bruta aparece como Margem operacional no seletor de campo "Explorar" do usuário A.

Com base no LookML, o campo Margem bruta aparece como Margem padrão no seletor de campo "Explorar" do usuário B.

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

Exemplo: nomes de campos personalizados para várias Análises

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

Neste exemplo, há duas equipes regionais, Finance East e Finance West, que usam uma Explore chamada Company Sales. Ambas as equipes precisam usar as medidas Lucro total e Receita total nos relatórios:

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 da equipe.

Os desenvolvedores podem fazer com que os nomes dos campos sejam exibidos apenas para os usuários no Finance East e para os usuários no Finance East. Eles podem fazer isso com o DRY LookML usando os seguintes parâmetros Liquid:

O parâmetro from especifica a visualização subjacente das Análises.

O explore_label é usado para mostrar o mesmo nome das duas Análises com alias ("Vendas da empresa") e criar uma experiência de exploração idêntica para ambas as equipes.

Os rótulos das medidas podem ser mudados de acordo com a região da equipe usando a variável "Líquido" {{ _explore._name}}, que vai capturar e mostrar o nome da Análise.

As Análises:

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 a exploração, a equipe do Google Finance Leste verá o campo Lucro total como Finance_Leste: Lucro e o campo Receita total como Finance_East: receita.

Durante a exploração, a equipe do Finance West verá o campo Lucro total como Finance_West: Profit e o campo Total Revenue como Finance_West: Revenue.

Para conhecer outras formas de personalizar a aparência dos campos para os usuários, acesse a página de documentação Como mudar o menu "Explorar" e o seletor de campos (em inglês).