G

G

M

M

Tabel Pencarian

Cara menggunakan tabel pencarian

Ikhtisar

Ikhtisar

Ikhtisar

Tabel Pencarian adalah cara bagi Anda untuk menyimpan data yang kemudian dapat Anda gunakan dalam Template, Alur, dan Perjalanan. Buat Tabel Pencarian Anda melalui dasbor, dan kemudian secara dinamis rujuk data dalam tabel ini.

Tabel Pencarian di Bird menyimpan dan memusatkan referensi data, yang dapat dicari saat membuat template email menggunakan bahasa templating Liquid dalam HTML.

Misalnya, bendera, singkatan, atau mata uang setiap negara dapat disimpan dan diperbarui secara terpusat sebagai tabel pencarian. Setiap kali digunakan dalam membangun email, dapat dirujuk dari tabel pencarian ini.

Limitasi penting:

  • Setiap tabel dapat memiliki hingga 10 item data terpisah yang disimpan di dalamnya.

  • Setiap item dapat berisi hingga sekitar 300kB data.

Buat Tabel Pencarian

Pergi ke Konten > Tabel Lookup dan klik pada Buat.

  • Masukkan nama tampilan

  • Masukkan slug tanpa spasi



Slug digunakan untuk merujuk ke tabel ini dan hanya boleh berisi karakter alfanumerik. Perhatikan bahwa slug ini digunakan untuk merujuk ke template email

  • Klik pada Simpan



Membuat item dalam tabel

Klik pada tabel yang telah Anda buat

Dari menu konteks yang muncul, pilih "Lihat"



Setiap item dalam tabel pada dasarnya adalah dokumen JSON. Ini berarti Anda dapat membangun struktur pohon kunci dan nilai, di mana nilai dapat berupa teks, angka, boolean, array, atau objek itu sendiri. Anda dapat memasukkan dokumen JSON secara langsung, menggunakan sintaks JSON atau Anda dapat menggunakan editor UI untuk menyusun dokumen JSON.

Editor JSON

  • Setelah Anda menyimpan, Anda akan melihat editor JSON. Anda dapat memilih antara editor Teks atau UI berdasarkan preferensi Anda.

  • Perbarui tabel lookup menggunakan struktur JSON.

Menambahkan item

Untuk menambahkan item dalam JSON untuk organisasi, klik pada +Tambahkan Item di panel kiri.

  • Ketik nama di bagian atas

  • Klik pada tombol Tambahkan Item

  • Setelah dibuat, Anda dapat melihat item yang dibuat di panel kiri.

Tulis JSON

Gunakan format JSON untuk mendefinisikan struktur objek dan pasangan kunci-nilai di bawah ini:

Misalnya, sebuah JSON yang memberikan nama negara dan mata uang lokal berdasarkan singkatan negara

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

Anda juga dapat menggunakan editor UI untuk mendefinisikan struktur JSON.


Pergi ke Konten > Tabel Lookup dan klik pada Buat.

  • Masukkan nama tampilan

  • Masukkan slug tanpa spasi



Slug digunakan untuk merujuk ke tabel ini dan hanya boleh berisi karakter alfanumerik. Perhatikan bahwa slug ini digunakan untuk merujuk ke template email

  • Klik pada Simpan



Membuat item dalam tabel

Klik pada tabel yang telah Anda buat

Dari menu konteks yang muncul, pilih "Lihat"



Setiap item dalam tabel pada dasarnya adalah dokumen JSON. Ini berarti Anda dapat membangun struktur pohon kunci dan nilai, di mana nilai dapat berupa teks, angka, boolean, array, atau objek itu sendiri. Anda dapat memasukkan dokumen JSON secara langsung, menggunakan sintaks JSON atau Anda dapat menggunakan editor UI untuk menyusun dokumen JSON.

Editor JSON

  • Setelah Anda menyimpan, Anda akan melihat editor JSON. Anda dapat memilih antara editor Teks atau UI berdasarkan preferensi Anda.

  • Perbarui tabel lookup menggunakan struktur JSON.

Menambahkan item

Untuk menambahkan item dalam JSON untuk organisasi, klik pada +Tambahkan Item di panel kiri.

  • Ketik nama di bagian atas

  • Klik pada tombol Tambahkan Item

  • Setelah dibuat, Anda dapat melihat item yang dibuat di panel kiri.

Tulis JSON

Gunakan format JSON untuk mendefinisikan struktur objek dan pasangan kunci-nilai di bawah ini:

Misalnya, sebuah JSON yang memberikan nama negara dan mata uang lokal berdasarkan singkatan negara

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

Anda juga dapat menggunakan editor UI untuk mendefinisikan struktur JSON.


Pergi ke Konten > Tabel Lookup dan klik pada Buat.

  • Masukkan nama tampilan

  • Masukkan slug tanpa spasi



Slug digunakan untuk merujuk ke tabel ini dan hanya boleh berisi karakter alfanumerik. Perhatikan bahwa slug ini digunakan untuk merujuk ke template email

  • Klik pada Simpan



Membuat item dalam tabel

Klik pada tabel yang telah Anda buat

Dari menu konteks yang muncul, pilih "Lihat"



Setiap item dalam tabel pada dasarnya adalah dokumen JSON. Ini berarti Anda dapat membangun struktur pohon kunci dan nilai, di mana nilai dapat berupa teks, angka, boolean, array, atau objek itu sendiri. Anda dapat memasukkan dokumen JSON secara langsung, menggunakan sintaks JSON atau Anda dapat menggunakan editor UI untuk menyusun dokumen JSON.

Editor JSON

  • Setelah Anda menyimpan, Anda akan melihat editor JSON. Anda dapat memilih antara editor Teks atau UI berdasarkan preferensi Anda.

  • Perbarui tabel lookup menggunakan struktur JSON.

Menambahkan item

Untuk menambahkan item dalam JSON untuk organisasi, klik pada +Tambahkan Item di panel kiri.

  • Ketik nama di bagian atas

  • Klik pada tombol Tambahkan Item

  • Setelah dibuat, Anda dapat melihat item yang dibuat di panel kiri.

Tulis JSON

Gunakan format JSON untuk mendefinisikan struktur objek dan pasangan kunci-nilai di bawah ini:

Misalnya, sebuah JSON yang memberikan nama negara dan mata uang lokal berdasarkan singkatan negara

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

Anda juga dapat menggunakan editor UI untuk mendefinisikan struktur JSON.


Gunakan Tabel Pencarian dalam Template Email


Untuk menggunakan tabel pencarian dalam template email, Anda dapat menambahkan sintaks liquid berikut ke template HTML Anda atau ke elemen HTML yang digunakan dalam pembangun seret dan lepas:

{% assign variable_name = "lookup-table-slug" | lookup: "item-name", "object-value" %}

{{variable_name.key_name}}

Di sini,

  • variable_name adalah nama apa pun yang dapat Anda definisikan

  • lookup-table-slug adalah slug yang Anda berikan saat membuat tabel pencarian

  • item-name adalah nama item yang telah Anda buat

  • object-value adalah nilai yang telah Anda berikan untuk item JSON

  • key_name adalah nama kunci dalam pasangan kunci-nilai yang didefinisikan di bawah item-value

Misalnya,

Untuk merender mata uang lokal dari negara yang ditentukan, kita dapat menggunakan sintaks di bawah ini

  • variable_name di sini didefinisikan sebagai mata uang (nama apa pun yang dapat didefinisikan oleh pengguna)

  • lookup-table-slug di sini adalah country-flags sebagaimana didefinisikan saat tabel pencarian dibuat

  • item-name adalah negara yang telah dibuat sebelumnya dan ditampilkan di panel kiri

  • object-value adalah AD, yang merupakan nilai yang didefinisikan dalam JSON. Perhatikan bahwa ini juga dapat menjadi variabel

  • key_name adalah local_currency, yang didefinisikan dalam JSON

{% assign currency = "country-flags" | lookup: "country", "AD" %}

{{currency.local_currency}}

Ketika digunakan dalam pembangun template email di blok HTML, sintaks di atas akan merender nilai 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 template email. Di bawah, ini menunjukkan EUR sebagai nilai yang diambil dari tabel pencarian.

Menggunakan tabel pencarian dalam Aliran

Anda dapat membaca tabel pencarian di Alur untuk menggunakan kembali data yang didefinisikan secara terpusat.

Untuk menggunakan tabel pencarian, pertama buat satu sesuai dengan yang dijelaskan di atas.

  1. Navigasikan ke Workflows > Alur

  2. Buat alur awal menggunakan jenis pemicu yang Anda pilih.

Tambahkan langkah Melakukan Pencarian baru ke alur Anda. Klik pada Tambahkan Aksi Baru dan pilih dari grup Tabel Pencarian atau cari menggunakan kemampuan Pencarian di sebelah kanan:



Anda akan ditunjukkan layar konfigurasi di mana Anda dapat memilih tabel yang akan dibaca dan mengonfigurasi bagaimana tepatnya Anda ingin melakukan pencarian ini:



Anda akan melihat tiga komponen yang dapat Anda konfigurasi:

  1. Slug Tabel Pencarian menunjukkan tabel mana yang ingin Anda lihat. Dengan mengklik di bidang ini, Alur akan menunjukkan kepada Anda tabel pencarian yang tersedia:

  1. Pencarian memungkinkan Anda menentukan apa yang akan diambil dan Anda dapat menggunakan berbagai variabel yang tersedia untuk Anda untuk membangun kunci pencarian ini. Operasi default adalah mengembalikan nilai yang Anda cari sebagai nilai tingkat root, tetapi jika Anda ingin membuat objek data - Anda dapat menggunakan kemampuan Sebagai untuk memuatnya ke dalam properti tertentu:

  1. Ganti memungkinkan Anda mengganti variabel dalam hasil pencarian yang dikembalikan dengan nilai statis atau nilai yang didefinisikan di suatu tempat dalam tabel pencarian Anda. Contoh berikut akan mengganti teks {{ MyVariableName }} dalam item apa pun yang dikembalikan dengan aksi Pencarian dengan nilai yang ditemukan di bawah kunci replacements.<locale>.MyVariableName:

Dengan mengklik tombol Uji akan memungkinkan Anda melihat data yang dihasilkan:


Mengonfigurasi tabel mana yang akan dibaca diperlukan dan Anda harus menambahkan setidaknya satu Pencarian aksi. Anda tidak perlu menambahkan aksi Ganti apa pun.


A person is standing at a desk while typing on a laptop.

Platform AI-native lengkap yang dapat berkembang seiring dengan bisnis Anda.

Hubungi penjualan

Mulai gratis

© 2025 Burung

Hubungi Dukungan

A person is standing at a desk while typing on a laptop.

Platform AI-native lengkap yang dapat berkembang seiring dengan bisnis Anda.

Hubungi penjualan

Mulai gratis

© 2025 Burung

Hubungi Dukungan

A person is standing at a desk while typing on a laptop.

Platform AI-native lengkap yang dapat berkembang seiring dengan bisnis Anda.

Hubungi penjualan

Mulai gratis

© 2025 Burung

Hubungi Dukungan