Anda dapat menggunakan parameter constant
LookML dalam file manifes project untuk menentukan string yang dapat digunakan di seluruh project. Konstanta LookML dapat berguna saat Anda perlu menentukan string tertentu — seperti angka, nama, atau format HTML untuk nilai kolom — dan menggunakan kembali nilai tersebut di seluruh project Anda.
Halaman ini mencakup contoh berikut tentang penggunaan konstanta LookML untuk menentukan dan mempertahankan nilai string yang dapat digunakan kembali di satu tempat:
- Menggunakan string yang sama dalam label beberapa Eksplorasi: Teknik ini membantu Anda menghemat waktu jika Anda menggunakan kembali string umum, seperti kata, frasa, atau nama lokasi dalam definisi Anda.
- Menerapkan format yang sama pada nilai negatif untuk beberapa kolom: Teknik ini membantu Anda menghemat waktu dengan menentukan spesifikasi format bersyarat untuk digunakan di beberapa kolom.
Produk
- File manifes project Anda
- Parameter LookML
constant
- Sintaksis
@{constant_name}
untuk mereferensikan konstanta yang ada - Parameter LookML
html
- Variabel Liquid
Prasyarat
Contoh: Menggunakan string yang sama di label beberapa Eksplorasi
Misalkan Anda ingin membuat dua Eksplorasi, yang diberi label Pengguna San Francisco dan Pesanan San Francisco di UI, tetapi Anda tidak ingin mengetik teks untuk setiap label secara manual.
Untuk melakukannya, Anda dapat menentukan konstanta place_name
dengan nilai "San Francisco"
dalam file manifes project untuk project Anda:
constant: place_name {
value: "San Francisco"
}
Konstanta ini kemudian dapat dirujuk di bagian mana pun dalam project Anda yang menerima string, menggunakan sintaksis @{place_name}
. Dalam contoh ini, Anda dapat menentukan Eksplorasi users
dan orders
, dengan menentukan "@{place_name} Users"
dan "@{place_name} Orders"
sebagai nilai untuk parameter label
, seperti dalam contoh berikut:
explore: users {
label: "@{place_name} Users"
}
explore: orders {
label: "@{place_name} Orders"
}
Dalam contoh ini, Looker menampilkan Pengguna San Francisco dan Pesanan San Francisco di menu Jelajah dan di judul Eksplorasi, bukan label Pengguna dan Pesanan default.
Misalnya, Anda ingin memperbarui semua referensi San Francisco menjadi Bay Area.
Daripada harus memperbarui setiap referensi secara manual, Anda hanya perlu melakukan satu pembaruan pada konstanta place_name
dalam file manifes untuk project Anda:
constant: place_name {
value: "Bay Area"
}
Karena Anda telah menentukan konstanta place_name
, Anda tidak perlu mengubah San Francisco menjadi Bay Area secara manual di beberapa tempat. Referensi ke San Francisco dengan konstanta place_name
akan diganti dengan Bay Area, sehingga Looker akan menampilkan Pengguna Bay Area dan Pesanan Bay Area di menu Jelajah dan di judul Eksplorasi.
Contoh: Menerapkan format yang sama ke nilai negatif untuk beberapa kolom
Bayangkan Anda ingin nilai data negatif ditampilkan dalam warna merah dan dalam tanda kurung di mana pun nilai tersebut muncul dalam diagram atau kueri.
Dengan menetapkan pemformatan ini sebagai nilai untuk konstanta LookML, Anda dapat menentukan pemformatan hanya sekali dengan menggunakan variabel Liquid dan HTML. Kemudian, Anda dapat mereferensikan konstanta setiap kali Anda ingin menerapkan pemformatan tersebut ke kolom.
Misalnya, Anda dapat membuat konstanta bernama negative_format
yang dapat digunakan untuk menerapkan format ini ke kolom:
constant: negative_format {
value: "{% if value < 0 %}
<p style='color:red;'>({{rendered_value}})</p>
{% else %}
{{rendered_value}}
{% endif %}"
}
Kode ini membuat konstanta negative_format
, yang menentukan bahwa nilai data negatif harus memiliki font merah dan diapit tanda kurung. Kemudian, Anda dapat menerapkan format ini ke dimensi dan ukuran dalam set data menggunakan parameter html
.
Misalnya, Anda dapat membuat ukuran Total Jumlah type: sum
dan menentukan @{negative_format}
sebagai nilai untuk parameter html
:
measure: total_amount {
type: sum
value_format_name: usd
sql: ${amount} ;;
html: @{negative_format} ;;
}
Dalam tabel Anda, nilai negatif untuk ukuran Jumlah Total akan diformat seperti yang ditentukan dalam definisi konstanta negative_format
, dengan font merah dan diapit tanda kurung.
Jika ingin menerapkan format yang sama ke nilai negatif untuk kolom lain, Anda dapat mereferensikan konstanta negative_format
dalam parameter html
untuk kolom tersebut.