logologo
البدء
الدليل
التطوير
الإضافات
API
English
简体中文
日本語
한국어
Deutsch
Français
Español
Português
Русский
Italiano
Türkçe
Українська
Tiếng Việt
Bahasa Indonesia
ไทย
Polski
Nederlands
Čeština
العربية
עברית
हिन्दी
Svenska
البدء
الدليل
التطوير
الإضافات
API
logologo
سير العمل
نظرة عامة
بدء سريع

المشغلات

نظرة عامة
أحداث جدول البيانات
المهام المجدولة
حدث ما قبل الإجراء
حدث ما بعد الإجراء
حدث الإجراء المخصص
الموافقة
Webhook

العقدة

نظرة عامة

AI

LLM

التحكم في التدفق

الشرط
تفرع متعدد الشروط
التكرار
المتغيرات
تفرع متوازي
استدعاء سير العمل
مخرجات التدفق
ربط متغيرات JSON
تأخير
إنهاء

حساب

حساب
حساب التاريخ
حساب JSON

عمليات البيانات

إضافة بيانات
تحديث البيانات
استعلام البيانات
حذف البيانات
عمليات SQL

معالجة يدوية

معالجة يدوية
الموافقة
نسخة كربونية

أنواع ممتدة

طلب HTTP
سكريبت JavaScript
إشعار
إرسال بريد إلكتروني
استجابة
رسالة الاستجابة
المتغيرات
سجل التنفيذ
إدارة الإصدارات
خيارات متقدمة

تطوير الإضافات

نظرة عامة
توسيع أنواع المشغلات
توسيع أنواع العقد
مرجع API
Previous Pageعمليات SQL
Next Pageالموافقة
إشعار الترجمة بالذكاء الاصطناعي

تمت ترجمة هذه الوثائق تلقائيًا بواسطة الذكاء الاصطناعي.

#المعالجة اليدوية

This feature is provided by the plugin «سير العمل: عقدة المعالجة اليدوية»

#مقدمة

عندما لا يمكن أتمتة عملية الأعمال بالكامل لاتخاذ القرارات، يمكن استخدام عقدة يدوية لتفويض جزء من سلطة اتخاذ القرار إلى شخص.

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

#التثبيت

إضافة مدمجة، لا تتطلب تثبيتًا.

#إنشاء عقدة

في واجهة إعدادات سير العمل، انقر على زر علامة الجمع ("+") في سير العمل لإضافة عقدة "معالجة يدوية":

إنشاء عقدة يدوية

#إعداد العقدة

#المسؤول

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

حدد مستخدمًا، أو اختر المفتاح الأساسي أو المفتاح الخارجي لبيانات المستخدم من السياق عبر متغير.

عقدة يدوية_إعداد_المسؤول_تحديد متغير

ملاحظة

حاليًا، لا يدعم خيار المسؤول في العقد اليدوية التعامل مع عدة مستخدمين. سيتم دعم ذلك في إصدار مستقبلي.

#إعداد واجهة المستخدم

يُعد إعداد واجهة مهمة "قيد الانتظار" الجزء الأساسي من العقدة اليدوية. يمكنك النقر على زر "إعداد واجهة المستخدم" لفتح نافذة منبثقة للإعداد المستقل، والتي يمكن إعدادها بطريقة "ما تراه هو ما تحصل عليه" (WYSIWYG)، تمامًا مثل أي صفحة عادية:

عقدة يدوية_إعداد العقدة_إعداد الواجهة

#علامات التبويب

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

#الكتل

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

#كتلة البيانات

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

عقدة يدوية_إعداد العقدة_إعداد الواجهة_كتلة البيانات_المشغل

كتل بيانات العقدة متشابهة؛ يمكنك تحديد نتيجة البيانات من عقدة سابقة لعرضها كتفاصيل. على سبيل المثال، يمكن أن تكون نتيجة عقدة حساب سابقة بمثابة معلومات مرجعية سياقية لمهمة المسؤول "قيد الانتظار":

عقدة يدوية_إعداد العقدة_إعداد الواجهة_كتلة البيانات_بيانات العقدة

ملاحظة

نظرًا لأن سير العمل يكون في حالة غير منفذة أثناء إعداد الواجهة، فلا يتم عرض أي بيانات محددة في كتل البيانات. لا يمكن رؤية البيانات ذات الصلة بمثيل سير عمل معين إلا في واجهة النافذة المنبثقة لمهام "قيد الانتظار" بعد تشغيل سير العمل وتنفيذه.

#كتلة النموذج

يجب إعداد كتلة نموذج واحدة على الأقل في واجهة مهام "قيد الانتظار" للتعامل مع القرار النهائي بشأن ما إذا كان سير العمل يجب أن يستمر. عدم إعداد نموذج سيمنع سير العمل من المتابعة بعد توقفه. هناك ثلاثة أنواع من كتل النماذج:

  • نموذج مخصص
  • نموذج إنشاء سجل
  • نموذج تحديث سجل

عقدة يدوية_إعداد العقدة_إعداد الواجهة_أنواع النماذج

تتطلب نماذج إنشاء السجلات ونماذج تحديث السجلات تحديد مجموعة بيانات أساسية. بعد إرسال المستخدم لمهمة "قيد الانتظار"، ستُستخدم القيم الموجودة في النموذج لإنشاء أو تحديث البيانات في مجموعة البيانات المحددة. أما النموذج المخصص فيتيح لك تعريف نموذج مؤقت غير مرتبط بمجموعة بيانات، ويمكن استخدام قيم الحقول التي يرسلها المستخدم في العقد اللاحقة.

يمكن إعداد أزرار إرسال النموذج بثلاثة أنواع، وهي:

  • إرسال ومتابعة سير العمل
  • إرسال وإنهاء سير العمل
  • حفظ قيم النموذج فقط

عقدة يدوية_إعداد العقدة_إعداد الواجهة_أزرار النموذج

تمثل الأزرار الثلاثة ثلاث حالات للعقدة في عملية سير العمل. بعد الإرسال، تتغير حالة العقدة إلى "مكتملة" أو "مرفوضة" أو تبقى في حالة "معلقة". يجب إعداد أحد الخيارين الأولين على الأقل في النموذج لتحديد مسار المعالجة اللاحق لسير العمل بأكمله.

على زر "متابعة سير العمل"، يمكنك إعداد تعيينات لحقول النموذج:

عقدة يدوية_إعداد العقدة_إعداد الواجهة_زر النموذج_تعيين قيم النموذج

عقدة يدوية_إعداد العقدة_إعداد الواجهة_زر النموذج_نافذة تعيين قيم النموذج المنبثقة

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

#كتلة مهام "قيد الانتظار"

بالنسبة للمعالجة اليدوية، تحتاج أيضًا إلى إضافة قائمة مهام "قيد الانتظار" إلى صفحة لعرض المهام. يتيح هذا للموظفين المعنيين الوصول إلى معالجة المهام المحددة للعقدة اليدوية من خلال هذه القائمة.

#إضافة كتلة

يمكنك تحديد "مهام سير العمل قيد الانتظار" من الكتل الموجودة في الصفحة لإضافة كتلة قائمة مهام "قيد الانتظار":

عقدة يدوية_إضافة كتلة مهام قيد الانتظار

مثال على كتلة قائمة مهام "قيد الانتظار":

عقدة يدوية_قائمة مهام قيد الانتظار

#تفاصيل مهام "قيد الانتظار"

بعد ذلك، يمكن للموظفين المعنيين النقر على مهمة "قيد الانتظار" المقابلة لفتح النافذة المنبثقة للمهمة وإجراء المعالجة اليدوية:

عقدة يدوية_تفاصيل مهام قيد الانتظار

#مثال

#مراجعة المقالات

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

أنشئ سير عمل يتم تشغيله بواسطة "إنشاء مقال" وأضف عقدة يدوية:

عقدة يدوية_مثال_مراجعة المقالات_تنظيم سير العمل

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

عقدة يدوية_مثال_مراجعة المقالات_إعداد العقدة_كتلة التفاصيل

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

عقدة يدوية_مثال_مراجعة المقالات_إعداد العقدة_النموذج والإجراءات

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

عقدة يدوية_مثال_مراجعة المقالات_إعداد العقدة_حقول النموذج

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

عقدة يدوية_مثال_مراجعة المقالات_إعداد العقدة_تعيين النموذج

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

عقدة يدوية_مثال_مراجعة المقالات_إعداد العقدة_شرط النموذج

أخيرًا، يمكنك تعديل عناوين كل كتلة، ونص الأزرار ذات الصلة، والنص التوجيهي لحقول النموذج لجعل الواجهة أكثر سهولة في الاستخدام:

عقدة يدوية_مثال_مراجعة المقالات_إعداد العقدة_النموذج النهائي

أغلق لوحة الإعدادات، وانقر على زر الإرسال لحفظ إعدادات العقدة. بذلك يكون سير العمل قد اكتمل إعداده. بعد تمكين سير العمل هذا، سيتم تشغيله تلقائيًا عند إنشاء مقال جديد. يمكن للمسؤول رؤية أن سير العمل هذا يحتاج إلى معالجة من قائمة مهام "قيد الانتظار". عند النقر للعرض، يمكن رؤية تفاصيل مهمة "قيد الانتظار":

عقدة يدوية_مثال_مراجعة المقالات_قائمة مهام قيد الانتظار
عقدة يدوية_مثال_مراجعة المقالات_تفاصيل مهام قيد الانتظار

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

#الموافقة على الإجازات

لن نفترض أن موظفًا يحتاج إلى طلب إجازة، ويجب أن يوافق عليها المشرف لكي تصبح سارية المفعول، ويجب خصم بيانات إجازة الموظف المقابلة. وبغض النظر عن الموافقة أو الرفض، سيتم استخدام عقدة طلب HTTP لاستدعاء واجهة برمجة تطبيقات الرسائل القصيرة لإرسال رسالة إشعار ذات صلة إلى الموظف (انظر قسم طلب HTTP). يمكن تنفيذ هذا السيناريو باستخدام نموذج مخصص في عقدة يدوية.

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

عقدة يدوية_مثال_الموافقة على الإجازات_إعداد العقدة

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

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

عقدة يدوية_مثال_الموافقة على الإجازات_تنظيم سير العمل

يتم إعداد الشرط في عقدة الشرط على النحو التالي: "عقدة يدوية / بيانات النموذج المخصص / قيمة حقل الموافقة هي 'موافق عليها'":

عقدة يدوية_مثال_الموافقة على الإجازات_شرط

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