Anda dapat menggunakan parameter constant
LookML dalam file manifes project untuk menentukan string yang dapat digunakan di seluruh project. Konstanta LookML dapat berguna ketika 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 menyertakan contoh penggunaan konstanta LookML berikut untuk menentukan dan mengelola nilai string yang dapat digunakan kembali di satu tempat:
- Menggunakan string yang sama dalam label beberapa Jelajah: 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 ke nilai negatif untuk beberapa kolom: Teknik ini membantu Anda menghemat waktu dengan menentukan spesifikasi format bersyarat yang akan digunakan di beberapa kolom.
Produk
- File manifes project Anda
- Parameter
constant
LookML - Sintaksis
@{constant_name}
untuk mereferensikan konstanta yang ada - Parameter
html
LookML - Variabel cair
Prasyarat
Contoh: Menggunakan string yang sama dalam label di beberapa Jelajah
Misalnya Anda ingin membuat dua Jelajah, 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 direferensikan di bagian mana pun dalam project Anda tempat string diterima, menggunakan sintaksis @{place_name}
. Dalam contoh ini, Anda dapat menentukan Jelajah 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 di San Francisco dan Pesanan di San Francisco di menu Eksplorasi dan di judul Jelajah, bukan label Pengguna dan Pesanan default.
Misalnya Anda ingin memperbarui semua referensi ke San Francisco ke Bay Area.
Daripada memperbarui setiap referensi secara manual, Anda hanya perlu membuat satu update pada konstanta place_name
dalam file manifes untuk project Anda:
constant: place_name {
value: "Bay Area"
}
Karena Anda 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 Eksplorasi dan di judul Jelajah.
Contoh: Menerapkan format yang sama pada nilai negatif untuk beberapa kolom
Bayangkan Anda ingin nilai data negatif ditampilkan dengan warna merah dan dalam tanda kurung di mana pun nilai data tersebut muncul dalam laporan.
Dengan menetapkan format ini sebagai nilai untuk konstanta LookML, Anda dapat menentukan pemformatan sekali saja dengan menggunakan Variabel cair dan HTML. Kemudian, Anda dapat mereferensikan konstanta setiap kali ingin menerapkan format tersebut ke kolom.
Misalnya, Anda dapat membuat konstanta bernama negative_format
yang dapat digunakan untuk menerapkan format ini ke kolom:
constant: negative_format {
value: "{% dynamic if value < 0 %}
<p style='color:red;'>({{rendered_value}})</p>
{% dynamic else %}
{{rendered_value}}
{% dynamic endif %}"
}
Kode ini membuat negative_format
konstan, yang menentukan bahwa nilai data negatif harus memiliki font merah dan diapit oleh tanda kurung. Anda kemudian 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, nilai negatif untuk ukuran Total Jumlah akan diformat seperti yang ditentukan dalam definisi konstanta negative_format
, dengan font merah dan diapit tanda kurung.
Jika ingin menerapkan format yang sama pada nilai negatif untuk kolom lain, Anda dapat mereferensikan konstanta negative_format
dalam parameter html
untuk kolom tersebut.