نماذج المهام: جمع مدخلات منظمة داخل مهمة بشرية
ما هي؟
يجمع نموذج المهمة (Task Form) بين جمع البيانات المنظمة واتخاذ قرار بشري في عقدة مهمة واحدة. يفتح المكلّف المهمة ويكمل الحقول، ثم يختار إجراءً مسموحًا به (Allowed Action)، مثل اعتماد أو طلب تعديلات أو تصعيد. يتحقق ذلك الإجراء من النموذج ويرسله، ويسجل القرار، ويختار مسار سير العمل الصادر.
لا يوجد زر إرسال (Submit) منفصل؛ فالإجراءات المسموح بها هي أزرار النموذج.
تختلف نماذج المهام عن نموذج البداية اليدوية:
| نموذج البداية اليدوية | نموذج المهمة |
|---|---|
| يجمع المعلومات عند بدء سير العمل. | يجمع المعلومات بينما يكون سير العمل قيد التنفيذ. |
| يبدأ مثيل سير عمل جديدًا. | يكمل مهمة بشرية معلّقة ويتابع المثيل نفسه. |
| يستخدم إجراء البدء أو التشغيل الخاص به. | يستخدم الإجراءات المسموح بها في عقدة المهمة كأزرار للإرسال والتوجيه. |
أهميتها
- تسليم متكامل واحد — يقدّم المكلّف القيم والملفات والتعليق والقرار في شاشة المهمة نفسها.
- بيانات منظمة لسير العمل — تستطيع عُقد البريد والمستندات والتقرير ووكيل الذكاء الاصطناعي والتوجيه اللاحقة استخدام القيم المرسلة بأسماء حقولها.
- توجيه قائم على الإجراء — يمكن أن يقود كل زر إلى فرع مختلف من دون إضافة خطوة إرسال مصطنعة.
- عمل داخلي وخارجي متسق — يُستخدم مخطط النموذج نفسه في مدير مهام سير العمل للمستخدم المسجّل دخوله وفي رابط مهمة خارجي صالح.
- نتائج قابلة للتتبع — يبقى الإجراء المحدد وقيم النموذج مرتبطين بنتيجة المهمة ومثيل سير العمل.
- تصميم بمساعدة الذكاء الاصطناعي — يفهم منشئ الذكاء الاصطناعي نماذج المهام، ويمكنه اقتراح الحقول والإجراءات والفروع من وصف بلغة طبيعية.
قبل أن تبدأ
- افتح سير العمل في وضع التحرير داخل منشئ التدفقات.
- أضف عقدة مهمة (Task) أو اختر واحدة.
- حدّد من سيتلقى المهمة وما نتائج العمل المطلوبة منها.
- حدّد القيم التي يجب أن تستخدمها العُقد اللاحقة؛ إذ تحدد هذه القيم اسم المتغير (Variable name) الثابت لكل حقل.
إعداد نموذج مهمة
1. اختيار تصنيف النموذج
- انقر عقدة المهمة نقرًا مزدوجًا لفتح خصائص المهمة (Task Properties).
- أكمل الإعدادات المطلوبة في المعلومات الأساسية (Basic Info)، بما فيها عنوان المهمة والمكلّف.
- افتح علامة النموذج (Form).
- اضبط تصنيف المهمة (Task category) على نموذج (Form).
تعرض اللوحة الآن حقول نموذج المهمة (Task form fields). وإذا غيّرت التصنيف لاحقًا إلى قيمة غير نموذج، يطلب RAPTIX تأكيدك قبل إزالة الحقول المعدّة.
2. إضافة الحقول
- اختر إضافة حقل (Add field).
- أدخل اسم متغير (Variable name)، وهو اسم الإخراج الثابت الذي تستخدمه العُقد اللاحقة.
- أدخل التسمية الظاهرة للمستخدم (Label shown to user).
- اختر نوع الحقل (Field type).
- افتح مزيد من الخيارات (More options) عندما تحتاج إلى نص مساعدة أو عنصر نائب أو قيمة افتراضية أو اختيارات أو بيانات وصفية للمستند.
أنواع الحقول المدعومة:
| نوع الحقل | استخدامه |
|---|---|
| نص (Text) | الأسماء والمراجع والملاحظات والتفسيرات وغيرها من النصوص. |
| رقم (Number) | المبالغ والأعداد والدرجات وغيرها من القيم الرقمية. |
| تاريخ (Date) | تاريخ تقويمي. |
| قائمة اختيار منسدلة (Select / dropdown) | اختيار واحد من قائمة مضبوطة. |
| مربع تحديد (Checkbox) | تأكيد صحيح أو خطأ. يجب تحديد مربع التحديد المطلوب. |
| مجموعة مربعات تحديد (Checkbox group) | اختيار عنصر واحد أو أكثر من قائمة مضبوطة. |
| رفع ملف (File upload) | ملف يُرفع بأمان إلى سجل سير العمل. |
أضف خيارًا واحدًا على الأقل للقائمة المنسدلة أو مجموعة مربعات التحديد. أدخل خيارًا واحدًا في كل سطر. استخدم Label|value عندما ينبغي أن تختلف التسمية الظاهرة للمستخدم عن القيمة المحفوظة:
مخاطر منخفضة|low
يحتاج إلى مراجعة|review
مخاطر عالية|high
3. إعداد سلوك الحقول
يمكن لكل حقل استخدام الإعدادات الآتية:
| الإعداد | السلوك |
|---|---|
| نص المساعدة (Help text) | يشرح ما ينبغي للمكلّف تقديمه. |
| العنصر النائب (Placeholder) | يعرض مثالًا أو تلميحًا قصيرًا عندما يدعمه نوع الحقل. |
| القيمة الافتراضية (Default value) | توفّر قيمة أولية. تستخدم الحقول المخفية غير المخصصة للملفات قيمها الافتراضية دائمًا. |
| إظهار في النموذج (Show in form) | يعرض الحقل للمكلّف. أوقفه لتمرير قيمة افتراضية مخفية إلى نتيجة المهمة. |
| مطلوب (Required) | يمنع كل إجراء مسموح به إلى أن يحصل الحقل الظاهر على قيمة صالحة. |
| الترتيب (Order) | يتحكم في ترتيب الحقول الظاهرة في شاشة المهمة. |
| حقل الكيان (Entity field) | يعلّم حقلًا قياسيًا واحدًا باعتباره معرّف كيان المهمة. لا يمكن أن يوجد إلا حقل كيان واحد، ولا يمكن أن يكون ملفًا أو مجموعة مربعات تحديد. |
| المستند الرئيسي (Main document) | يعلّم حقل ملف ظاهرًا واحدًا باعتباره المستند الأساسي لمهمة سير العمل. |
لا يمكن أن تكون الحقول المخفية مطلوبة. ولا يرفع حقل ملف مخفي شيئًا أو ينتج قيمة؛ لذلك أبقِ حقول الملفات ظاهرة.
4. استخدام أسماء متغيرات آمنة
اسم متغير الحقل:
- يبدأ بحرف أو شرطة سفلية؛
- لا يحتوي إلا على الأحرف والأرقام والشرطات السفلية؛
- فريد داخل نموذج المهمة.
لا تستخدم الأسماء المملوكة للمحرك: action أو actor أو comments أو form_data أو signal_data أو signal_received.
لا يؤدي تغيير تسمية الحقل لاحقًا إلى تغيير اسم متغيره. تعامل مع اسم المتغير كعقد ثابت مع العُقد اللاحقة.
إعداد الأزرار والمسارات
1. تعريف الإجراءات المسموح بها
افتح علامة الإجراءات (Actions). أضف الإجراءات التي يستطيع المكلّف اتخاذها أو عدّلها.
| الإعداد | السلوك |
|---|---|
| معرّف الإجراء (Action ID) | معرّف توجيه ثابت. يجب أن يبدأ بحرف لاتيني صغير، وألا يحتوي إلا على أحرف لاتينية صغيرة وأرقام وشرطات سفلية. |
| اسم الإجراء (Action Name) | تسمية الزر الظاهرة للمستخدم. |
| اللون (Color) | المعالجة المرئية للإجراء ومساره. |
| يتطلب تعليقًا (Requires Comment) | يمنع إرسال الإجراء حتى يُدخل المكلّف تعليقًا. |
يجب أن تكون معرّفات الإجراءات فريدة. من المعرّفات الجيدة: approve وrequest_changes وsend_to_legal.
لا تضف إجراءً باسم submit لإرسال النموذج فقط؛ فكل إجراء مسموح به يرسل النموذج بالفعل.
2. توصيل كل نتيجة
- احفظ عقدة المهمة.
- ارسم اتصالًا صادرًا من عقدة المهمة.
- اختر نتيجة الإجراء التي ستستخدم ذلك الاتصال.
- كرر ذلك لكل إجراء مسموح به يحتاج إلى مسار مستقل.
على سبيل المثال:
approve → إنشاء التقرير النهائي
request_changes → إرسال بريد إلى مقدم الطلب → العودة إلى المراجعة
send_to_legal → إسناد مهمة مراجعة قانونية
قبل تشغيل سير العمل، تأكد من أن كل إجراء معرّف له خطوة تالية صالحة. يجب أن يطابق معرّف الإجراء على الاتصال معرّف الإجراء في خصائص المهمة.
ما الذي يراه المكلّف؟
عندما يفتح المكلّف المسجّل دخوله المهمة من مهامي أو تفاصيل سير العمل:
- يعرض RAPTIX سياق المهمة وأي مستند مرتبط.
- يعرض قسم نموذج المهمة الحقول الظاهرة بالترتيب المعدّ.
- تُعلّم الحقول المطلوبة ويُتحقق منها.
- يعرض قسم الإجراءات المسموح بها أزرار الإجراءات المعدّة.
- يؤدي اختيار إجراء إلى رفع الملفات المعلّقة، والتحقق من الحقول ومتطلب التعليق، وتسجيل الاستجابة كاملة، والمتابعة عبر مسار ذلك الإجراء.
يرى المكلّف الخارجي الذي يحمل رابط إجراء آمنًا وصالحًا حقول نموذج المهمة نفسها من دون الحاجة إلى حساب في مساحة العمل. يبقى الرابط مقصورًا على تلك المهمة والإجراء المخوّل له؛ ويؤدي تأكيده إلى إرسال الحقول والمتابعة عبر مسار الإجراء.
استخدام قيم نموذج المهمة لاحقًا
يصبح كل حقل مرسل إخراجًا لعقدة المهمة تحت اسم المتغير الخاص به. وتحتفظ النتيجة أيضًا بالقيم مجمعة تحت form_data لمراجعتها معًا وفي عروض التدقيق.
مثال للحقول:
risk_level
review_notes
signed_contract
يمكن للعُقد اللاحقة استخدام هذه المخرجات من أجل:
- توجيه شرط If/Else باستخدام
risk_level؛ - تضمين
review_notesفي رسالة أو تقرير مولّد؛ - تمرير القيم إلى وكيل ذكاء اصطناعي؛
- إرفاق
signed_contractأو حفظه من خلال عقدة لاحقة تتعامل مع الملفات.
تُحفظ حقول الملفات كمراجع مستندات محمية، لا كعناوين ملفات عامة. استخدم منتقي المتغيرات أو المخرجات في العقدة اللاحقة لاختيارها بدلًا من كتابة مسار متوقع.
بناء نموذج مهمة باستخدام منشئ الذكاء الاصطناعي
صِف الخطوة البشرية والحقول والإجراءات ونتائج الفروع معًا. على سبيل المثال:
أضف مهمة مراجعة عقد إلى
[email protected]. اجمع مستوى مخاطر مطلوبًا بخيارات منخفض ومراجعة وعالٍ؛ وملاحظات مراجعة اختيارية؛ وملف عقد موقّع مطلوبًا. أضف إجراءي الاعتماد وطلب التعديلات. يجب أن ينشئ الاعتماد تقريرًا، وأن يرسل طلب التعديلات بريدًا إلى مقدم الطلب ثم يعود في حلقة إلى المراجعة.
يمكن لمنشئ الذكاء الاصطناعي اقتراح حقول نموذج المهمة والإجراءات المسموح بها، ثم توصيل الفروع اللاحقة باستخدام معرّفات الإجراءات الدقيقة. راجع التغييرات المقترحة قبل اختيار تطبيق على اللوحة (Apply to canvas)، ثم افتح خصائص المهمة وتحقق من أسماء الحقول وقواعد الإلزام والمستلم والمسارات.
التحقق والأمان
- لا تقبل عمليات إرسال نموذج المهمة إلا الحقول المعرّفة في عقدة المهمة.
- يتحقق الخادم من القيم المطلوبة وأنواع الأرقام والتواريخ واختيارات مربعات التحديد والقوائم المنسدلة.
- يجب أن تنتمي الملفات المرفوعة إلى مثيل سير العمل نفسه؛ ولا يمكن لمهمة إرسال مرجع ملف من حالة أخرى.
- يجب أن يكون الإجراء المحدد واحدًا من الإجراءات المسموح بها للمهمة.
- لا يمكن إرسال مهمة مكتملة مرة ثانية عبر الإجراء المعلّق نفسه.
- تُحفظ نتائج نموذج المهمة في التنفيذ العادي والمتوازي وتنفيذ Foreach.
استكشاف الأخطاء وإصلاحها
| المشكلة | الحل |
|---|---|
| حقول نموذج المهمة غير ظاهرة في خصائص المهمة | افتح علامة النموذج واضبط تصنيف المهمة على نموذج. |
| لا تعرض المهمة نموذجًا وقت التشغيل | تأكد من أن التصنيف لا يزال نموذجًا، ومن وجود حقل ظاهر واحد على الأقل، ومن حفظ أحدث إصدار لسير العمل قبل بدء التشغيل. |
| يرفض حفظ المهمة (Save Task) حقلًا | تحقق من أن اسم متغيره صالح وفريد، ومن وجود خيارات لحقول القائمة ومجموعة مربعات التحديد. |
| يظل زر إجراء معطلًا أو يعيد أخطاء تحقق | أكمل كل الحقول المطلوبة، وارفع الملفات المطلوبة، وأدخل تعليقًا عندما يتطلبه الإجراء. |
| يسلك سير العمل الفرع الخطأ | قارن نتيجة الاتصال بمعرّف الإجراء المسموح به؛ يمكن أن تتغير التسميات، لكن المعرّف هو عقد التوجيه. |
| لا تعثر عقدة لاحقة على قيمة | اختر الإخراج من عقدة المهمة في منتقي المتغيرات، وتأكد من عدم تغيير اسم متغير الحقل. |
| أدى تغيير التصنيف إلى إزالة الحقول | يؤدي الانتقال من نموذج إلى مسح حقول نموذج المهمة بعد التأكيد. استعد إصدار سير العمل أو أعد إضافة الحقول. |
