Cara menarik menggunakan Liquid dalam label

Halaman ini menyoroti cara yang berguna untuk menggunakan kolom parameter Looker dengan beberapa subparameter label yang menerima variabel Liquid.

Contoh di halaman ini memerlukan pemahaman tentang Liquid. Untuk mempelajari cara menggunakan Liquid di Looker, kunjungi halaman dokumentasi Referensi variabel cair kami.

Menggunakan view_label untuk nama tampilan dinamis

Parameter view_label Looker digunakan untuk mengelompokkan dimensi dengan nama yang lebih kontekstual dan mudah digunakan di pemilih kolom Jelajahi. Untuk mempelajari label tampilan lebih lanjut, buka halaman dokumentasi view_label (untuk kolom).

Menetapkan view_label yang sama ke dimensi akan menyederhanakan Eksplorasi bagi pengguna. Grup kolom yang deskriptif dan jelas memastikan bahwa pengguna dapat menemukan data yang mereka butuhkan.

Contoh: Menulis kode DRY (jangan diulangi sendiri) dengan Liquid view_label

Misalnya, Anda memiliki kolom yang diatur dalam view_label Keuangan & Akuntansi dalam bagian Jelajah yang disebut Item Inventaris:

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

Bagaimana jika Anda ingin mengubah view_label Keuangan & Akuntansi ke The Money Zone untuk pengguna? Menggunakan Liquid dapat mencegah penulisan ulang kode secara berulang.

Anda dapat membuat jenis variabel pseudo dari nama tampilan yang diinginkan, menggunakan kolom parameter Looker. Setelah Anda mengubah nama tampilan di parameter, semua kolom akan diperbarui.

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

Catatan: Jika Anda tidak ingin tanda kutip muncul di menu, parameter harus disetel sebagai type:unquoted, dan default_value harus berupa string tanpa spasi, misalnya, The_Money_Zone. Jika parameternya type:string, tanda kutip akan muncul.

Label kolom dinamis

Anda mungkin memiliki beberapa grup pengguna yang mungkin menafsirkan nama kolom secara berbeda. Misalnya, beberapa pengguna dapat menyebut margin kotor sebagai margin operasi, dan pengguna lainnya dapat menyebut margin kotor sebagai margin standar, bergantung pada kasus penggunaan mereka.

Nama kolom dapat terlihat berbeda untuk pengguna yang berbeda, tergantung cara Anda menggabungkan atribut pengguna dan Variabel likuid.

Contoh: Label yang berbeda untuk atribut pengguna yang berbeda

Dengan mengekstrapolasi contoh sebelumnya, Anda dapat mengakomodasi perbedaan dalam logika bisnis dengan membuat kolom Margin Kotor muncul sebagai Margin Standar untuk beberapa pengguna dan Margin Operasi untuk pengguna lainnya. LookML berikut memanfaatkan atribut pengguna dan variabel Liquid.

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

Berdasarkan LookML, kolom Margin Kotor muncul sebagai Margin Operasi di pemilih kolom Jelajah untuk Pengguna A.

Berdasarkan LookML, kolom Margin Kotor muncul sebagai Margin Standar di pemilih kolom Jelajah untuk Pengguna B.

Pola ini juga dapat digunakan untuk membuat pelokalan tingkat rendah berdasarkan setiap pengguna, seperti yang ditunjukkan dalam contoh berikutnya.

Contoh: Nama kolom yang disesuaikan untuk beberapa Jelajah

Contoh ini menggabungkan teknik dari contoh sebelumnya untuk membuat Eksplorasi dengan label kolom yang bervariasi bergantung pada wilayah pengguna.

Dalam contoh ini, ada dua tim regional — Finance East dan Finance West — yang menggunakan Explore yang disebut Company Sales. Kedua tim harus menggunakan ukuran Laba Total dan Pendapatan Total dalam laporan mereka:

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
}

Namun, setiap tim ingin nama kolom mencerminkan wilayah tim mereka.

Developer dapat membuat nama kolom terlihat dari salah satu cara bagi pengguna di Finance East dan cara lain bagi pengguna di Finance West. Mereka dapat melakukannya dengan DRY LookML menggunakan parameter Liquid berikut:

Parameter from menentukan tampilan dasar untuk Jelajah.

explore_label digunakan untuk menampilkan nama yang sama untuk dua Jelajah beralias ("Penjualan Perusahaan") guna menciptakan pengalaman penjelajahan yang identik bagi kedua tim.

Label ukuran dapat diubah sesuai dengan wilayah tim dengan memanfaatkan variabel Liquid {{ _explore._name}}, yang akan mengambil dan menampilkan nama Jelajah.

Penjelajahan:

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

Saat mempelajari, tim Finance East akan melihat kolom Total laba sebagai Financial_East: Profit dan kolom Total Revenue sebagai Financial_East: Revenue.

Saat mempelajari, tim Finance West akan melihat kolom Total laba sebagai Bagian Keuangan_West: Laba dan kolom Total Pendapatan sebagai Keuangan_West: Pendapatan.

Guna mengetahui cara lain untuk menyesuaikan kolom ditampilkan kepada pengguna, buka halaman dokumentasi Mengubah menu Eksplorasi dan pemilih kolom.