ج

ج

م

م

جداول البحث

كيفية استخدام جداول البحث

نظرة عامة

نظرة عامة

نظرة عامة

جداول البحث هي وسيلة لتخزين البيانات التي يمكنك استخدامها لاحقًا في القوالب والتدفقات والرحلات. قم بإنشاء جداول البحث الخاصة بك من خلال لوحة التحكم، ثم قم بالإشارة الديناميكية إلى البيانات في هذه الجداول

تخزن جداول البحث في Bird البيانات المرجعية وتجمعها في مكان واحد، والتي يمكن الرجوع إليها عند إنشاء قوالب البريد الإلكتروني باستخدام لغة البرمجة السائلة في HTML.

على سبيل المثال، يمكن تخزين وتحديث أعلام كل دولة واختصاراتها أو عملتها مركزيًا كجدول بحث. في كل مرة يتم استخدامها في بناء بريد إلكتروني، يمكن الإشارة إليها من هذا الجدول.

القيود المهمة:

  • يمكن أن يحتوي كل جدول على ما يصل إلى 10 عناصر بيانات منفصلة مخزنة فيه.

  • يمكن أن يحتوي كل عنصر على ما يصل إلى حوالي 300 كيلوبايت من البيانات.

إنشاء جدول بحث

اذهب إلى المحتوى > جداول البحث وانقر على إنشاء.

  • أدخل اسم العرض

  • أدخل رمزًا بدون مسافات



يستخدم الرمز للإشارة إلى هذه الجدولة وقد يحتوي فقط على أحرف أبجدية رقمية. لاحظ أن هذا الرمز يستخدم في الإشارة إلى نموذج البريد الإلكتروني

  • انقر على حفظ



إنشاء عنصر في جدول

انقر على الجدول الذي أنشأته

من القائمة المنبثقة، حدد "عرض"



كل عنصر في جدول هو في الأساس وثيقة JSON. هذا يعني أنه يمكنك بناء هيكل شجري من المفاتيح والقيم، حيث يمكن أن تكون القيم نصوصًا أو أرقامًا أو قيم منطقية أو مصفوفات أو كائنات بنفسها. يمكنك إما إدخال وثيقة JSON مباشرة، باستخدام بناء جملة JSON أو يمكنك استخدام محرر واجهة المستخدم لبناء وثيقة JSON.

محرر JSON

  • بمجرد الحفظ، سترى محرر JSON. يمكنك اختيار إما المحرر النصي أو محرر واجهة المستخدم بناءً على تفضيلك.

  • قم بتحديث جدول البحث باستخدام بنية JSON.

إضافة عنصر

لإضافة عنصر في JSON للتنظيم، انقر على +إضافة عنصر في الجزء الأيسر.

  • اكتب اسمًا في الأعلى

  • انقر على زر إضافة عنصر

  • بمجرد الإنشاء، يمكنك رؤية العنصر الذي تم إنشاؤه في الجزء الأيسر.

اكتب JSON

استخدم تنسيق JSON لتعريف أي هيكل كائن والأزواج الرئيسية-القيمة أدناه:

على سبيل المثال، JSON الذي يعطي اسم الدولة والعملة المحلية بناءً على اختصار الدولة

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

يمكنك أيضًا استخدام محرر واجهة المستخدم لتعريف هيكل JSON.


اذهب إلى المحتوى > جداول البحث وانقر على إنشاء.

  • أدخل اسم العرض

  • أدخل رمزًا بدون مسافات



يستخدم الرمز للإشارة إلى هذه الجدولة وقد يحتوي فقط على أحرف أبجدية رقمية. لاحظ أن هذا الرمز يستخدم في الإشارة إلى نموذج البريد الإلكتروني

  • انقر على حفظ



إنشاء عنصر في جدول

انقر على الجدول الذي أنشأته

من القائمة المنبثقة، حدد "عرض"



كل عنصر في جدول هو في الأساس وثيقة JSON. هذا يعني أنه يمكنك بناء هيكل شجري من المفاتيح والقيم، حيث يمكن أن تكون القيم نصوصًا أو أرقامًا أو قيم منطقية أو مصفوفات أو كائنات بنفسها. يمكنك إما إدخال وثيقة JSON مباشرة، باستخدام بناء جملة JSON أو يمكنك استخدام محرر واجهة المستخدم لبناء وثيقة JSON.

محرر JSON

  • بمجرد الحفظ، سترى محرر JSON. يمكنك اختيار إما المحرر النصي أو محرر واجهة المستخدم بناءً على تفضيلك.

  • قم بتحديث جدول البحث باستخدام بنية JSON.

إضافة عنصر

لإضافة عنصر في JSON للتنظيم، انقر على +إضافة عنصر في الجزء الأيسر.

  • اكتب اسمًا في الأعلى

  • انقر على زر إضافة عنصر

  • بمجرد الإنشاء، يمكنك رؤية العنصر الذي تم إنشاؤه في الجزء الأيسر.

اكتب JSON

استخدم تنسيق JSON لتعريف أي هيكل كائن والأزواج الرئيسية-القيمة أدناه:

على سبيل المثال، JSON الذي يعطي اسم الدولة والعملة المحلية بناءً على اختصار الدولة

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

يمكنك أيضًا استخدام محرر واجهة المستخدم لتعريف هيكل JSON.


اذهب إلى المحتوى > جداول البحث وانقر على إنشاء.

  • أدخل اسم العرض

  • أدخل رمزًا بدون مسافات



يستخدم الرمز للإشارة إلى هذه الجدولة وقد يحتوي فقط على أحرف أبجدية رقمية. لاحظ أن هذا الرمز يستخدم في الإشارة إلى نموذج البريد الإلكتروني

  • انقر على حفظ



إنشاء عنصر في جدول

انقر على الجدول الذي أنشأته

من القائمة المنبثقة، حدد "عرض"



كل عنصر في جدول هو في الأساس وثيقة JSON. هذا يعني أنه يمكنك بناء هيكل شجري من المفاتيح والقيم، حيث يمكن أن تكون القيم نصوصًا أو أرقامًا أو قيم منطقية أو مصفوفات أو كائنات بنفسها. يمكنك إما إدخال وثيقة JSON مباشرة، باستخدام بناء جملة JSON أو يمكنك استخدام محرر واجهة المستخدم لبناء وثيقة JSON.

محرر JSON

  • بمجرد الحفظ، سترى محرر JSON. يمكنك اختيار إما المحرر النصي أو محرر واجهة المستخدم بناءً على تفضيلك.

  • قم بتحديث جدول البحث باستخدام بنية JSON.

إضافة عنصر

لإضافة عنصر في JSON للتنظيم، انقر على +إضافة عنصر في الجزء الأيسر.

  • اكتب اسمًا في الأعلى

  • انقر على زر إضافة عنصر

  • بمجرد الإنشاء، يمكنك رؤية العنصر الذي تم إنشاؤه في الجزء الأيسر.

اكتب JSON

استخدم تنسيق JSON لتعريف أي هيكل كائن والأزواج الرئيسية-القيمة أدناه:

على سبيل المثال، JSON الذي يعطي اسم الدولة والعملة المحلية بناءً على اختصار الدولة

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

يمكنك أيضًا استخدام محرر واجهة المستخدم لتعريف هيكل JSON.


استخدم جدول البحث في قالب البريد الإلكتروني


لاستخدام جدول بحث في قالب بريد إلكتروني، يمكنك إضافة الصيغة السائلة التالية إلى قالب HTML الخاص بك أو إلى عنصر HTML المستخدم في منشئ السحب والإفلات:

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

{{variable_name.key_name}}

هنا،

  • variable_name هو أي اسم يمكنك تعريفه

  • lookup-table-slug هو السلاخ الذي قدمته عند إنشاء جدول البحث

  • item-name هو اسم العنصر الذي قمت بإنشائه

  • object-value هو القيمة التي قدمتها لعنصر JSON

  • key_name هو اسم المفتاح في زوج المفتاح والقيمة المحددة تحت قيمة العنصر

على سبيل المثال،

لإظهار العملة المحلية لدولة محددة، يمكننا استخدام الصيغة أدناه

  • variable_name هنا تم تعريفه كعملة (أي اسم يمكن للمستخدم تحديده)

  • lookup-table-slug هنا هو country-flags كما تم تحديده عند إنشاء جدول البحث

  • item-name هو الدولة كما تم إنشاؤه سابقًا ومعروض في الجزء الأيسر

  • object-value هو AD، الذي هو القيمة المحددة في JSON. لاحظ أن هذا يمكن أن يكون أيضًا متغيرًا

  • key_name هو local_currency، الذي تم تحديده في JSON

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

{{currency.local_currency}}

عند استخدامه في منشئ قالب البريد الإلكتروني في كتلة HTML، ستقوم الصيغة أعلاه بعرض قيمة local_currency كما هو مخزن تحت AD الكائن تحت عنصر الدولة في جدول البحث country-flags

يمكنك الانتقال إلى قسم المعاينة لرؤية قيمة الإخراج معروضة بشكل ديناميكي في قالب البريد الإلكتروني. في الأسفل، يتم عرض EUR كقيمة تم جلبها من جدول البحث.

استخدام جداول البحث في التدفقات

يمكنك قراءة جداول البحث في التدفقات لإعادة استخدام البيانات المعرفة مركزيًا.

لاستخدام جدول البحث، قم أولاً بإنشاء واحد كما هو موضح أعلاه.

  1. انتقل إلى workflows > تدفقات

  2. أنشئ تدفقًا أوليًا باستخدام نوع مشغل من اختيارك.

أضف خطوة جديدة أداء البحث إلى تدفقك. انقر على إضافة إجراء جديد واختره إما من مجموعة جداول البحث أو ابحث عنه باستخدام قدرة البحث على اليمين:



سيتم عرض شاشة التكوين حيث يمكنك تحديد الجدول الذي تريد القراءة منه وتكوين كيفية رغبتك في إجراء هذا البحث بالضبط:



سترى ثلاثة مكونات يمكنك تكوينها:

  1. علامة جدول البحث تشير إلى الجدول الذي تريد النظر إليه. من خلال النقر في هذا الحقل، ستعرض لك التدفقات جداول البحث المتاحة:

  1. البحث يسمح لك بتحديد ما يجب استرجاعه ويمكنك استخدام المتغيرات المختلفة المتاحة لك لبناء مفتاح البحث هذا. العملية الافتراضية هي إعادة القيمة التي يشير إليها نقطة بحثك كقيمة في المستوى الجذري، ولكن إذا كنت ترغب في إنشاء كائن من البيانات - يمكنك استخدام قدرة كـ لتحميلها في خاصية محددة:

  1. استبدال يتيح لك استبدال المتغيرات في نتائج البحث المعادة إما بقيمة ثابتة أو قيمة محددة في مكان ما في جدول بحثك. المثال التالي سيستبدل النص {{ MyVariableName }} في أي عنصر يتم إرجاعه مع إجراء البحث بالقيمة التي يجدها تحت المفتاح replacements.<locale>.MyVariableName:

من خلال النقر على زر الاختبار سيمكنك من رؤية البيانات الناتجة:


تتطلب تكوين الجدول الذي يجب القراءة منه، ويجب عليك إضافة إجراء بحث واحد على الأقل. لست مطالبًا بإضافة أي إجراءات استبدال.


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

المنصة الكاملة المدعومة بالذكاء الاصطناعي التي تتوسع مع أعمالك.

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

المنصة الكاملة المدعومة بالذكاء الاصطناعي التي تتوسع مع أعمالك.

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

المنصة الكاملة المدعومة بالذكاء الاصطناعي التي تتوسع مع أعمالك.