تعريف تفاعلات الكيان

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

1. انتقل إلى قائمة الإدارة.
2. اختر "التطبيقات" ثم "الوحدات".
3. ابحث عن الوحدة المعنية، ثم انتقل إلى تبويب الكيانات وابحث عن الكيان المعني.
4. اضغط على أيقونة القائمة (ثلاث نقاط متجاورة) في أعلى يسار بطاقة اسم الكيان.
5. اختر "تعديل الكيان".
6. انتقل إلى تبويب "التفاعلات".
7. اضغط على زر "إضافة تفاعل"، لتظهر شاشة إعدادات تفاعل الكيان.
8. أضف اسمًا للتفاعل (حقل إجباري قابل للترجمة).
9. اختر الحدث الذي تريد أن يتم عنده تنفيذ التفاعل. لمزيد من المعلومات حول الأحداث، انقر هنا.
10. يمكن ترشيح مخرجات الحدث عن طريق الترشيح. لمزيد من المعلومات حول الترشيح، انقر هنا.
11. اختر الإجراء الذي سيتم تنفيذه عند تحقيق الحدث المطابق لشروط الترشيح. لمزيد من المعلومات حول الإجراءات، انقر هنا.

الأحداث

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

حدث إنشاء مدخل

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

حدث تحديث مدخل

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

حدث أرشفة مدخل

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

حدث المؤقت

يمكن للمنصة أن يربط توليد الحدث بفترة زمنية محددة. يمكن أن يكون المؤقت:

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

حدث الوصول إلى خطوة محددة

هذا الحدث يتولد عند وصول المدخل في سير العمل إلى خطوة معينة يحددها المستخدم، وينفذ إجراء معين في النظام.

لمزيد من المعلومات، انقر هنا.

حدث الخروج من خطوة محددة

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

لمزيد من المعلومات، انقر هنا.

حدث مخصص

الحدث المخصص يرتبط بزر يضاف إلى خيارات كل مدخل، ويتولد هذا الحدث عند الضغط على هذا الزر، مما يؤدي إلى تنفيذ الإجراء المبرمج له.

لمزيد من المعلومات حول إنشاء الزر، انقر هنا.

مؤشر التنفيذ

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

الخطوات:

1. قم بتسجيل الدخول إلى النظام كمدير.
2. قم بالانتقال إلى الكيان المطلوب إنشاء تفاعل ضمنه.
3. قم بالانتقال إلى إعدادات الكيان.
4. انقر على تبويبة التفاعلات.
5. قم بالنقر على زر إنشاء تفاعل جديد.
6. قم باختيار حدث مخصص من قائمة الأحداث.
7. سيظهر قسم بعنوان "مؤشر التنفيذ"
8. عند الضغط على "مؤشر التنفيذ"، يعرض النظام الخيارات التالية:
   • منع: يعرض مؤشر التحميل ويمنع المستخدم من القيام بأي إجراء حتى الانتهاء من تنفيذ التفاعل.
   • إعلام: يعرض مؤشر التحميل ويسمح للمستخدم بالانتقال إلى صفحة أخرى.
   • بدون: لا يعرض أي مؤشر ويسمح للمستخدم بالانتقال إلى صفحة أخرى.
9. قم باختيار أحد الإجراءات.
10. قم بحفظ التفاعل.
11. قم بربط التفاعل بزر، لمزيد من المعلومات حول إنشاء الز انقر هنا.

تنفيذ تفاعل واجهة وفقاً لخيارات مؤشر التنفيذ

1. قم بتسجيل الدخول إلى النظام كمستخدم نهائي.
2. قم بالانتقال إلى المعرض الذي يمتلك صلاحية وصول إليه ويحتوي زر الواجهة المربوط بالتفاعل ومحدد عليه مؤشر التنفيذ.
3. قم بتنفيذ تفاعل واجهة من خلال الضغط على الزر المربوط مع تفاعل الواجهة.
4. سيتم عرض المؤشر حسب الإعدادات المختارة في التفاعل.

مؤشر التنفيذ	المؤشر
منع	يعرض مؤشر التحميل ولا يسمح للمستخدم بالقيام بأي إجراء حتى الانتهاء من تنفيذ التفاعل
إعلام	يعرض مؤشر التحميل ويسمح للمستخدم بالانتقال إلى صفحة أخرى
بدون	لا يعرض أي مؤشر ويسمح للمستخدم بالانتقال إلى صفحة أخرى

تحديد رسالة نجاح وفشل تنفيذ تفاعل واجهة

تحديد رسالة بدء التفاعل

1. قم بتسجيل الدخول إلى النظام كمدير.
2. قم بالانتقال إلى الكيان المطلوب إنشاء تفاعل ضمنه.
3. قم بالانتقال إلى إعدادات الكيان
4. انقر على تبويبة التفاعلات.
5. قم بالنقر على زر إنشاء تفاعل جديد.
6. قم باختيار حدث مخصص من قائمة الأحداث.
7. سيظهر قسم بعنوان "مؤشر التنفيذ ".
8. عند الضغط على "مؤشر التنفيذ" قم باختيار منع.
9. سيقوم النظام بعرض مربع حوار عند بدء التفاعل.
10. سيظهر داخل المربع رسالة افتراضية "تم بدأ التفاعل بنجاح".
11. قم بإدخال الرسالة التي تريد عرضها عند بدء التفاعل.

تحديد رسالة نجاح التفاعل

1. قم بتسجيل الدخول إلى النظام كمدير.
2. قم بالانتقال إلى الكيان المطلوب إنشاء تفاعل ضمنه.
3. قم بالانتقال إلى إعدادات الكيان
4. انقر على تبويبة التفاعلات.
5. قم بالنقر على زر إنشاء تفاعل جديد.
6. قم باختيار حدث مخصص من قائمة الأحداث.
7. سيظهر قسم بعنوان "مؤشر التنفيذ"
8. عند الضغط على "مؤشر التنفيذ" قم باختيار منع.
9. سيقوم النظام بعرض مربع حوار عند بدء التفاعل.
10. سيظهر داخل المربع رسالة افتراضية "تم بدأ التفاعل بنجاح".
11. قم بإدخال الرسالة التي تريد عرضها عند نجاح التفاعل.

تنفيذ تفاعل واجهة يحتوي على رسالة بدء/انتهاء عند تنفيذ التفاعل:

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

حدث الواجهة

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

حدث نجاح تفاعل

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

تعريف تفاعل يتكون من حدث "نجاح تفاعل"

تعريف تفاعل 1:

1. قم بإنشاء تفاعل جديد
2. قم بحفظ التفاعل باسم "تفاعل 1"
3. حدد حدث واجهة (مثال: نقر زر)
4. حدد إجراء (مثال: إنشاء مدخل)

تعريف تفاعل 2:

1. قم بإنشاء تفاعل جديد.
2. قم بحفظ التفاعل باسم "تفاعل 2".
3. اختر حدث بعنوان "نجاح تفاعل".
4. يقوم النظام بضبط إعدادات التفاعل ليتوافق مع التفاعل القادح (التفاعل الذي يتسبب نجاح تنفيذه في قدح التفاعل الحالي)، من حيث سياق التفاعل.
5. سيعرض النظام جميع الكيانات الموجودة في الوحدة الحالية، قم باختيار الكيان الذي يحتوي على التفاعل القادح.
6. سوف يتم عرض جميع التفاعلات المعرفة في هذا الكيان، اختر التفاعل المطلوب.

استخدام نتائج التفاعل في إعدادات الإجراءات في تفاعل 2:

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

قدح تفاعل مبني على نجاح تفاعل آخر

تنفيذ تفاعل 1:

1. قم بتسجيل الدخول إلى المنصة كمستخدم نهائي
2. قم بإجراء ما يؤدي إلى قدح "تفاعل 1" (مثل نقر زر).

نجاح تفاعل 1:

1. عند تنفيذ "تفاعل 1" بنجاح، يقوم النظام بقدح "تفاعل 2" تلقائيًا.

ترشيح مدخلات التفاعل

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

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

الإجراءات

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

إجراء إنشاء مدخل

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

إجراء تعديل مدخل

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

إجراء أرشفة مدخل

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

إنشاء تفاعل يقوم بأرشفة مدخل

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

إنشاء تفاعل يقوم بأرشفة مدخل مرتبط

1. قم بتسجيل الدخول إلى النظام كمدير.
2. قم باختيار الكيان المطلوب إنشاء تفاعل فيه.
3. من تبويبة التفاعلات، قم بإنشاء تفاعل جديد أو تعديل تفاعل موجود.
4. قم باختيار أي حدث من قائمة الأحداث الموجودة.
5. قم باختيار إجراء "أرشفة مدخل" من قائمة الإجراءات
   • سيعرض النظام قائمة منسدلة تحت عنوان "النطاق ".
   • قم باختيار "المدخلات المرتبطة ".
   • سوف يقوم النظام ضمن حقل العلاقة بعرض قائمة بالعلاقات الواردة المعرفة على مستوى الكيان.
   • قم باختيار العلاقة المراد أرشفة مدخلاتها المرتبطة بالمدخل الذي تم تنفيذ التفاعل عليه

إنشاء تفاعل يقوم بأرشفة المدخلات الناتجة عن استعلام

1. قم بتسجيل الدخول إلى النظام كمدير.
2. قم باختيار الكيان المطلوب إنشاء تفاعل فيه.
3. من تبويبة التفاعلات، قم بإنشاء تفاعل جديد أو تعديل تفاعل موجود.
4. قم باختيار أي حدث من قائمة الأحداث الموجودة.
5. قم باختيار إجراء "أرشفة مدخل" من قائمة الإجراءات
   • سيعرض النظام قائمة منسدلة تحت عنوان "النطاق".
   • قم باختيار "استعلام محفوظ ".
   • سوف يقوم النظام ضمن حقل الاستعلامات بعرض قائمة بالاستعلامات المعرفة على مستوى الكيان.
   • قم باختيار الاستعلام المراد أرشفة مدخلاته

إجراء إرسال إشعار

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

إجراء إرسال بريد إلكتروني

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

إجراء إرسال رسالة نصية

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

إجراء الاستدعاء البرمجي

يساعد هذا الإجراء مستخدم الإدارة على الاستدعاء البرمجي وربط البرمجيات الخارجية عن طريق استقبال وإرسال البيانات. يحتوي على أنواع مختلفة من الطلبات (GET، POST، PATCH، PUT، DELETE).

إجراء تنفيذ إجراء ضمن خطوة في تدفق العمل

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

إجراء نقل تدفق العمل إلى خطوة محددة

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