جداول البحث
كيفية استخدام جداول البحث
تعتبر جداول البحث طريقة لك لتخزين البيانات التي يمكنك استخدامها بعد ذلك في القوالب والتدفقات والرحلات. قم بإنشاء جداول البحث الخاصة بك من خلال لوحة التحكم، ثم قم بالإشارة إلى البيانات ديناميكيًا في هذه الجداول.
جداول البحث في Bird تخزن وتوحد مراجع البيانات، والتي يمكن البحث عنها عند إنشاء قوالب البريد الإلكتروني باستخدام لغة التشكيل السائل في HTML.
على سبيل المثال، يمكن تخزين وتحديث كل من الأعلام، أو الاختصارات أو العملات لكل بلد مركزيًا كجدول بحث. في كل مرة يتم استخدامها في إنشاء بريد إلكتروني، يمكن الإشارة إليها من جدول البحث هذا.
القيود الهامة:
يمكن لكل جدول أن يحتوي على ما يصل إلى 10 عناصر بيانات منفصلة مخزنة فيه.
قد يحتوي كل عنصر على بيانات تصل إلى حوالي 300 كيلوبايت.
إنشاء جدول البحث
استخدم جدول البحث في قالب البريد الإلكتروني
لاستخدام جدول بحث في قالب بريد إلكتروني، يمكنك إضافة بناء الجملة التالي بسائل إلى قالب HTML الخاص بك أو إلى عنصر HTML مستخدم في منشئ السحب والإفلات:
هنا،
variable_name هو أي اسم يمكنك تعريفه
lookup-table-slug هو المعرف الذي قمت بإعطائه عند إنشاء جدول البحث
item-name هو اسم العنصر الذي قمت بإنشائه
object-value هي القيمة التي أعطيتها للعنصر JSON
key_name هو اسم المفتاح في زوج المفتاح-القيمة المحدد تحت عنصر القيمة
على سبيل المثال،
لإظهار العملة المحلية لدولة محددة، يمكننا استخدام بناء الجملة التالي
variable_name هنا هو معرفة كعملة (أي اسم يمكن للمستخدم تحديده)
lookup-table-slug هنا هو country-flags كما تم تعريفه عند إنشاء جدول البحث
item-name هو country كما تم إنشاؤه سابقًا ويظهر في الجزء الأيسر
object-value هو AD، وهي القيمة المحددة في JSON. لاحظ أن هذا يمكن أن يكون أيضًا متغيرًا
key_name هو العملة المحلية، والتي تم تعريفها في JSON
عند استخدامه في منشئ قوالب البريد الإلكتروني في كتلة HTML، ستقوم بناء الجملة أعلاه بعرض قيمة local_currency كما هو مخزن تحت جسم AD ضمن عنصر الدولة في جدول البحث country-flags
يمكنك التبديل إلى قسم المعاينة لرؤية قيمة المخرجات معروضة ديناميكيًا في قالب البريد الإلكتروني. أدناه، يظهر EUR كالقيمة التي تم جلبها من جدول البحث.
استخدام جداول البحث في Flows
يمكنك قراءة جداول البحث في Flows لإعادة استخدام البيانات المحددة مركزيًا.
لاستخدام جدول بحث، يجب أولاً إنشاء واحد كما هو موضح أعلاه.
انتقل إلى Workflows > Flows
أنشئ تدفقًا أوليًا باستخدام نوع الزناد الذي تختاره.
أضف خطوة Perform Lookup جديدة إلى تدفقك. انقر على Add New Action واخترها إما من مجموعة Lookup Tables أو ابحث عنها باستخدام خاصية البحث على اليمين:
سيتم عرض شاشة تكوين حيث يمكنك اختيار الجدول للقراءة منه وتكوين كيفية أداء هذا البحث:
سترى ثلاثة مكونات يمكنك تكوينها:
Lookup Table Slug يشير إلى الجدول الذي تريد النظر إليه. عبر النقر في هذا الحقل، سيعرض لك Flows جداول البحث المتاحة:
Lookup يتيح لك تحديد ما يجب استعادته ويمكنك استخدام المتغيرات المتنوعة المتاحة لك لبناء مفتاح البحث هذا. العملية الافتراضية هي إرجاع القيمة التي يشير إليها البحث كنقطة مستوى الجذر، ولكن إذا كنت تريد إنشاء كائن من البيانات - يمكنك استخدام خاصية As لتحميلها في خاصية محددة:
Replace يتيح لك استبدال المتغيرات في نتائج البحث المستردة إما بقيمة ثابتة أو بقيمة محددة في مكان ما في جدول البحث. المثال التالي سيستبدل النص
{{ MyVariableName }}في أي عنصر تم استرداده بعملية Lookup بالقيمة التي يجدها تحت المفتاحreplacements.<locale>.MyVariableName:
بمجرد النقر على زر الاختبار، ستتمكن من رؤية البيانات الناتجة:
تكوين الجدول الذي يتم القراءة منه مطلوب ويجب إضافة ما لا يقل عن إجراء Lookup واحد. لست ملزمًا بإضافة أي إجراءات Replace.
