استخدام متغيرات سير العمل وعلامات الدمج في الرسائل والشروط

ما هذه الميزة؟

متغير سير العمل هو جزء بيانات ذو اسم، يُلتقط أو يُحسب أو يُنشأ في نقطة ما من سير العمل، ثم يصبح متاحًا لكل عقدة تأتي بعده. عندما يعبئ مقدم الطلب نموذجًا، يصبح كل حقل متغيرًا. وعندما يعمل وكيل الذكاء الاصطناعي، تصبح مخرجاته متغيرًا. وعند اكتمال مهمة، يصبح القرار المتخذ وأي تعليقات متغيرات. يُشار إلى المتغيرات بصيغة علامة الدمج: قوسان معقوفان مزدوجان حول اسم المتغير، مثل {{requester_name}} أو {{due_date}}.

تعمل علامات الدمج في ثلاثة مواضع:

1. موضوعات الرسائل ونصوصها — لتخصيص رسائل الإشعار بالبيانات الفعلية.
2. تعبيرات الشروط — لتوجيه سير العمل بناءً على قيمة، مثل الموافقة تلقائيًا على المبالغ الصغيرة وتصعيد الكبيرة.
3. حقول إعداد العُقد — في أي حقل يقبل متغيرًا، مثل عناوين مستلمي البريد والمسند إليه في المهمة ومدة التأخير.

لماذا تفيدك؟ وما مزاياها الأساسية؟

• رسائل مخصصة تلقائيًا. تخرج كل رسالة باسم مقدم الطلب الحقيقي وعنوان المشروع الفعلي والموعد الصحيح؛ من دون تحرير يدوي أو عبارات عامة مثل «عزيزي المستخدم».
• تنتقل البيانات عبر العملية كلها. تظل القيمة الملتقطة في الخطوة الأولى متاحة في الخطوة العاشرة، فلا تحتاج إلى البحث مجددًا عن معلومات جُمعت بالفعل.
• تستخدم قرارات التوجيه بيانات فعلية. تستطيع عُقد الشروط إنشاء الفروع بناءً على تجاوز {{purchase_amount}} حدًا معينًا أو مطابقة {{department}} فريقًا محددًا أو أي قيمة ملتقطة أخرى، ما يجعل سير العمل ديناميكيًا بحق.
• نسخ بنقرة واحدة من لوحة المتغيرات. لا تحتاج إلى حفظ أسماء المتغيرات أو كتابتها. تسرد اللوحة كل متغير مع عقدة مصدره ونوعه، وتنسخ علامة الدمج بنقرة واحدة.
• سحب المتغيرات وإفلاتها في المحررات. يمكنك سحب متغير مباشرة من اللوحة إلى حقل في منشئ الشروط أو محرر البريد.
• سلامة الأنواع. لكل متغير نوع معلن، مثل نص أو رقم أو قيمة منطقية أو تاريخ أو ملف. يستخدم منشئ الشروط النوع لعرض عوامل المقارنة المناسبة فقط، ما يمنع أخطاء المنطق.

قبل أن تبدأ

• تنشئ المتغيرات عُقد تأتي قبل العقدة التي تريد استخدامها فيها على رسم سير العمل. لا يكون متغير صادر من عقدة لاحقة متاحًا بعد.
• الصلاحية المطلوبة: إدارة عمليات سير العمل لضبط عُقدها.
• لعرض لوحة المتغيرات، يجب أن تكون في المصمم المرئي وأن توجد عقدة سابقة مضبوطة واحدة على الأقل.

مكان العثور عليها: اختر رمز لوحة المتغيرات، وهو الزر {}، من شريط أدوات المصمم المرئي. تنفتح اللوحة من يمين مساحة التصميم.

طريقة الاستخدام خطوة بخطوة

استكشاف المتغيرات المتاحة

1. افتح سير عمل في المصمم المرئي.

2. اختر رمز لوحة المتغيرات من شريط الأدوات، أو استخدم اختصار لوحة المفاتيح إن ظهر. تنزلق اللوحة من اليمين.

3. تُجمع المتغيرات بحسب العقدة التي صدرت منها. تعرض كل مجموعة رمز العقدة وتسميتها، مثل «عقدة البدء» أو «مهمة: مراجعة العقد» أو «وكيل الذكاء الاصطناعي: تصنيف الطلب».

4. يعرض كل صف متغير داخل المجموعة:

   • علامة الدمج بخط ثابت العرض، مثل {{form_project_name}}؛
   • شارة النوع: النص بالرمادي، والرقم بالكهرماني، والقيمة المنطقية بالأخضر، والتاريخ بالأزرق السماوي، والملف بالوردي؛
   • شارة المصدر، مثل نموذج أو مهمة أو ذكاء اصطناعي أو Python.

5. لنسخ علامة دمج، انقر في أي موضع من صف المتغير. يؤكد مؤشر قصير باسم تم النسخ أن العلامة أصبحت في الحافظة وجاهزة للصق.

6. لسحب متغير إلى حقل متوافق، أمسك مقبض السحب ذي النقاط الست الذي يظهر يسار الصف عند المرور عليه، واسحبه إلى الحقل الهدف.

استخدام علامات الدمج في موضوع البريد

7. افتح مربع خصائص البريد الإلكتروني بالنقر المزدوج على عقدة بريد إلكتروني.
8. انقر داخل حقل موضوع البريد الإلكتروني.
9. افتح لوحة المتغيرات في المصمم الأساسي وانسخ العلامة المطلوبة، أو اكتبها يدويًا بصيغة {{variable_name}}.
10. الصق العلامة في الموضوع. مثال: إجراء مطلوب: {{task_title}} يستحق في {{due_date}}

يقبل سطر الموضوع أيضًا نصًا عاديًا ممزوجًا بأي عدد من علامات الدمج. تُستبدل العلامات بقيمها الفعلية عند الإرسال.

استخدام علامات الدمج في نص البريد

11. افتح محرر البريد Unlayer في قسم النص من علامة البريد الإلكتروني.
12. انقر داخل أي كتلة نص في لوحة المحرر.
13. ضع المؤشر في الموضع الذي تريد أن تظهر فيه قيمة المتغير.
14. نفّذ أحد الخيارين:
    • اختر زر علامات الدمج ذي الرمز {} في شريط أدوات Unlayer. تظهر قائمة منظمة ضمن فئات: أساسي، ومهمة، وروابط الإجراءات، وحقول النموذج، ومتغيرات المهمة. اختر أي عنصر لإدراجه.
    • أو انسخ العلامة من لوحة المتغيرات في المصمم الأساسي والصقها.
15. تظهر العلامة في النص بصيغة {{variable_name}}. تستبدلها المنصة بالقيمة الفعلية وقت الإرسال.

علامات دمج معرفة مسبقًا ومتاحة دائمًا في البريد

إلى جانب ما سبق، يصبح كل حقل نموذج يُرسل في خطوة المشغّل علامة دمج تحمل الاسم الداخلي للحقل مع بادئة، مثل {{form_contract_value}} أو {{form_department}}.

استخدام المتغيرات في تعبيرات الشروط

16. افتح عقدة شرط أو عقدة فرع شرطي بالنقر المزدوج عليها في اللوحة.
17. ابحث في منشئ الشروط عن حقل القيمة للقاعدة، أي الجانب الأيسر من المقارنة.
18. ابدأ بكتابة {{ للإشارة إلى متغير، ثم اكتب اسمه. يحله منشئ الشروط وقت التشغيل.
19. اضبط عامل التشغيل للقاعدة. راجع جدول العوامل أدناه؛ تتطابق العوامل المتاحة تلقائيًا مع نوع المتغير.
20. اضبط قيمة المقارنة في الجانب الأيمن، إما قيمة ثابتة أو {{variable_name}} آخر.

مثال: {{purchase_amount}} أكبر من 10000

للتفاصيل الكاملة عن عقدة الشرط ومنشئ التعبيرات، راجع منطق التوجيه: شروط إذا/وإلا والفروع الشرطية ومنشئ التعبيرات.

استخدام المتغيرات في حقول العُقد الأخرى

تقبل حقول كثيرة في إعداد العُقد علامات الدمج كلما أفادت القيمة الديناميكية:

شرح الخيارات والإعدادات

عناصر التحكم في لوحة المتغيرات

قواعد صيغة علامات الدمج

أنواع المتغيرات وعوامل التشغيل المتوافقة

نصائح وأفضل الممارسات

• انسخ من لوحة المتغيرات ولا تكتب من الذاكرة. يجب أن تطابق أسماء المتغيرات تمامًا، بما فيها الشرطات السفلية والبادئات وحالة الأحرف. يؤدي خطأ واحد إلى إرسال العلامة حرفيًا في البريد.
• تحقق من شارة النوع قبل كتابة شرط. لن تعمل مقارنة متغير نصي بعامل رقمي كما تتوقع. توضح الشارة نوع المتغير.
• استخدم روابط الإجراءات فقط مع الموافقين الخارجيين. تنشئ علامات {{complete_link}} و{{reject_link}} و{{hold_link}} روابط آمنة تستخدم مرة واحدة. ضعها في الرسائل المرسلة لمن سيتصرف دون تسجيل الدخول. راجع بوابة الموافق الخارجي.
• قاعدة العُقد السابقة فقط. لا يتوفر في عقدة بريد متغير صادر من عقدة مهمة تأتي بعدها في الرسم. ضع العُقد المنتجة للبيانات قبل العُقد المستهلكة لها.
• المتغيرات العامة متاحة دائمًا. تحتوي مجموعة عام في لوحة المتغيرات، إن وجدت، على قيم متاحة في أي موضع بغض النظر عن ترتيب العُقد، مثل بيانات الإرسال الوصفية.
• اختبر ببيانات واقعية. قبل تنشيط سير العمل، نفّذ إرسالًا تجريبيًا بقيم نموذج ممثلة وتحقق من أن الرسائل تعرض القيم المحلولة المتوقعة. راجع تشغيل سير العمل.

الأسئلة الشائعة

س: تظهر علامة الدمج حرفيًا في بريدي، مثل {{task_title}} بدلًا من اسم المهمة الفعلي. لماذا؟ الأسباب الأرجح: (1) خطأ إملائي في العلامة؛ انسخها من لوحة المتغيرات. (2) لا يوجد المتغير بعد عند إرسال البريد لأن عقدة مصدره تأتي بعد عقدة البريد. (3) كان المتغير اختياريًا وتركه مقدم الطلب فارغًا، فنتجت سلسلة فارغة. راجع لوحة المتغيرات للتأكد من الاسم وترتيب العُقد.

س: هل يمكنني استخدام متغير لتحديد من يتلقى رسالة؟ نعم. أدخل في علامة المستلمون لعقدة البريد علامة مثل {{requester_email}} في حقل عناوين المستلمين. تحلها المنصة وقت التشغيل وترسل إلى العنوان الذي تحمله القيمة.

س: كيف أعرف اسم المتغير الموافق لحقل نموذج معين؟ افتح لوحة المتغيرات ووسّع مجموعة عقدة البدء أو المشغّل. يظهر كل حقل نموذج كمتغير، ويستخدم اسم العلامة الاسم الداخلي للحقل مسبوقًا بـform_. عند الشك، اسأل مصمم سير العمل أو راجع إعداد الحقل في خصائص عقدة المشغّل.

س: هل يمكن استخدام المتغيرات في موضوع البريد؟ نعم. يدعم حقل الموضوع صيغة {{variable_name}} نفسها التي يدعمها النص. مثال: تمت الموافقة على طلبك «{{form_request_title}}».

س: ماذا يحدث إذا كانت قيمة المتغير null أو تُرك الحقل فارغًا؟ تُستبدل العلامة بسلسلة فارغة وقت الإرسال. لتجنب الفراغات، اجعل حقول النموذج مطلوبة عندما تكون القيمة مهمة، أو استخدم إخفاء الحقول الفارغة في علامة متقدم بعقدة البريد.

س: هل يمكن استخدام متغير في عقدة إيقاف مؤقت للانتظار حتى تاريخ من النموذج؟ نعم. اختر وضع حتى تاريخ المتغير في عقدة الإيقاف المؤقت/التأخير، وحدد متغير التاريخ من القائمة. راجع عقدة الإيقاف المؤقت/التأخير.