النصوص والأرقام

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

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

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

يمكنك تغيير سلوك هذه الأنواع من الأسئلة وطريقة عرضها من خلال ضبط المظهر. للتحقق من تطبيقات الإرسال التي تدعم مظهراً معيناً، راجع المظهر.

مظهر النص

ملاحظة:‏

في Survey123 Mobile، لا يتم دعم سوى مظهر متعدد السطور للأسئلة النصية.

في تطبيق الويب Survey123، لا تُدعم مظاهر predictivetext وnopredictivetext.

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

ملاحظة:‏

بالنسبة للنماذج المستخدمة في التطبيق الميداني Survey123، يمكنك تعيين الارتفاع الافتراضي للمربع النصي متعدد الأسطر هذا عن طريق تعيين معلمة defaultHeight في العمود body::esri:style. على سبيل المثال، إدخال defaultHeight=5 في عمود body::esri:style سيعرض خمسة أسطر في مربع نص متعدد الأسطر عند فتح الاستطلاع. إذا لم يتم تعيين هذا، فسوف يعرض مربع نص متعدد الأسطر ثلاثة أسطر عند فتح الاستطلاع.

بتعيين المظهر على predictivetext أو nopredictivetext، سيجبر سؤال نصي هذا النص التنبؤي على التمكين أو التعطيل، على التوالي على أجهزة الجوال. تم تعطيل النص التنبؤي للأسئلة النصية افتراضيًا على Android، ما قد يؤدي إلى إلغاء تنشيط دالة تحويل الكلام إلى نص في بعض لوحات المفاتيح. قم بتطبيق مظهر النص التنبؤي على سؤال نصي لتمكين تحويل الكلام إلى نص لهذا السؤال. يتم تمكين النص التنبؤي افتراضيًا على iOS.

من خلال تعيين المظهر على التكويد الجغرافي، يُستخدم سؤال نصي للبحث عن عنوان مكود جغرافيًا وإرساله.

تتوفر المظاهر أيضًا للحصول على معرّف علامة InfraMarker والحصول على قيمة من أداة مقياس المسافة.

ابحث عن عنوان مكود جغرافيًا وأرسله

ملاحظة:‏

يصف هذا القسم وظائف متاحة فقط في التطبيق الميداني Survey123. هذه الوظائف غير متاحة في Survey123 Mobile.

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

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

لاستخراج خصائص معينة من كائن JSON، استخدم وظيفة pulldata("@json") الموجودة في عمود الحساب لسؤال آخر.

pulldata("@json", ${address}, "location.x")

pulldata("@json", ${address}, "searchCandidate")

يمكن إرجاع كائن JSON بالكامل في حقل نص فردي من خلال عدم تحديد خاصية فردية.

pulldata("@json", ${address})

لمزيد من المعلومات بشأن دالة pulldata("@json")، راجع موضوع استرداد قيمة من JSON.

ملاحظة:‏

التكويد الجغرافي باستخدام ArcGIS World Geocoding Service سوف يستهلك الاعتمادات. لمزيد من المعلومات، راجع فهم الاعتمادات.

لتعيين محدد موقع معين لإرجاع النتائج، قم بتوفير معرف عنصر محدد الموقع في عمود bind::esri:parameters، على سبيل المثال، geocode=36ff9e8c13e042a58cfce4ad87f55d19. يجب أن يكون محدد الموقع المُستخدم في استطلاع ArcGIS Online عنصرًا في ArcGIS Online. يجب أن يكون محدد الموقع المُستخدم في استطلاع ArcGIS Enterprise عنصرًا في نفس البوابة الإلكترونية للاستطلاع.

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

يمكنك التحكم بشكل أكبر في العرض التقديمي لسؤال مظهر تكويد جغرافي عن طريق تعيين إحدى المعلمات التالية في عمود body::esri:style:

ملاحظة:‏

المعلمات indicator وproximity وmaxResults وsuggestions غير مدعومة في تطبيق الويب Survey123.

• indicator—يتيح للنتائج المكودة جغرافيًا إظهار الاتجاه والمسافة من موقع الجهاز الحالي. يمكن تعيين هذه المعلمة إما على distance، أو direction، أو كلتا القيمتين مفصولتين بفاصلة، أو none. بشكل افتراضي، يتم تعيين هذه المعلمة لإظهار المسافة فقط.
• proximity—يتحكم فيما إذا كانت النتائج المكودة جغرافيًا لا تُظهر النتائج إلا في نطاق نصف قطر معين لموقع الجهاز. تقبل هذه المعلمة رقمًا متبوعًا بأي من الوحدات القياسية التالية: m (المتر) أو km (الكيلومتر) أو ft (القدم) أو mi (الميل) أو yd (الياردة). إذا لم يتم توفير وحدة، فسيتم تعيينه افتراضيًا على المتر. إذا تم التعيين على 0، فلن يتم احتساب التقارب في نتائج البحث. بشكل افتراضي، يتم تعيين هذه المعلمة على on، مما يسمح بفرز الاقتراحات حسب التقارب دون تصفية أي مواقع بسبب المسافة.
• maxResults—تحكم في الحد الأقصى لعدد النتائج المقدمة. على سبيل المثال، سيعود maxResults=10 بحد أقصى 10 نتائج ممكنة. بشكل افتراضي، يتم تعيين هذه المعلمة لعرض 6 نتائج كحد أقصى.
• suggestions - يعمل هذا كواجهة لعملية suggest في ArcGIS REST API. عند تعيين هذه المعلمة على yes، تتم تعبئة القائمة المنسدلة للمواقع المحتملة بواسطة عملية suggest. عند تعيين هذه المعلمة على no أو إذا كانت خدمة التكويد الجغرافي لا تدعم عملية suggest، فسيتم ملء قائمة المواقع المحتملة بواسطة عملية findAddressCandidates. افتراضيًا، يتم تعيين هذه المعلمة على yes.

الحصول على معرّف علامة InfraMarker

ملاحظة:‏

يصف هذا القسم وظائف متاحة فقط في التطبيق الميداني Survey123. هذه الوظائف غير متاحة في Survey123 Mobile.

استخدم المظاهر الموضحة أدناه لقراءة البيانات من علامة InfraMarker RFID أو كتابتها فيها.

من خلال تعيين عمود مظهر السؤال النصي على inframarker، يمكنك تحديد المعلومات المراد كتابتها في علامة. يمكن أن تتضمن هذه المعلومات assetOwner وassetName وlatitude وlongitude، ويمكن اشتقاق القيم من أسئلة أخرى في الاستطلاع. على سبيل المثال، يقوم التعبير التالي في عمود الحساب بكتابة الإجابات من أسئلة asset_name وasset_owner وlat وlong في العلامة:

concat("assetName=", ${asset_name}, "&assetOwner=", ${asset_owner}, "&latitude=", ${lat}, "&longitude=", ${long})

من خلال تعيين مظهر سؤال نصي آخر في نفس الاستطلاع إلى getinframarkerid، يتم استرداد معرف علامة InfraMarker 24 حرفًا الفريد وتخزينه في الاستطلاع.

لمزيد من المعلومات، راجع وثائق InfraMarker.

الحصول على قيمة من أداة مقياس المسافة (rangefinder)

ملاحظة:‏

يصف هذا القسم وظائف متاحة فقط في التطبيق الميداني Survey123. هذه الوظائف غير متاحة في Survey123 Mobile.

من خلال تعيين عمود المظهر إلى أداة مقياس المسافة، يمكن أن يقبل السؤال النصي إما كائن JSON الكامل أو قيمة محددة يتم إرجاعها من أداة مقياس المسافة. عند استخدامه لقبول كائن JSON بالكامل، يجب أن يحتوي هذا السؤال على bind::esri:fieldLength مضبوط على 1000 لضمان ملاءمة القيمة الكاملة.

عند تعيين المظهر إلى أداة مقياس المسافة لسؤال العدد الصحيح أو العشري، يمكن قبول قيمة معينة يتم إرجاعها من أداة مقياس المسافة. حدد القياس المراد تخزينه باستخدام إحدى القيم التالية في عمود bind::esri:parameters: height أو azimuth أو horizontalDistance أو slopeDistance أو inclination. على سبيل المثال، measurement=height سوف يخزن فقط قيمة الارتفاع التي يتم إرجاعها من أداة مقياس المسافة.

مظهر الأعداد الصحيحة

ملاحظة:‏

في Survey123 Mobile، لا يتم دعم سوى مظهر زيادة أو نقصان لأسئلة الأعداد الصحيحة.

في تطبيق الويب Survey123، لا يتم دعم أي من مظاهر الأعداد الصحيحة هذه.

بإعداد عمود المظهر إلى أداة الزيادة أو النقصان، سيتم عرض سؤال عدد صحيح مع أزرار لزيادة القيمة أو نقصانها بمقدار واحد. يؤدي تحديد الزر إلى تكرار التقدُّم حتى يتم تحرير الزر.

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

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

بتعيين المظهر على اضطراب، سيتم عرض سؤال عدد صحيح في صورة مقياس الاضطراب. مقياس الاستغاثة هو مقياس من 10 نقاط مستخدم لقياس المشاعر، مثل الضغط، الألم، والسعادة

مظهر الأعداد العشرية

ملاحظة:‏

في Survey123 Mobile، لا يتم دعم سوى مظهر زيادة أو نقصان لأسئلة الأعداد العشرية.

في تطبيق الويب Survey123، لا يتم دعم أي من مظاهر الأعداد العشرية هذه.

بإعداد عمود المظهر إلى أداة زيادة أو نقصان، سيتم عرض سؤال أعداد عشرية مع أزرار لزيادة الرقم الأخير بالقيمة أو نقصانه بمقدار واحد. يؤدي تحديد زر إلى تكرار التقدُّم حتى يتم تحرير الزر.

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

• 1.0 تزداد إلى 1.1، 1.2، 1.3، 1.4
• 3.07 تزداد إلى 3.08، 3.09، 3.10، 3.11
• 2.000000 تزداد إلى 2.000001، 2.000002، 2.000003

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

بتعيين المظهر على الحاسبة، سيكون سؤال العدد العشري المميز مصحوبًا بلوحة مفاتيح حاسبة مخصصة لإدخال القيمة وتعديلها.

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