توفر أعمدة Esri المخصصة لـ XLSForm وظائف إضافية لمستخدمي Survey123.
نوع الحقل
استخدم عمود bind::esri:fieldType المخصص للتحكم في نوع الحقل المراد إنشاؤه وطوله في ArcGIS لأسئلة الاستطلاع. لمزيد من المعلومات حول أنواع الحقول المدعومة، راجع أنواع بيانات حقل ArcGIS.
بالنسبة لبعض الأسئلة، يمكنك تغيير نوع الحقل الذي يتم تعيينه افتراضيًا بواسطة Survey123. ويسرد الجدول التالي بعض الأمثلة:
| نوع السؤال | نوع الحقل الافتراضي | تعليقات |
|---|---|---|
select_one | esriFieldTypeString | للتأكد من تخزين الاختيار كعدد صحيح، قم بالتغيير إلى esriFieldTypeInteger. |
date | esriFieldTypeDate | يتضمن esriFieldTypeDate دائمًا عنصرًا زمنيًا. لتخزين تاريخ فقط، قم بالتغيير إلى esriFieldTypeDate فقط. |
dateTime | esriFieldTypeDate | لا يعطي esriFieldTypeDate أي إشارة إلى المنطقة الزمنية. لتضمين المنطقة الزمنية في الحقل، قم بالتغيير إلى esriFieldTypeTimestampOffset. عند تعيين esriFieldTypeTimestampOffset، يتم عرض منتقي المنطقة الزمنية في النموذج الخاص بسؤال dateTime. سيتم تطبيق المنطقة الزمنية الحالية للجهاز بشكل افتراضي. |
time | esriFieldTypeString | لتخزين الوقت كقيمة زمنية، قم بالتغيير إلى esriFieldTypeTimeOnly. |
للتحكم في نوع الحقل، أدخل إحدى القيم التالية في عمود bind::esri:fieldType:
- esriFieldTypeString
- esriFieldTypeDate
- esriFieldTypeDateOnly
- esriFieldTypeTimeOnly
- esriFieldTypeTimestampOffset
- esriFieldTypeInteger
- esriFieldTypeBigInteger
- esriFieldTypeSingle
- esriFieldTypeDouble
- esriFieldTypeSmallInteger
- esriFieldTypePointZ
- esriFieldTypeGUID
لاحظ أن bind::esri:fieldType لا يتحكم إلا في نوع الحقل المنشأ في طبقة المعالم. للتحكم في نوع الحقل الخاص بسؤال أثناء الاستطلاع، استخدم عمود bind::type. على سبيل المثال، يؤدي توفير القيمة int في عمود bind::type الخاص بسؤال calculate إلى التعامل مع الحقل كعدد صحيح، بدلاً من نوع سلسلة الحقل الافتراضي الخاص به. فيما يلي القيم المقبولة بواسطة عمود bind::type:
- تهيئة
- عشري
- سلسلة
- تاريخ
- dateTime
- الوقت
يقبل العمود bind::esri:fieldType أيضًا القيمة null، مما يؤدي إلى حذف السؤال من طبقة المعالم التي تم إنشاؤها. في حين لا يزال السؤال موجود في الاستطلاع الخاص بك ويتصرف بشكل عادي، لا يتم إرسال الإجابة إلى طبقة المعالم ولن تكون موجودة عند مراجعة الاستجابات. يعد هذا مثاليًا للعمليات الحسابية أو القيود أو الأسئلة الأخرى التي يتعين أن تكون موجودة لأغراض العرض التقديمي لكن لا تكون مطلوبة في النتائج.
لا يدعم الأنواع التالية من الأسئلة نوع الحقل الفارغ:
- select_one or other
- select_multiple or other
- hidden
ملاحظة:
تدعم أسئلة النقطة الجغرافية والتتبع الجغرافي والشكل الجغرافي نوع حقل فارغ فقط إذا تضمن الاستطلاع سؤال نقطة جغرافية أو تتبع جغرافي أو شكل جغرافي واحد على الأقل لا يحتوي على نوع حقل فارغ، أو في حال تكرارها.
طول الحقل
استخدم عمود bind::esri:fieldLength المخصص للتحكم في طول حقول السلسلة (نص) المراد إنشاؤها في ArcGIS لأسئلة الاستطلاع.
ملاحظة:
لا يمكنك التحكم في أسئلة الأعداد الصحيحة والعشرية بهذه الطريقة. لا تحدد قواعد البيانات طول حقل رقمي؛ يخضع نطاق القيم الصالحة لنوع الحقل الرقمي. على سبيل المثال ، يخزن حقل الأعداد الصحيحة أي قيمة عدد صحيح بين -2,147,483,648 و2,147,483,647.
الأسماء المستعارة للحقل
يكتسب الاسم المستعار لحقل الاستطلاع نفس قيمة تسمية الحقل افتراضيًا، والمُشار إليها بالقيمة الرئيسية عند فتح الاستطلاع في ArcGIS. يمكنك تغيير ذلك بإدخال قيمة في عمود bind::esri:fieldAlias، والذي سيصبح عندئذ الاسم المستعار الجديد للحقل.
نظرًا لعدم عرض الأسئلة المخفية وأسئلة الحساب في نموذج، لا يتم الاحتفاظ بمحتويات حقل التسمية. هذا يعني أنه عند عرض سجلات الاستطلاع في موقع الويب Survey123 أو ArcGIS، فترى اسم السؤال معروضًا في عنوان العمود لأنواع الأسئلة هذه. لفرض عنوان العمود للأسئلة المخفية وأسئلة الحساب لعرض تسمية، استخدم عمود bind::esri:fieldAlias في جدول البيانات لتحديد تسمية.
قناع الإدخال
توفر أقنعة الإدخال تنسيقًا ثابتًا للسؤال النصي باستخدام الأحرف والرموز. عند تطبيق قناع مدخل على سؤال، يجب أن تتبع كل الاستجابات النمط المحدد بواسطة قناع الإدخال. في التطبيق الميداني وتطبيق الويب Survey123، لا يمكن إرسال إجابات الاستطلاع حتى يتم استيفاء جميع أقنعة الإدخال.
تلميح:
يمكن تطبيق أقنعة الإدخال فقط على نوع السؤال text. بالنسبة لأنواع الأسئلة integer أو decimal، استخدم العمود constraint لتقييد الإجابات. لمزيد من المعلومات، راجع موضوع القيود.
لتطبيق قناع إدخال على سؤالك، حدد القناع في العمود body::esri:inputMask المخصص. يذكر الجدول التالي الأحرف والرموز التي يمكنك استخدامها في قناع الإدخال:
| حرف | المعنى |
|---|---|
| A | مطلوب حرف ASCII أبجدي. يمكن أن تكون الرموز من A إلى Z ومن a إلى z. |
| آر | مسموح بحرف ASCII أبجدي، ولكن غير مطلوب. |
| N | مطلوب حرف ASCII أبجدي. يمكن أن تكون الرموز من A إلى Z ومن a إلى z ومن 0 إلى 9. |
n | مسموح بحرف ASCII أبجدي، ولكن غير مطلوب. |
X | مطلوب أي حرف غير فارغ. |
x | مسموح بأي حرف غير فارغ ولكنه غير مطلوب. |
| 9 | مطلوب رقم ASCII. يمكن أن تكون الأرقام من 0 إلى 9. |
0 | مسموح برقم ASCII، ولكن غير مطلوب. يمكن أن تكون الأرقام من 0 إلى 9. |
| D | مطلوب رقم ASCII. يمكن أن تكون الأرقام من 1 إلى 9. |
d | مسموح برقم ASCII، ولكن غير مطلوب. يمكن أن تكون الأرقام من 1 إلى 9. |
# | مسموح برقم ASCII أو علامة زائد أو ناقص، ولكن غير مطلوب. |
| H | مطلوب حرف سداسي عشري. يمكن أن تكون الرموز من A إلى F ومن a إلى f ومن 0 إلى 9. |
ساعة | مسموح بأي حرف سداسي عشري، ولكن غير مطلوب. |
| B | مطلوب رقم ثنائي. يمكن أن تكون الرموز من 0 إلى 1. |
b | مسموح بأي حرف ثنائي، ولكن غير مطلوب. |
| > | كل الأحرف الأبجدية التالية هي أحرف كبيرة. |
| < | كل الأحرف الأبجدية التالية هي أحرف صغيرة. |
| ! | إيقاف تشغيل تحويل الحالة. |
| \ | إلغاء الأحرف الخاصة المدرجة أعلاه لاستخدامها كفواصل. |
يتكون القناع من سلسلة من الأحرف والفواصل، متبوعة اختياريًا بفاصلة منقوطة لإنهاء قناع الإدخال وحرف يتم استخدامه للفراغات. تتم إزالة الأحرف الفارغة من النص بعد التحرير. يُدرج الجدول التالي أمثلة على الأقنعة:
| مثال على قناع | الوصف |
|---|---|
| >A<xxxxxxxxxxxx | النص الذي يبدأ بحرف كبير متبوع بأي أحرف صغيرة. |
| AAA-AAA-AAA;_ | المعرف الفريد الذي يستخدم الشرطات كفواصل، مع فاصلة منقوطة في نهاية قناع الإدخال متبوعة بشرطة سفلية لتمثيل كل حرف يتم إكماله. |
| B9.99;- | يمثل قيمة pH. يتم تقييد الرقم للبدء بـ 0 أو 1، ويمكن أن يتضمن خانتين عشريتين اثنتين فقط. تنهي الفاصلة المنقوطة قناع الإدخال، متبوعة بشرطة تستخدم لتمثيل كل حرف يتم إكماله. |
| 999-99-9999 | رقم الضمان الاجتماعي - الولايات المتحدة. |
| (999) 999-9999 | رقم الهاتف - الولايات المتحدة |
| 900 كغم | الوزن بالكيلوغرام بين 0 و999. |
| 99999 | كود ZIP من 5 أرقام- الولايات المتحدة. |
| AAA | كود مطار IATA. |
سير العمل
استخدم العمود المخصص bind::esri:workflow للإشارة إلى إمكانية ملء الحقل من تجانب Rangefinder التي تم إطلاقها من المعرض. هذا العمود مدعوم فقط من خلال الأسئلة النصية، ويتم قبول القيم التالية بواسطة عمود bind::esri:workflow:
- rangefinderMode=height
- rangefinderMode=offset
- rangefinderMode=height,offset
- rangefinderHeight
تتيح كل قيمة rangefinderMode تجربة مستخدم مماثلة للعامل الميداني. بمجرد تحديد سير عمل مقياس المسافة المطلوب، يتم توجيه المستخدم لتحديد استطلاع والتقاط من 1 إلى 3 لقطات باستخدام الأداة، ثم يتم تشغيل استطلاع تلقائيًا للعامل الميداني لإكمال أي أسئلة أخرى.
تعتبر قيمة rangefinderHeight فريدة من نوعها، حيث أنها تسمح للعامل الميداني باستعراض كل سؤال استطلاع تم تكوينه لتلقي قيمة الارتفاع، باستخدام الأسهم للأمام والخلف. بمجرد قياس جميع الارتفاعات، ينقر العامل الميداني على تم وينتقل إلى الاستطلاع لإكمال أي أسئلة أخرى.