ربط مهمة سير عمل بصفحة منشئ التطبيقات

ما الذي يفعله تكامل المهمة؟

تستطيع عقدة مهمة في سير عمل Enterprise نشر منطق معالجة المهمة إلى صفحة منشئ التطبيقات. يحذف النشر كل كائن JavaScript يحمل الاسم TaskActions أو TaskData أو يبدأ بأي منهما، بما في ذلك الكائنات المنشأة يدويًا. ثم ينشئ كائن TaskActions جديدًا واحدًا يحتوي على دوال مساعدة لإجراءات المهمة وبياناتها. يضيع أي كود يدوي في الكائنات المحذوفة.

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

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

قبل أن تبدأ

تحتاج إلى:

• وصول Enterprise؛
• إذن تحرير سير العمل واستخدام منشئ التطبيقات؛
• صفحة موجودة في منشئ التطبيقات للمهمة؛
• عقدة مهمة عُرّف المسند إليه وإجراءاتها المسموحة؛ و
• تشغيل اختباري يستطيع إنشاء مهمة مسندة حقيقية.

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

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

حد التفويض الحالي: تتطلب واجهة Enterprise مستخدمًا موثّقًا يملك وصولًا عامًا إلى التطبيقات، لكنها لا تفرض ACL التطبيقات على الصفحة الهدف. لا تستخدم النشر إلا ضمن عملية تغيير صفحة معتمدة.

ضبط صفحة المهمة ونشرها

1. افتح سير العمل في منشئ التدفق وافتح عقدة المهمة المعنية.
2. اضبط عنوان المهمة ووصفها والمسند إليه وقواعد الإكمال.
3. أضف ضمن الإجراءات ما يستطيع المسند إليه تنفيذه. استخدم معرّفات ثابتة بأحرف صغيرة وأسماء موجهة للمستخدم، وعلّم الإجراءات التي تتطلب تعليقًا.
4. اختر فئة منشئ التطبيقات في إعدادات نموذج المهمة. إذا كانت الشاشة ما زالت تعرض Appsmith، فاختر تلك الفئة.
5. اختر اتصال، ثم حدد مساحة العمل والتطبيق والصفحة.
6. احفظ خصائص المهمة. يرسل النشر الحالي معرّف الصفحة المحددة؛ ولا تتحكم اختيارات الأداة أو الكيان أو المستند الرئيسي في النشر المنشأ للمهمة.
7. عند ظهور مربع نجاح النشر، راجع الصفحة والحالة، ثم اختر متابعة لإنهاء حفظ المهمة.
8. افتح الصفحة في منشئ التطبيقات وراجع كل رابط منشأ قبل الاختبار.

تزيل RAPTIX كل كائن TaskActions* وTaskData* مطابق، وتنشئ كائن TaskActions بديلًا بمعرّف جديد، وتنشر الصفحة غير المنشورة الحالية، وتسجل نتيجة النشر مع عقدة المهمة. حدّث صفحة منشئ التطبيقات قبل الاختبار.

ما الذي يمكن أن يغيره النشر؟

وفق الصفحة، يستطيع النشر:

• استبدال كل كائنات المهمة المطابقة بكائن TaskActions موحد؛
• ربط الأدوات المطابقة ببيانات المهمة؛
• ضبط أدوات FilePicker لمرفقات المهمة، إذ تستخدم دالة الرفع المساعدة بيانات اعتماد التكامل المضمنة؛
• ضبط حاوية لتحميل بيانات المهمة؛ و
• كشف إجراءات عقدة المهمة المسموحة عبر TaskActions.

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

ربط أزرار إجراءات المهمة

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

1. أنشئ أو اختر في منشئ التطبيقات زرًا لكل إجراء في عقدة المهمة ينبغي للصفحة عرضه.

2. اضبط رابط onClick للزر على معرّف الإجراء الثابت المطابق. مثال:

   {{TaskActions.executeWorkflowAction('approve', Input_Comments.text)}}
   

3. استخدم وسيطًا ثانيًا فارغًا عندما لا يجمع الإجراء تعليقًا.

4. راجع الروابط وانشرها عبر عملية تغيير منشئ التطبيقات المعتمدة.

الاختبار بمهمة مسندة

لا تتحقق من الصفحة بفتح عنوان خام فقط. تتطلب إجراءات المهمة سياق مهمة مسندة.

1. ابدأ تشغيلًا اختباريًا لسير العمل.
2. تأكد من إسناد المهمة إلى مستخدم الاختبار.
3. افتح المهمة من المهام المعلقة أو صفحة تفاصيل سير العمل.
4. تأكد من أن الصفحة تعرض السجل وبيانات المهمة الصحيحين.
5. نفّذ كل إجراء مسموح، بما فيه التحقق من التعليق المطلوب.
6. تأكد من أن المهمة تكتمل أو تغير حالتها مرة واحدة، وأن سير العمل يتابع بصورة صحيحة.
7. تحقق من أي مستند مرفوع من طريقتي سير العمل والمستندات.

استكشاف الأخطاء وإصلاحها

تنتهي مهلة النشر

قد تُحفظ المهمة من دون نشر ناجح للصفحة. أعد فتحها، وتأكد من الصفحة المحددة، وانشر مجددًا قبل الاختبار.

تفتح الصفحة من دون بيانات المهمة

افتحها من مهمة مسندة، لا من إشارة مرجعية. ثم تأكد من الصفحة وروابط الأدوات وأعد النشر.

إجراء مفقود أو زره لا يعمل

تحقق من قائمة الإجراءات في خطوة المهمة ومعرّف الإجراء الثابت، ثم راجع رابط الزر في منشئ التطبيقات. احفظ وانشر مجددًا عندما يصبح الاتصال المنشأ قديمًا؛ فالنشر لا يربط هذه الأزرار تلقائيًا.

أداة أعيدت تسميتها لم تعد تتحدث

راجع الاسم الحالي وانشر مجددًا. تفحص الروابط المنشأة أسماء الأدوات الحالية؛ ولا يتحكم اختيار أداة في إعدادات المهمة بهذا النشر.