استخدام قاعدة بيانات سير العمل

ما الذي تتحكم فيه قاعدة بيانات سير العمل؟

قاعدة بيانات سير العمل (Workflow Database) هي وحدة التحكم في الإدارة التشغيلية على المسار /workflow-database. وهي مخصصة لسجلات التنفيذ المحفوظة واتصالات سير العمل، لا لترتيب العُقد في لوحة منشئ التدفقات.

تحتوي الصفحة حاليًا على ثماني علامات تبويب:

1. لوحة المعلومات (Dashboard)
2. المثيلات (Instances)
3. المهام (Tasks)
4. الإجراءات (Actions)
5. الإشعارات (Notifications)
6. الخطوات (Steps)
7. الاتصالات (Communications)
8. التذكيرات (Reminders)

لا توجد علامة تبويب مستقلة باسم القوالب (Templates). تظهر قوالب سير العمل (Workflow Templates) كبطاقة في لوحة المعلومات، وتعيدك إلى إدارة سير العمل حيث تُنشأ تصميمات سير العمل وتُحرر.

فتح قاعدة بيانات سير العمل

1. افتح التطبيقات ← منشئ التدفقات.
2. اختر قاعدة بيانات سير العمل من رأس إدارة سير العمل.

يمكنك أيضًا فتح /workflow-database مباشرة. اختر رجوع (Back) للعودة إلى الموضع السابق في المتصفح.

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

التحقق من حالة الاتصال

تتحقق قاعدة بيانات سير العمل من واجهة Workflow API عند فتحها.

• أثناء التحقق، تعرض أعداد لوحة المعلومات حالات تحميل.
• عند الاتصال، تُحمّل الجداول وإجراءات الإدارة كالمعتاد. لا تحتفظ الصفحة الحالية بشريط أخضر دائم يقول إن API متصلة.
• عند انقطاع الاتصال، توضح رسالة حمراء أن أعداد السجلات وإجراءات الإدارة غير متاحة. اختر إعادة المحاولة (Retry) بعد استعادة اتصال الخادم.
• إذا فشل بعض طلبات الأعداد فقط، يظهر تحذير بينما تظل بقية وحدة التحكم متاحة.

استخدام لوحة المعلومات

علامة لوحة المعلومات الافتراضية هي نظرة عامة على مجموعات السجلات المتاحة. اختر بطاقة لفتح علامة التبويب المقابلة.

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

عناصر التحكم المشتركة في الجداول

تستخدم معظم علامات تبويب السجلات شبكة بيانات. ويمكنك، حسب علامة التبويب:

• تغيير حجم الصفحة بين 10 و25 و50 و100 صف؛
• التنقل بين الصفحات المحمّلة من الخادم؛
• ترتيب الأعمدة المدعومة؛
• استخدام شريط أدوات الشبكة للتصفية السريعة وعناصر الجدول الأخرى المتاحة؛
• تحديد الصفوف عندما تكون مربعات التحديد ممكّنة؛
• فتح إجراءات الصف من عمود الإجراءات.

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

المثيلات

تحتوي مثيلات سير العمل على سجلات التنفيذ المحفوظة لمسارات سير العمل.

العثور على مثيل

استخدم البحث (Search) والحالة (Status) واسم سير العمل (Workflow Name)، ثم اختر مسح عوامل التصفية (Clear Filters) عند الانتهاء. الحالات المتاحة هي:

• معلّق pending؛
• قيد التشغيل running؛
• مكتمل completed؛
• فاشل failed؛
• ملغى cancelled؛
• موقوف مؤقتًا suspended؛
• مجدول scheduled.

يتضمن الجدول: المعرّف، ومعرّف المثيل، واسم سير العمل، وملخص بيانات سير العمل، والحالة، وأنشأه، وتاريخ الإنشاء، والتحديث، والإجراءات.

إجراءات المثيل

استخدم إنشاء مثيل (Create Instance) لسجل تشغيلي مقصود فقط. يتطلب معرّف مثيل واسم سير عمل وJSON لسير العمل وحالة ومعلومات المنشئ. أما سير عمل جديد (New Workflow) فيفتح منشئ التدفقات لإنشاء تصميم.

يؤدي التحديد بمربعات الاختيار إلى تمكين حذف المحدد (N) (Delete Selected). يحذّر الحذف المجمع من احتمال إزالة المهام والإشعارات والخطوات والمقاييس وسجل الإجراءات والإعداد ومراجع القوالب المرتبطة أيضًا. وتُوقف التحديدات قيد التشغيل أو المجدولة أولًا. تحقق من كل معرّف مثيل محدد قبل التأكيد.

المهام

تعرض مهام سير العمل (Workflow Tasks) سجلات المهام عبر مسارات سير العمل والمكلّفين.

استخدم البحث والحالة ونوع المهمة (Task Type) وبريد المكلّف (Assignee Email)، ثم اختر تطبيق عوامل التصفية (Apply Filters). يزيل مسح عوامل التصفية تلك القيم.

يعرض الجدول عنوان المهمة ونوعها والمكلّف واسم سير العمل ومعرّف المثيل والأولوية والحالة والإنشاء وتاريخ الاستحقاق والإكمال والإجراءات السريعة والإجراءات. الأولويات هي منخفضة ومتوسطة وعالية وعاجلة.

إجراءات المهمة

• يفتح فتح بوابة المهمة (Open Task Portal) عنوان بوابة المهمة في علامة تبويب جديدة عندما يكون موجودًا.
• تفتح الإجراءات السريعة الملونة عنوان الإجراء الذي أعدّه سير العمل، مثل صفحة اعتماد أو رفض.
• ينقل بدء (Start) المهمة المعلّقة إلى قيد التنفيذ.
• يتوفر إكمال (Complete) وإلغاء (Cancel) للمهمة قيد التنفيذ.
• يعرض عرض (View) بيانات المهمة المحفوظة كاملة.
• يغيّر تحرير (Edit) حقول المهمة القابلة للتحرير.
• يطلب حذف (Delete) تأكيدًا، ويغيّر حاليًا حالة المهمة إلى ملغاة؛ ولا يستدعي عملية حذف نهائي لسجل المهمة.
• ينشئ إنشاء مهمة (Create Task) سجل مهمة يدويًا.

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

الإجراءات

تحتوي إدارة الإجراءات (Actions Management) على سجلات إجراءات المستخدم والنظام، بما فيها الإنشاء والتحديث والحذف والاعتماد والرفض والإكمال والإسناد.

تعرض بطاقات الملخص إجمالي الإجراءات (Total Actions) والأخيرة خلال 24 ساعة (Recent 24h) والاعتمادات (Approvals) والرفض (Rejections). يستخدم الإجمالي عدد الخادم، بينما تُحسب التقسيمات الأخرى من صفحة النتائج المحمّلة حاليًا.

صفِّ حسب نوع الإجراء (Action Type) أو بريد المستخدم (User Email) أو معرّف المثيل (Instance ID). يتضمن الجدول نوع الإجراء والمستخدم وسير العمل ومعرّف المثيل ومعرّف العقدة والطابع الزمني وعنوان IP والتعليقات وإجراءات الصف.

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

• ينشئ إضافة إجراء (Add Action) سجل إجراء تشغيليًا.
• يفتح عرض السجل الكامل وبيانات النتيجة.
• يغيّر تحرير النتيجة والتعليقات المحفوظة.
• يزيل حذف سجل الإجراء نهائيًا.

يؤدي حذف إجراء إلى إزالة دليل تدقيق. تأكد من متطلبات العمل والامتثال قبل تغيير أي شيء أو حذفه في علامة التبويب هذه.

الإشعارات

تتعقب إدارة الإشعارات (Notifications Management) سجلات إشعارات البريد الإلكتروني وSMS والإشعارات الفورية وWebhook.

تعرض بطاقات الملخص إجمالي الإشعارات (Total Notifications) والمرسلة (Sent) والفاشلة (Failed). يستخدم الإجمالي عدد الخادم، بينما يُحسب توزيع الحالات من الصفوف المحمّلة.

صفِّ حسب النوع (Type) أو الحالة (Status) أو المستلم (Recipient) أو معرّف المثيل. تشمل خيارات الحالة: معلّق، ومرسل، وفاشل، وتم التسليم.

يعرض الجدول النوع والعنوان والمستلم والاسم والحالة واسم سير العمل ومعرّف المثيل ومحاولات التسليم والإنشاء ووقت الإرسال والإجراءات. اختر عرض لمراجعة نص الرسالة وتوقيت التسليم والمحاولات والبيانات الإضافية وأي خطأ.

ينشئ إضافة إشعار (Add Notification) سجل إشعار مع وجهته ونوعه وعنوانه ورسالته وبيانات JSON اختيارية. يُبقي مربع حوار التحرير حقول التوجيه والمحتوى الأصلية مقفلة، وهو مخصص لبيانات التتبع القابلة للتحرير، بما فيها الحالة أو معلومات الخطأ الموجودة في بيانات JSON. يزيل حذف سجل الإشعار نهائيًا؛ لكنه لا يسترجع رسالة سبق تسليمها.

الخطوات

تعرض إدارة خطوات التنفيذ (Execution Steps Management) كيفية تشغيل كل عقدة داخل مثيلات سير العمل.

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

• يعرض عرض بيانات الإدخال والإخراج والتوقيت وعدد المحاولات ورسالة الخطأ.
• يحدّث تحرير حقول الخطوة المحفوظة.
• ينشئ إضافة خطوة (Add Step) سجل خطوة تنفيذ يدويًا.
• يعيد تحديث (Refresh) تحميل الجدول.

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

الاتصالات

تدير قوالب التواصل (Communication Templates) محتوى اتصالات سير العمل القابل لإعادة الاستخدام.

هذه هي إدارة القوالب الكاملة في الواجهة الحالية؛ ولا توجد صفحة اتصالات منفصلة في التنقل الرئيسي. تعرض بطاقاتها الأربع إجمالي القوالب (Total Templates) والقوالب النشطة (Active Templates) ومسودات القوالب (Draft Templates) وإجمالي الاستخدام (Total Usage). استخدم البحث في القوالب (Search templates) أو وسّع عوامل التصفية (Filters) لتقييد الجدول حسب النوع أو التصنيف أو الحالة.

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

إنشاء قالب تواصل أو تحريره

1. اختر إنشاء قالب (Create Template)، أو اختر تحرير في صف قائم.
2. في المعلومات الأساسية (Basic Information)، أدخل عنوان القالب (Template Title)، واختر نوع القالب (Template Type) والتصنيف (Category) والأولوية (Priority)، وحدد ما إذا كان قالبًا عامًا (Public Template)، وأضف وصفًا اختياريًا.
3. في المحتوى (Content)، أدخل الموضوع عندما يدعمه النوع المحدد، وأكمل محتوى القالب (Template Content). يدعم محتوى البريد HTML. استخدم معاينة قبل الحفظ.
4. في المتغيرات (Variables)، اختر إضافة متغير (Add Variable) لكل قيمة قابلة لإعادة الاستخدام. أدخل اسمه، واختر نصًا أو رقمًا أو تاريخًا أو نعم/لا، وحدد ما إذا كان مطلوبًا (Required)، وأضف وصفًا. استخدمه في المحتوى بصيغة {{variable_name}}.
5. أضف وسومًا (Tags) مفصولة بفواصل عندما تكون مفيدة، ثم اختر إنشاء القالب (Create Template) أو تحديث القالب (Update Template).

يوفر المدير الحالي سبعة أنواع للقوالب: البريد الإلكتروني (Email) وSMS وإشعار داخل التطبيق (In-App Notification) وإشعار فوري (Push Notification) ورسالة Slack (Slack Message) وMicrosoft Teams وWebhook. تشمل التصنيفات الحالية إشعارات سير العمل وتهيئة المستخدم وتنبيهات النظام والتسويق والمعاملات وطلبات الاعتماد وتحديثات الحالة والتذكيرات والتقارير ومخصص. تشمل حالات دورة الحياة: مسودة، ومعلّق للاعتماد، ومعتمد، ونشط، وغير نشط، ومؤرشف؛ والأولويات منخفضة ومتوسطة وعالية وعاجلة.

يؤدي تحرير قالب لم يعد في حالة المسودة إلى إنشاء إصدار مسودة جديد يجب أن يمر بدورة الاعتماد مرة أخرى. تحتفظ عُقد سير العمل القائمة بالمحتوى الذي سبق أن حفظته إلى أن يعيد المصمم عمدًا تطبيق القالب الأحدث. لا يوفر المدير الحالي متصفحًا لسجل الإصدارات أو شريط إجراءات مجمعة أو عرضًا متعمقًا لتحليلات التسليم؛ ومؤشرا الاستخدام الظاهران فيه هما مرات الاستخدام (Times Used) وإجمالي الاستخدام (Total Usage).

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

التذكيرات

يدير مجدول التذكيرات (Reminder Scheduler) تذكيرات البريد الإلكتروني المبنية على التاريخ.

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

صفِّ حسب سير العمل أو الحالة أو البريد الإلكتروني أو البحث. يتضمن الجدول سير العمل ومعرّف الصف والإزاحة والوقت المجدول والبريد والحالة ووقت الإرسال والمحاولات والخطأ والإجراءات.

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

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

إرشادات الأمان

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

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