#قواعد الربط

#مقدمة

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

من خلال إعداد قواعد الربط، يمكنك تحقيق ما يلي:

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

#إعداد الشروط

#المتغير الأيسر

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

تتضمن المتغيرات القابلة للتحديد ما يلي:

• الحقول في السياق، مثل 「النموذج الحالي/xxx」، 「السجل الحالي/xxx」، 「سجل النافذة المنبثقة الحالي/xxx」، إلخ.
• متغيرات النظام العامة، مثل المستخدم الحالي، الدور الحالي، إلخ، وهي مناسبة للتحكم الديناميكي بناءً على هوية المستخدم، الصلاحيات، وغيرها من المعلومات.

  ✅ يتم تحديد الخيارات المتاحة للمتغير الأيسر بواسطة سياق الكتلة. استخدم المتغير الأيسر بشكل معقول وفقًا لاحتياجات العمل:

  • 「المستخدم الحالي」 يمثل معلومات المستخدم الذي قام بتسجيل الدخول حاليًا.
  • 「النموذج الحالي」 يمثل قيم الإدخال في الوقت الفعلي في النموذج.
  • 「السجل الحالي」 يمثل قيمة السجل المحفوظة، مثل سجل صف في جدول.

#عامل التشغيل

يُستخدم عامل التشغيل لتحديد منطق تقييم الشرط، أي كيفية مقارنة المتغير الأيسر بالقيمة اليمنى. تدعم الأنواع المختلفة من المتغيرات اليسرى عوامل تشغيل مختلفة، وعوامل التشغيل الشائعة هي كما يلي:

• نوع النص: $includes، $eq، $ne، $empty، $notEmpty، إلخ.
• نوع الرقم: $eq، $gt، $lt، $gte، $lte، إلخ.
• نوع منطقي (Boolean): $isTruly، $isFalsy
• نوع المصفوفة: $match، $anyOf، $empty، $notEmpty، إلخ.

✅ سيقوم النظام تلقائيًا باقتراح قائمة بعوامل التشغيل المتاحة بناءً على نوع المتغير الأيسر لضمان منطقية إعدادات الربط.

#القيمة اليمنى

تُستخدم للمقارنة مع المتغير الأيسر، وهي القيمة المرجعية لتحديد ما إذا كان الشرط مستوفيًا.

تتضمن المحتويات المدعومة ما يلي:

• قيم ثابتة: إدخال أرقام، نصوص، تواريخ ثابتة، إلخ.
• متغيرات السياق: مثل الحقول الأخرى في النموذج الحالي، السجل الحالي، إلخ.
• متغيرات النظام: مثل المستخدم الحالي، الوقت الحالي، الدور الحالي، إلخ.

✅ سيقوم النظام تلقائيًا بتكييف طريقة الإدخال للقيمة اليمنى بناءً على نوع المتغير الأيسر، على سبيل المثال:

• عندما يكون المتغير الأيسر "حقل خيارات"، سيتم عرض محدد الخيارات المقابل.
• عندما يكون المتغير الأيسر "حقل تاريخ"، سيتم عرض منتقي التاريخ.
• عندما يكون المتغير الأيسر "حقل نص"، سيتم عرض مربع إدخال النص.

💡 يتيح الاستخدام المرن للقيم اليمنى (خاصة المتغيرات الديناميكية) بناء منطق ربط يعتمد على المستخدم الحالي، حالة البيانات الحالية، وسياق البيئة، مما يحقق تجربة تفاعلية أقوى.

#منطق تنفيذ القواعد

#تشغيل الشرط

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

#قواعد متعددة

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

يُعد ترتيب تنفيذ القواعد المتعددة أمرًا بالغ الأهمية. عند تصميم القواعد، تأكد من توضيح أولوياتها وعلاقاتها المتبادلة لتجنب التعارضات.

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

يمكن إجراء العمليات التالية على كل قاعدة:

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

#حول المتغيرات

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

#قواعد ربط الكتل

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

👉 لمزيد من التفاصيل، راجع: الكتل/قواعد ربط الكتل

#قواعد ربط الحقول

تُستخدم قواعد ربط الحقول لتعديل حالة الحقول ديناميكيًا في نموذج أو كتلة تفاصيل بناءً على إجراءات المستخدم، وتشمل بشكل أساسي:

• التحكم في حالة الإظهار/الإخفاء للحقل
• تحديد ما إذا كان الحقل إلزاميًا
• تعيين قيمة
• تنفيذ JavaScript لمعالجة منطق العمل المخصص

👉 لمزيد من التفاصيل، راجع: الكتل/قواعد ربط الحقول

#قواعد ربط الإجراءات

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

👉 لمزيد من التفاصيل، راجع: الإجراءات/قواعد الربط