Reach

Grow

Manage

Automate

Reach

Grow

Manage

Automate

G

G

M

M

Lookup Tables

Cara menggunakan tabel pencarian

Tinjauan

Tinjauan

Tinjauan

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

Pergi ke Konten > Tabel Pencarian dan klik pada Buat.

  • Masukkan nama tampilan

  • Masukkan slug tanpa spasi



Slug digunakan untuk mereferensikan tabel ini dan hanya boleh berisi karakter alfanumerik. Perhatikan bahwa slug ini digunakan dalam referensi template email

  • Klik Simpan



Membuat item di 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 dari kunci dan nilai, di mana nilai dapat berupa teks, angka, bolean, 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 disimpan, Anda akan melihat editor JSON. Anda dapat memilih baik editor Teks atau UI berdasarkan preferensi Anda.

  • Perbarui tabel pencarian menggunakan struktur JSON.

Menambahkan item

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

  • Ketikkan nama di bagian atas

  • Klik 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, 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 Pencarian dan klik pada Buat.

  • Masukkan nama tampilan

  • Masukkan slug tanpa spasi



Slug digunakan untuk mereferensikan tabel ini dan hanya boleh berisi karakter alfanumerik. Perhatikan bahwa slug ini digunakan dalam referensi template email

  • Klik Simpan



Membuat item di 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 dari kunci dan nilai, di mana nilai dapat berupa teks, angka, bolean, 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 disimpan, Anda akan melihat editor JSON. Anda dapat memilih baik editor Teks atau UI berdasarkan preferensi Anda.

  • Perbarui tabel pencarian menggunakan struktur JSON.

Menambahkan item

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

  • Ketikkan nama di bagian atas

  • Klik 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, 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 Pencarian dan klik pada Buat.

  • Masukkan nama tampilan

  • Masukkan slug tanpa spasi



Slug digunakan untuk mereferensikan tabel ini dan hanya boleh berisi karakter alfanumerik. Perhatikan bahwa slug ini digunakan dalam referensi template email

  • Klik Simpan



Membuat item di 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 dari kunci dan nilai, di mana nilai dapat berupa teks, angka, bolean, 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 disimpan, Anda akan melihat editor JSON. Anda dapat memilih baik editor Teks atau UI berdasarkan preferensi Anda.

  • Perbarui tabel pencarian menggunakan struktur JSON.

Menambahkan item

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

  • Ketikkan nama di bagian atas

  • Klik 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, 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 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:

{% 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 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

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

{{currency.local_currency}}

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.

  1. Arahkan ke Workflows > Flows

  2. 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:

  1. Lookup Table Slug menunjukkan tabel mana yang ingin Anda lihat. Dengan mengklik di bidang ini, Flows akan menunjukkan tabel pencarian yang tersedia:

  1. 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:

  1. 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 kunci replacements.<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.


Mari hubungkan Anda dengan pakar Bird.
Lihat kekuatan penuh dari Bird dalam 30 menit.

Dengan mengirimkan, Anda setuju Bird dapat menghubungi Anda tentang produk dan layanan kami.

Anda dapat berhenti berlangganan kapan saja. Lihat Pernyataan Privasi Bird untuk detail tentang pemrosesan data.

Perusahaan

Newsletter

Tetap terinformasi dengan Bird melalui pembaruan mingguan ke kotak masuk Anda.

Mari hubungkan Anda dengan pakar Bird.
Lihat kekuatan penuh dari Bird dalam 30 menit.

Dengan mengirimkan, Anda setuju Bird dapat menghubungi Anda tentang produk dan layanan kami.

Anda dapat berhenti berlangganan kapan saja. Lihat Pernyataan Privasi Bird untuk detail tentang pemrosesan data.

Perusahaan

Newsletter

Tetap terinformasi dengan Bird melalui pembaruan mingguan ke kotak masuk Anda.

Mari hubungkan Anda dengan pakar Bird.
Lihat kekuatan penuh dari Bird dalam 30 menit.

Dengan mengirimkan, Anda setuju Bird dapat menghubungi Anda tentang produk dan layanan kami.

Anda dapat berhenti berlangganan kapan saja. Lihat Pernyataan Privasi Bird untuk detail tentang pemrosesan data.

R

Reach

G

Grow

M

Manage

A

Automate

Perusahaan

Newsletter

Tetap terinformasi dengan Bird melalui pembaruan mingguan ke kotak masuk Anda.