 |
ملخص | يسمح Discourse Workflows للمسؤولين بإنشاء أتمتة متقدمة من خلال منشئ مرئي لأتمتة几乎所有 شيء في مجتمعك. |
 |
دليل التثبيت | هذا المكوّن الإضافي مدمج مع نواة Discourse. لا حاجة لتثبيت المكوّن الإضافي بشكل منفصل. |
Workflows هو منشئ أتمتة مرئي يسمح للمسؤولين بإنشاء أتمتة متعددة الخطوات ومتقدمة باستخدام لوحة سحب وإفلات — لربط المحفِّزات والظروف والإجراءات ونodes التحكم في التدفق لأتمتة几乎所有 شيء على موقع Discourse الخاص بك.
Discourse Workflows متاح في خطط Business أو Enterprise.
المفاهيم الرئيسية
إذا كنت على دراية بأدوات الأتمتة الأخرى، فمن المرجح أن تتعرف على معظم المصطلحات المستخدمة في Workflows:
- سير العمل: أتمتة محفوظة تتكون من nodes متصلة.
- العقدة: خطوة واحدة في سير العمل: المحفِّزات والظروف والإجراءات والتحكم في التدفق / الأدوات.
- المحفِّز: نقطة بدء سير العمل. يمكن أن يكون المحفِّز يدويًا أو يتم تشغيله بواسطة حدث محدد — إنشاء موضوع، أو تشغيل جدول زمني، أو webhook وارد.
- الشرط: عقدة توجيه تقيّم قاعدة وتقسم التدفق إلى فروع. على سبيل المثال، توجه عقدة If التدفق بناءً على تقييم صحيح أو خاطئ.
- الإجراء: عقدة تقوم بشيء محدد — إنشاء منشور، أو منح شارة، أو استدعاء واجهة برمجة تطبيقات خارجية، إلخ.
- العنصر: البيانات التي تتدفق بين العقد. العناصر هي كائنات JSON يمكنك فحصها في سجلات التنفيذ والإشارة إليها باستخدام التعبيرات.
- التعبير: قيمة ديناميكية مكتوبة كـ
{{ ... }}يتم حلها وقت التشغيل وتُستخدم للإشارة إلى البيانات من العقد السابقة أو متغيرات سير العمل أو إعدادات الموقع.
إنشاء سير عمل
لبناء سير عمل:
- انتقل إلى Admin > Plugins > Workflows وانقر على New workflow.
- اسمِّ سير العمل الخاص بك.
- انقر على Add first step واختر المحفِّز الخاص بك.
- استخدم زر + لإضافة عقد إضافية.
- انقر نقرًا مزدوجًا على عقدة لتكوينها. في لوحة التكوين، ستظهر تفاصيل المدخلات للعقدة على الجانب الأيسر وتفاصيل مخرجات العقدة على الجانب الأيمن من الشاشة. قد تحتاج إلى تشغيل سير العمل مرة واحدة قبل رؤية جميع التفاصيل المختلفة.
- عندما تكون جاهزًا للإطلاق، انقر على Publish.
نصائح:
- استخدم الملاحظات اللاصقة، الموجودة في قائمة النقاط الثلاث في الزاوية العلوية اليمنى من المنشئ، لتوثيق ما يفعله سير العمل الخاص بك. لا تؤثر اللاصقات على سير العمل ولكن تجعل القوالب وسير العمل المشترك أسهل للفهم.
- استخدم عقدة السجل أثناء التطوير لإرسال قيم التصحيح إلى سجل التنفيذ دون التأثير على سلوك سير العمل.
- يمكنك تصدير واستيراد سير العمل كـ JSON لمشاركتها مع زملائك أو إعادة إنشاء سير العمل من مواقع أخرى.
التعبيرات والبيانات الديناميكية
تعرض الحقول التي تقبل التعبيرات زرًا {/} في المحرر. انقر عليه لاستعراض البيانات المتاحة من المحفِّز والعقد السابقة وإدراج مرجع.
التعبيرات الشائعة
| التعبير | ما يعيده |
|---|---|
{{ $json.topic.title }} |
عنوان الموضوع من العنصر الحالي |
{{ $json.post.url }} |
عنوان URL للمنشور من العنصر الحالي |
{{ $json.user.username }} |
اسم المستخدم للمستخدم المرتبط بالعنصر الحالي |
{{ $vars.my_variable }} |
قيمة متغير سير العمل المسمى my_variable |
{{ $site_settings.title }} |
عنوان موقعك |
{{ $execution.id }} |
المعرف الفريد للتنفيذ الحالي |
{{ $('Node Name').item.json.property }} |
مخرجات من عقدة سابقة محددة، مع الإشارة إليها باسمها على اللوحة |
القيم الثابتة والديناميكية
تُعامل الحقول التي تبدأ بـ = كتعبيرات. تُعامل الحقول بدون = رئيسي كنص عادي. يتعامل منتقي التعبيرات مع هذا تلقائيًا.
إدارة سير العمل
هناك العديد من الميزات التي تساعدك في إدارة سير العمل الحالي.
التنفيذات
في كل مرة يعمل فيها سير العمل، يسجل Discourse تنفيذًا. انتقل إلى Workflows → Executions لعرض السجل.
يعرض كل تنفيذ التاريخ والوقت الذي اكتمل فيه وحالته:
- مكتمل: تم التشغيل حتى النهاية بدون خطأ.
- خطأ: فشل في عقدة محددة؛ انقر على التنفيذ لعرض الخطأ والبيانات التي سببته.
- جارٍ التشغيل: قيد المعالجة حاليًا.
- في الانتظار: متوقف بسبب عقدة Wait؛ في انتظار استجابة في نموذج أو نافذة منبثقة أو موافقة محادثة؛ أو عقدة Call Workflow في انتظار اكتمال سير عمل فرعي.
- محدود المعدل: تم تخطي سير العمل بسبب تحديد المعدل.
- تم التخطي: تم تشغيل المحفِّز لكن سير العمل لم يكن منشورًا.
يمكنك النقر على زر Show للحصول على نظرة أعمق على تنفيذ سير العمل. هذا يعرض كل خطوة من خطوات سير العمل، والتي يمكنك توسيعها لعرض التفاصيل الدقيقة، ومدة تلك الخطوة.
في أسفل الصفحة، يمكنك رؤية المدة الإجمالية لسير العمل. يمكنك أيضًا Export السجل إذا لزم الأمر لأغراض المشاركة أو استكشاف الأخطاء.
الإعدادات
على علامة التبويب Workflows → Settings، يمكنك:
- تكوين سير عمل خطأ يجب أن يتم تشغيله إذا كانت هناك أي أخطاء عند تشغيل هذا سير العمل. إذا كان لسير العمل محفِّز خطأ، فسيتعامل مع الأخطاء كما هو محدد بواسطة ذلك المحفِّز.
- تعيين المنطقة الزمنية لمحفِّزات الجدول الزمني. سيستخدم سير العمل المنطقة الزمنية للموقع افتراضيًا إذا لم يتم تعيين ذلك.
- حذف سير العمل.
هذا دائم لذا يجب أن تفكر في تصدير سير العمل الخاص بك (متاح في قائمة النقاط الثلاث في الزاوية العلوية اليمنى من منشئ سير العمل) قبل المتابعة.
الإصدارات
في كل مرة تقوم فيها بتحديث سير العمل، سنحفظ الإصدار(ات) السابقة. هذا يجعل من السهل Revert التغييرات التي لم تعمل كما توقعت.
المتغيرات
المتغيرات هي أزواج مفتاح-قيمة مرتبطة بسير عمل واحد. عرّفها في لوحة Variables الخاصة بسير العمل وأشر إليها في أي مكان باستخدام {{ $vars.key_name }}. استخدم المتغيرات لتخزين قيم التكوين (مثل معرف الفئة أو اسم المستخدم للمستلم) التي تريد أن تكون قادرًا على تغييرها دون تعديل رسم سير العمل.
الاعتمادات
بعض العقد — مثل طلب HTTP أو عامل الذكاء الاصطناعي — تحتاج إلى المصادقة مع الخدمات الخارجية. خزّن مفاتيح واجهة برمجة التطبيقات والبيانات السرية في Workflows → Credentials بدلاً من لصقها مباشرة في حقول العقد. يتم تشفير الاعتمادات أثناء التخزين ويمكن إعادة استخدامها عبر سير العمل.
أنواع الاعتمادات المدعومة:
- Basic Auth (اسم المستخدم + كلمة المرور)
- Bearer token
- Header auth (اسم وقيمة رأس مخصص)
جداول البيانات
جداول البيانات هي جداول هيكلية دائمة داخلية في مكوّن Workflows الإضافي. استخدم عقدة Data table لقراءة منها أو الكتابة إليها. تدعم أنواع الأعمدة string و number و boolean و date.
جداول البيانات مفيدة لـ:
- إزالة التكرار — تسجيل المستخدمين أو المواضيع التي قام سير العمل بمعالجتها بالفعل
- الحالة — تتبع ما إذا كان الموضوع في مرحلة معينة من عملية
- البحث — تخزين الخرائط (مثل معرف الموضوع → عضو الموظفين المعين) التي يمكن لسير العمل الاستعلام عنها
التنفيذات
يمكنك عرض جميع تنفيذات جميع سير العمل من علامة التبويب Executions. التنسيق والوظيفة مشابهان جدًا للتنفيذات الخاصة بسير العمل، لكن يعرضان عبر جميع سير العمل لمراقبة أسهل.
القوالب
عند إنشاء سير عمل جديد، يمكنك البدء من قالب بدلاً من لوحة فارغة. القوالب هي سير عمل مبنية مسبقًا لحالات الاستخدام الشائعة — وهي مُعلَّمة بملاحظات لاصقة تشرح كيفية عملها وهي طريقة جيدة لتعلم النظام.
هل ترغب في رؤية المزيد من القوالب؟ سنعمل على توسيع مكتبة القوالب المتاحة بمرور الوقت، لكن يرجى إعلامنا إذا كان هناك قالب ترغب في رؤيته هنا لتسهيل استخدامك لـ Workflows.
يمكنك أيضًا تصدير أي سير عمل كملف JSON لمشاركته مع الآخرين أو استخدامه كنقطة انطلاق خاصة بك.
