انتقل إلى المحتوى الرئيسي

عقدة notification

عقدة notification ترسل إشعارًا وفقًا لقالب الحدث المختار من وحدة Events. يتم أخذ القنوات واللغات والمستلمين من إعدادات القالب، بينما تمرر العقدة قيم المتغيرات إلى القالب.

توجد العقدة في اللوحة اليسرى بجانب العقد telegram و whatsapp. لديها مدخل واحد ومخرج واحد.

إعدادات عقدة notification​

1. الاسم​

حقل لتحديد اسم العقدة.
يظهر الاسم في مساحة العمل ويساعد في التعرف بسهولة على العقدة.
إذا تركت فارغة، ستسمى العقدة notification.

مثال:

  • اسم العقدة: send order code

2. قالب الحدث​

قسم يتم فيه اختيار قالب الحدث وتحديد البيانات له.

القالب​

قائمة منسدلة بالقوالب. تظهر فيها الأحداث من وحدة Events التي تم وضع علامة عليها كقوالب للتدفق (علامة Use as a template for workflow في إعدادات الحدث)، حتى 100 قالب. يتم أخذ الاسم باللغة الحالية للواجهة.

حتى يتم اختيار قالب، يظهر في الحقل — select template —. يمكن إعادة تعيين الاختيار باستخدام علامة X في الحقل.

معلومات

عند تغيير القالب، يتم مسح قيم المتغيرات والمسار إلى المستلمين — يجب ملؤها مرة أخرى.

معلومات القالب​

بعد الاختيار، تظهر بطاقة القالب أسفل القائمة:

  • اسم القالب — اسم القالب.
  • القنوات — قنوات الإرسال المضمنة في القالب: Email، Push، WebSocket.
  • المستلمون — لمن يرسل القالب الإشعار.
  • اللغات — اللغات التي تم ملء القالب بها.

القيم الممكنة لـ المستلمون:

القيمةمن سيستلم الإشعار
جميع المستخدمينجميع المستخدمين
المشتركينالمشتركين
مجموعة المستخدمينمجموعة من المستخدمين
المستخدم المستهدفالمستخدم المستهدف
المسجلينالمسجلين
الجميعالجميع
معرفات المستخدمين من التدفقالمستخدمون، معرفاتهم تمررها التدفق
عناوين البريد الإلكتروني من التدفقعناوين البريد الإلكتروني التي تمررها التدفق

إذا كان هناك خطأ ما في القالب المختار، تحذر النموذج من ذلك:

  • فشل في تحميل قائمة القوالب. — لم يتم تحميل قائمة القوالب.
  • القالب غير موجود. قد يكون قد تم حذفه. — القالب غير موجود، ربما تم حذفه.
  • الحدث المختار لم يعد قالبًا. — تم إزالة علامة القالب عن الحدث المختار.

3. المستلمون​

يظهر هذا القسم فقط إذا كان في القالب المستلمون — معرفات المستخدمين من التدفق أو عناوين البريد الإلكتروني من التدفق. يحتوي على حقل واحد مع مسار إلى مصفوفة المستلمين في رسالة التدفق، بتنسيق Mustache:

  • المسار إلى معرفات المستخدمين في الرسالة — لـ معرفات المستخدمين من التدفق، تلميح في الحقل: {{msg.payload.userIds}};
  • المسار إلى عناوين البريد الإلكتروني في الرسالة — لـ عناوين البريد الإلكتروني من التدفق، تلميح في الحقل: {{msg.payload.emails}}.

مثال:

{{msg.payload.userIds}}

4. متغيرات القالب​

يظهر هذا القسم إذا كان في القالب متغيرات مخصصة. لكل متغير — حقل منفصل، مكتوب عليه اسم المتغير (أو علامته إذا لم يكن هناك اسم).

القيمة — تعبير Mustache أو سلسلة عادية.

مثال:

{{msg.payload.code}}

إذا تمت إزالة المتغير من القالب، بينما تم حفظ قيمة له في العقدة، يظهر النموذج تحذيرًا هذه المتغيرات لم تعد مستخدمة في القالب: مع قائمة بهذه المتغيرات وقيمها.

المعلمات في مخطط JSON​

في مخطط JSON للتدفق، يتم تخزين إعدادات العقدة على النحو التالي:

  • name (string) - اسم العقدة
  • eventId (number | null) - معرف القالب الحدث المختار
  • variables (object) - قيم متغيرات القالب: المفتاح — علامة المتغير، القيمة — تعبير Mustache أو سلسلة
  • recipientsPath (string) - المسار إلى مصفوفة المستلمين في الرسالة

مثال على الاستخدام​

مثال 1: إشعار للمستخدمين الذين تم تمريرهم عبر التدفق​

المهمة:
إرسال رمز الطلب لعدة مستخدمين، معرفاتهم تحسبها التدفق.

التدفق:

[inject] ---> [function] ---> [notification]

كود العقدة function:

msg.payload = {
  userIds: [12, 15],
  code: "A-1024"
};
return msg;

إعدادات العقدة notification:

  • القالب: قالب الحدث الذي يكون فيه المستلمون — معرفات المستخدمين من التدفق، وفي النص يوجد متغير بعلامة code
  • المسار إلى معرفات المستخدمين في الرسالة: {{msg.payload.userIds}}
  • حقل المتغير code في متغيرات القالب: {{msg.payload.code}}

النتيجة:
سيتم إرسال الإشعار إلى المستخدمين ذوي المعرفات 12 و 15 عبر القنوات المضمنة في القالب، وبدلاً من المتغير code سيتم استبداله بـ A-1024.