Lookup Tables
Cara menggunakan tabel pencarian
Tabel Pencarian adalah cara bagi Anda untuk menyimpan data yang kemudian dapat digunakan di Template, Alur, dan Perjalanan. Buat Tabel Pencarian Anda melalui dashboard, dan kemudian referensikan data secara dinamis dalam tabel-tabel ini.
Tabel Pencarian di Bird menyimpan dan memusatkan referensi data, yang dapat dilihat saat membuat template email menggunakan bahasa template Liquid di HTML.
Misalnya, bendera setiap negara, singkatan, atau mata uang dapat disimpan dan diperbarui secara terpusat sebagai tabel pencarian. Setiap kali digunakan dalam membangun email, dapat diacu dari tabel pencarian ini.
keterbatasan penting:
Setiap tabel dapat memiliki hingga 10 item data terpisah yang disimpan di dalamnya.
Setiap item dapat berisi hingga sekitar 300kB data.
Buat Tabel Lookup
Gunakan Lookup Table dalam Template Email
Untuk menggunakan tabel pencarian dalam templat email, Anda dapat menambahkan sintaks cairan berikut ke templat HTML Anda atau ke elemen HTML yang digunakan dalam pembangun seret dan lepas:
Di sini,
variable_name adalah nama apa pun yang dapat Anda tentukan
lookup-table-slug adalah slug yang Anda berikan saat membuat tabel pencarian
item-name adalah nama item yang Anda buat
object-value adalah nilai yang Anda berikan untuk item JSON
key_name adalah nama kunci dalam pasangan nilai-kunci yang didefinisikan di bawah item-value
Misalnya,
Untuk menampilkan mata uang lokal dari suatu negara yang ditentukan, kita dapat menggunakan sintaks di bawah ini
variable_name di sini ditentukan sebagai currency (nama apa pun yang dapat ditentukan pengguna)
lookup-table-slug di sini adalah country-flags seperti yang ditentukan saat tabel pencarian dibuat
item-name adalah country seperti yang dibuat sebelumnya dan ditampilkan di panel kiri
object-value adalah AD, yang merupakan nilai yang ditentukan dalam JSON. Perhatikan bahwa ini juga bisa menjadi variabel
key_name adalah local_currency, yang didefinisikan dalam JSON
Ketika digunakan dalam pembangun templat email pada blok HTML, sintaks di atas akan menampilkan nilai dari local_currency seperti yang disimpan di bawah objek AD di bawah item negara dalam tabel pencarian country-flags
Anda dapat beralih ke bagian pratinjau untuk melihat nilai output ditampilkan secara dinamis dalam templat email. Di bawah ini, menunjukkan EUR sebagai nilai yang diambil dari tabel pencarian.
Menggunakan tabel pencarian di Flows
Anda dapat membaca tabel pencarian dalam Flows untuk menggunakan kembali data yang didefinisikan secara terpusat.
Untuk menggunakan tabel pencarian, pertama buatlah satu seperti yang dijelaskan di atas.
Arahkan ke Workflows > Flows
Buat flow awal menggunakan jenis pemicu yang Anda pilih.
Tambahkan langkah Perform Lookup baru ke flow Anda. Klik pada Add New Action dan pilih dari grup Lookup Tables atau cari menggunakan kemampuan Pencarian di sebelah kanan:
Akan ditampilkan layar konfigurasi di mana Anda dapat memilih tabel untuk dibaca dan mengkonfigurasi bagaimana Anda ingin melakukan pencarian ini:
Anda akan melihat tiga komponen yang dapat Anda konfigurasi:
Lookup Table Slug menunjukkan tabel mana yang ingin Anda lihat. Dengan mengklik di bidang ini, Flows akan menunjukkan tabel pencarian yang tersedia:
Lookup memungkinkan Anda menentukan apa yang diambil dan Anda dapat menggunakan berbagai variabel yang tersedia untuk menyusun kunci pencarian ini. Operasi default adalah mengembalikan nilai yang ditunjuk pencarian Anda sebagai nilai tingkat akar, tetapi jika Anda ingin membuat objek data - Anda dapat menggunakan kemampuan As untuk memuatnya ke dalam properti tertentu:
Replace memungkinkan Anda mengganti variabel dalam hasil pencarian yang dikembalikan dengan nilai statis atau nilai yang ditentukan di tempat lain dalam tabel pencarian Anda. Contoh berikut akan mengganti teks
{{ MyVariableName }}dalam setiap item yang dikembalikan dengan aksi Lookup dengan nilai yang ditemukan di bawah kuncireplacements.<locale>.MyVariableName:
Dengan kemudian mengklik tombol Test akan memungkinkan Anda melihat data hasilnya:
Mengkonfigurasi tabel mana yang harus dibaca diperlukan dan Anda harus menambahkan setidaknya satu aksi Lookup. Anda tidak diwajibkan untuk menambahkan aksi Replace apapun.
