حقل الربط (Mapped field)

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

الاسم	الوصف	نمط البيانات
حقل الربط	حقل يسمح بقراءه قيم حقل من كيان مرتبط	اعتماداً على الحقل الذي تم الربط معه من الكيان المرتبط

الإعدادات المتقدمة

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

الإعدادات الأساسية

يحتوي هذا القسم على سبعة حقول:

1. حقل الارتباط: يحتوي على العلاقة التي تم اختيارها من العلاقات المعرفة ضمن الكيان الحالي.
2. مصدر الحقل: وهو أحد حقول الكيان المرتبط الذي تم اختياره كمصدر للحقل.
3. خيار التحديث: حدد الخيار المناسب للتحديث من بين الخيارات التالية:

• عدم التحديث (Never): غير قابل للتعديل.
• الكيان الحالي (Local update): قابل للتعديل ضمن الكيان الحالي ولا يتم عكسه ضمن الكيان الأب.
• من الكيان الأب (From Parent Entity): غير قابل للتعديل من الكيان الحالي ولكن قابل للتعديل من الكيان الأب وينعكس ذلك التعديل على الكيان الحالي.
• مزامنة (2-way): قابل للتعديل من الكيان الحالي والكيان الأب وأي تعديل في أحد الكيانين ينعكس ذلك على الكيانين

4. اسم الحقل: هنا يجب تحديد اسم لحقل الربط مع الترجمة باللغة العربية والإنجليزية
5. الوصف: حقل اختياري يمكن استخدامه لإضافة وصف للحقل
6. الاسم النموذجي: يحتوي على الاسم النموذجي لحقل الربط والذي يتم إنشاؤه تلقائيًا من الاسم باللغة الإنجليزية. يمكن تغيير هذا الاسم وهو يعمل كاسم فريد مثل الهوية (ID) للحقل
7. نوع البيانات: هنا يظهر نمط البيانات الذي تم تخزينه في حقل الارتباط وهو في هذه الحالة نص

قفل الحقل:

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

كيفية تفعيل خاصية القفل:

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

إخفاء الحقل:

خاصية قفل الحقل تسمح للمستخدم بإخفاء الحقل اعتماداًعلى تعبير برمجي محدد مما يجعله غير مرئي للمستخدم

كيفية تفعيل خاصية الإخفاء:

1. قم بفتح إعدادات حقل الربط
2. قم بتفعيل خاصية إخفاء الحقل
3. بعد التفعيل سيظهر حقل إضافي حيث يسمح للمستخدم بإدخال تعبير برمجي الذي يجب تحقيقه لإخفاء الحقل

مطلوب:

تحدد هذه الخاصية إذا كان حقل الربط مطلوب إدخاله أو يستطيع المستخدم تجاوزه و تركه فارغاً

كيفية تفعيل خاصية مطلوب:

1. . قم بفتح إعدادات حقل الربط
2. قم بتفعيل خاصية مطلوب
3. بعد التفعيل سيظهر حقل إضافي حيث يسمح للمستخدم بإدخال تعبير برمجي الذي يجب تحقيقه لجعل الحقل مطلوب

قابل للبحث:

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

كيفية تفعيل خاصية قابل للبحث:

1. . قم بفتح إعدادات حقل الربط
2. قم بتفعيل خاصية قابل للبحث

فريد:

عند تفعيل هذه الخاصية تصبح قيم حقل الربط غير قابلة للتكرار وبالتالي قيم هذا الحقل فريدة و لاتتكرر في المدخلات

كيفية تفعيل خاصية فريد:

1. قم بفتح إعدادات حقل الربط
2. قم بتفعيل خاصية فريد

صيغة وشكل القيمة

في هذه الخاصية سوف يتم السماح للمستخدم باختيار صيغة النص التي سوف يظهر فيها هذا الحقل وبالتالي عندما يقوم المستخدم بإدخال قيمة للحقل يتم التحقق من توافق القيمة المدخلة مع الصيغة المحددة

كيفية اختيار صيغة القيمة في حال كان حقل الربط نصي:

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

كيفية اختيار صيغة القيمة في حال كان حقل الربط رقم:

1. قم بفتح إعدادات حقل الربط
2. قم بفتح قائمة خيارات صيغة القيمة حينها سيظهر:
   • رقم عام: وهو الخيار الافتراضي المفعل
   • نسبة مئوية يقوم المستخدم بتحديد صيغة الرقم على أنه نسبة مئوية ثابتة ويمكن للمستخدم:
     • تحديد الدقة (precision) وهي قيمة رقمية تحدد عدد المنازل العشرية بعد الفاصلة (من 0 إلى 3)، والقيمة الافتراضية هي 0.
     • تحديد شكل الإظهار (Display format) من قائمة منسدلة تحتوي على الخيارات التالية:
       • نسبة مئوية (Percentage) وهي القيمة الافتراضية
       • شريط تقدم (Progress bar)
       • شريط تقدم مع نسبة مئوية (Progress bar with percentage)

إعدادات قيمة الحقل

الحد الأدنى والحد الأقصى

تتيح خاصية تحديد الحد الأدنى والحد الأقصى للقيمة المدخلة في الحقل للمستخدمين ضبط قيود معينة على البيانات التي يمكن إدخالها في حقل معين، هذه الخاصية تضمن أن تكون القيم المدخلة ضمن النطاق المقبول وتساعد في الحفاظ على سلامة البيانات، إذا لم يتم تحديد قيم للحد الأدنى أو الحد الأقصى، فإن الحقل سيقبل أي قيمة ضمن نطاق نوع البيانات المحدد له.

كيفية إعداد الحد الأدنى والحد الأقصى للحقل

1. قم بفتح إعدادات الحقل
2. انتقل إلى إعدادات قيمة الحقل
3. قم بإدخال قيم لحقول الحد الأدنى والحد الأقصى:
   • الحد الأدنى: أدخل القيمة الأدنى التي يمكن قبولها في هذا الحقل.
   • الحد الأقصى: أدخل القيمة القصوى التي يمكن قبولها في هذا الحقل.

أمثلة على الاستخدام

مثال 1: حقل رقمي

إذا كان لديك حقل رقمي وتريد أن تكون القيم بين 1 و100: الحد الأدنى = 1 الحد الأقصى = 100 مثال 2: حقل نصي بطول محدد

إذا كان لديك حقل نصي وتريد أن يكون طول النص بين 5 و50 حرفاً: الحد الأدنى = 5 الحد الأقصى = 50

إظهار في القائمة

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

كيفية الاستخدام

1. قم بفتح إعدادات حقل الربط
2. قم بفتح قسم "إعدادات قيمة الحقل"
3. قم بفتح قسم "العرض".
4. قم بتفعيل خيار "إظهار في القائمة".

اجعل الحقل كـ

هذه الخاصية تسمح للمستخدم بتفعيل إحد الخيارات التالية:

1. عنوان رئيسي: وهو خاصية تسند إلى الحقل بحيث يصبح هو العنوان الرئيسي اقرأ المزيد من التفاصيل عن الارتباط الرئيسي.
2. عنوان فرعي 1
3. عنوان فرعي 2