حقل الخريطة

بإضافة حقل الخريطة (Map Field) إلى هيكل الكيان (Entity Structure)، يصبح بإمكان المستخدمين البحث و تعيين موقع على الخريطة بسهولة. يعرض هذا الحقل، الخريطة الجغرافية ويسمح للمستخدمين بتحديد الموقع المراد عبر النقر على الخريطة.

الاسم	الوصف	نمط البيانات
خريطة (Map)	حقل يسمح بتحديد الموقع على الخريطة.	GeoJson

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

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

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

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

1. اسم الحقل: هنا يجب تحديد اسم لحقل الخريطة مع الترجمة باللغة العربية والإنجليزية.

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

3. الوصف: اختياري ويمكن استخدامه لإضافة وصف لحقل الخريطة.

4. نوع البيانات: هنا يظهر نمط البيانات الذي يتم تخزينه في حقل الخريطة و هو في هاته الحالة : GeoJson.

القيمة الإفتراضية

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

القيمة الافتراضية

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

كيفية الاستخدام: في حالة الرغبة في استعمال التعبير البرمجي:

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

قفل الحقل

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

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

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

إخفاء الحقل

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

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

1. قم بتفعيل خاصية "إخفاء الحقل" من خلال الانتقال إلى إعدادات حقل الخريطة المراد إخفاؤه.
2. بعد تفعيلها، سيظهر حقل إضافي لإدخال التعبير البرمجي لتحديد شروط إخفاء حقل الخريطة.

مثال بسيط:

عند تفعيل حقل التحقق "مؤتمر"، سيتم إظهار حقل إدخال "الموقع" إضافي. وعند تعطيل هذا الزر، سيتم إخفاء حقل الموقع تلقائيًا.

مطلوب

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

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

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

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

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

قابل للتكرار

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

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

1. انتقل إلى "إعدادات حقل الخريطة" ثم إلى "إعدادات قيمة الحقل" المراد جعله قابلًا للتكرار.
2. تفعيل خاصية "قابل للتكرار".

تحديد الحد الأدنى والحد الأقصى للتكرار (اختياري):

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

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

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

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

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

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