ArcGIS Survey123 يدعم كمية كبيرة من مواصفات XLSForm. يوفر هذا الدليل الإرشادي المرجعي ملخصًا لمزايا XLSForm التي يمكن استخدامها في Survey123. يمكن إنشاء الاستطلاعات في Survey123 Connect أو موقع ويب Survey123، ولا تتوفر بعض المزايا إلا في أحدهما أو الآخر، فيما يتوفر بعضها في كليهما.
أنواع الأسئلة
يصف الجدول التالي أنواع الأسئلة المتوفرة عبر تطبيق Survey123 Connect الميداني Survey123 ومصمم الويب Survey123 وتطبيق الويب Survey123. في بعض الأسئلة، توجد اختلافات في السلوك والتنفيذ عبر الأنظمة الأساسية؛ للاختلافات، راجع الملاحظات بعد الجدول.
| نوع سؤال Survey123 Connect | نوع سؤال مصمم الويب Survey123 | الوصف | مدعوم في تطبيق Survey123 الميداني | مدعوم في تطبيق Survey123 على الويب |
|---|---|---|---|---|
| مقطع صوتي⁴ | مقطع صوتي⁴ ⁶ | يسجل مقطعًا صوتيًا في التطبيق الميداني. يسجل مقطعًا صوتيًا أو يقبل ملفًا صوتيًا تم تحميله في تطبيق الويب. | نعم | نعم |
| الرمز الشريطي | يمسح الرمز الشريطي أو رمز الاستجابة السريعة ضوئيًا. | نعم | نعم | |
| بدء مجموعة | بدء مجموعة أسئلة. | نعم | نعم | |
| بدء التكرار | غير متوفر | بدء مجموعة من الأسئلة المكررة. | نعم | نعم |
| حساب | غير متوفر | يقوم بتنفيذ عملية حسابية على القيم الموجودة في النموذج. يحتوي حقل الحساب على ناتج الحساب. | نعم | نعم |
| عشري¹ | إدخال عدد عشري. | نعم | نعم | |
| تاريخ | إدخال التاريخ. | نعم | نعم | |
| dateTime | إدخال التاريخ والوقت. | نعم | نعم | |
| deviceid | غير متوفر | تمثل UUID جهازًا محددًا تم أخذ الاستطلاع عليه. | نعم | لا |
| البريد الإلكتروني² | غير متوفر | عند تسجيل الدخول بحساب مؤسسي، يتم تعبئة هذا السؤال تلقائيًا بعنوان البريد الإلكتروني للحساب. | نعم | نعم |
| إنهاء | غير متوفر | تاريخ إنهاء الاستطلاع ووقته. | نعم | نعم |
| إنهاء مجموعة | إنهاء مجموعة أسئلة. | نعم | نعم | |
| إنهاء التكرار | غير متوفر | إنهاء مجموعة من الأسئلة المكررة. | نعم | نعم |
| الملف | يقبل ملفًا على الجهاز. | نعم | نعم | |
| نقطة جغرافية³ | جمع إحداثيات GPS محددة. يرتبط هذا بشكل افتراضي بالموقع الحالي. | نعم | نعم | |
| الشكل الجغرافي³ | يجمع مضلعًا على خريطة. | نعم | نعم | |
| التتبع الجغرافي³ | يجمع خطًا على خريطة. | نعم | نعم | |
| مخفي | غير متوفر | إنشاء حقل في طبقة المعالم لا يتم عرضه في النموذج. استخدم عمودي bind::esri:fieldType وbind::esri:fieldLength لتحديد مخطط بيانات هذا الحقل. | نعم | نعم |
| عدد صحيح¹ | إدخال عدد بالكامل. | نعم | نعم | |
| صورة | الموافقة على صورة من ملفات الجهاز أو صورة يتم التقاطها مباشرةً. | نعم | نعم | |
| ملحوظة | عرض نص على الشاشة. يمكن للملاحظة أيضًا التعامل مع العمليات الحسابية المخفية. | نعم | نعم | |
| نطاق | شريط تمرير⁶ | إدخال نطاق معين من الأرقام. | نعم | نعم |
| تصنيف list_name | سؤال التصنيف؛ يتطلب قائمة اختيارات. استبدل list_name باسم قائمة اختيارك. | نعم | نعم | |
| select_one list_name | قائمة منسدلة⁵ ⁶، مقياس Likert⁵ ⁶، تصنيف⁶، اختيار واحد⁶، شبكة اختيار واحد⁶ | سؤال اختيار متعدد؛ يمكن فقط تحديد إجابة واحدة. استبدل list_name باسم قائمة اختيارك. | نعم | نعم |
| select_one_from_file file_name.csv | غير متوفر | سؤال اختيار متعدد؛ يمكن فقط تحديد إجابة واحدة. استبدل file_name.csv باسم الملف الموجود في مجلد وسائط الاستطلاع الذي يضم قائمة من الاختيارات. | نعم | نعم |
| select_multiple list_name | سؤال اختيار متعدد؛ يمكن تحديد إجابات متعددة. استبدل list_name باسم قائمة اختيارك. | نعم | نعم | |
| select_multiple_from_file file_name.csv | غير متوفر | سؤال اختيار متعدد؛ يمكن تحديد إجابات متعددة. استبدل file_name.csv باسم الملف الموجود في مجلد وسائط الاستطلاع الذي يضم قائمة من الاختيارات. | نعم | نعم |
| بدء | غير متوفر | تاريخ بدء الاستطلاع ووقته. | نعم | نعم |
| النص | العنوان⁶، البريد الإلكتروني⁶، نص متعدد السطور⁶، نص مفرد السطر⁶، موقع الويب⁶ | استجابة نص حر يتم تطبيق تعبير عادي على البريد الإلكتروني وموقع الويب. ينطبق مظهر التكويد الجغرافي على العنوان. | نعم | نعم |
| الوقت | إدخال الوقت. | نعم | نعم | |
| اسم المستخدم | غير متوفر | عند تسجيل الدخول بحساب مؤسسي، يتم تعبئة هذا السؤال تلقائيًا باسم مستخدم الحساب. | نعم | نعم |
¹يجمع مصمم الويب بين أسئلة الأعداد الصحيحة والعشرية في نوع سؤال واحد يسمى "العدد". تتيح الخانة في خصائص السؤال لمصمم الاستطلاع تحديد المدخلات المطلوبة.
²يتم تنفيذ أنواع سؤال البريد الإلكتروني في Survey123 Connect ومصمم الويب Survey123 بشكل مختلف. يقوم التنفيذ المتوفر في Survey123 Connect بالتعبئة تلقائيًا باستخدام عنوان البريد الإلكتروني للحساب المؤسسي الذي سجل إليه المستخدم الدخول. يتوفر التنفيذ المتوفر في مصمم Survey123 على الويب بدلاً من حقل نصي لا يقبل إلا تنسيق يطابق عنوان بريد إلكتروني.
³تم دمج أسئلة النقطة الجغرافية والتتبع الجغرافي والشكل الجغرافي في نوع سؤال فردي يعرف باسم "الخريطة". تتيح الخانة في خصائص السؤال لمصمم الاستطلاع تحديد المدخلات المطلوبة. يتيح نوع السؤال الإضافي المعروف باسم العنوان إرسال النقاط المكودة جغرافيًا.
⁴لا تسمح الأسئلة الصوتية بالتحميل في التطبيق الميداني Survey123 كما تفعل في تطبيق الويب. للسماح بتحميل مقطع صوتي في التطبيق الميداني، استخدم سؤالاً ملفيًا.
⁵تعد العديد من المظاهر المتاحة في Survey123 Connect بديلاً متاحًا كأنواع أسئلة منفصلة في مصمم الويب Survey123. وتشمل هذه نصًا متعدد الخطوط وقائمة منسدلة ومقياس Likert.
⁶لكل سؤال، يوفر مصمم الويب خيارًا لتخزين الإجابة مؤقتًا. في تطبيق الويب، بعد إرسال سجل الاستطلاع، سيتم تخزين الإجابة على السؤال مؤقتًا في المتصفح وتحميلها مسبقًا في الإرسال التالي الذي تم إجراؤه لهذا الاستطلاع على هذا الجهاز. يمكن تعيين التخزين المؤقت للإجابة لجميع أنواع الأسئلة باستثناء الصورة وتحميل الملف والتوقيع.
أعمدة ورقة عمل الاستطلاع
يحتوي الجدول التالي على كل الأعمدة المدعومة من Survey123. هذه الأعمدة مضمنة في ورقة عمل الاستطلاع في القالب المتقدم وهي مسردة في هذا الجدول بالترتيب الذي تظهر به في ورقة العمل.
| عمود | الوصف |
|---|---|
| النوع | حدد نوع سؤال من القائمة المتاحة. أدخل اسم قائمة صالح عند استخدام سؤال select_one أو select_multiple. |
| اسم | اسم الحقل في طبقة المعالم. |
| تسمية | تسمية السؤال المعروضة في الاستطلاع. |
| تلميح | المعلومات التي يمكن أن تساعد في الإجابة على سؤال الاستطلاع. |
| guidance_hint | معلومات إضافية، لا تظهر إلا بعد الضغط على أيقونة. |
| المظهر | حدد مظهر هذا الحقل في الاستطلاع. |
| مطلوب | حدد نعم لطلب قيمة في هذا الحقل قبل استكمال الاستطلاع. |
| required_message | عند لا يوجد رد في حقل مطلوب، ستظهر الرسالة في هذا العمود لمطالبتك بالإجابة. |
| للقراء فقط | حدد نعم لتعيين القيم في هذا الحقل على القراءة فقط. يتعذر تحرير هذه القوالب في الاستطلاع. |
| الافتراضي | عيّن القيمة الافتراضية لهذا الحقل. سيعمل ذلك على تعبئة الاستطلاع بالقيمة الافتراضية. يمكن استخدام ذلك لتوفير الوقت سواء بإمداد إجابة شائعة الاستخدام أو بعرض نوع اختيار الاجابة المتوقع. |
| الحساب | قم بإجراء العمليات الحسابية باستخدام قيم الأسئلة السابقة (على سبيل المثال، ${number} * 100). قم بالإشارة إلى حقل الحساب لعرض النتيجة (على سبيل المثال، The answer is ${calc}). |
| قيد | قم بتقييد نطاق الأرقام التي يمكن إدخالها (على سبيل المثال، .>0 و.<100). يمكن استخدامها مع جميع أنواع الأسئلة. |
| constraint_message | عند عدم استيفاء شروط القيود، ستظهر هذه الرسالة لتطالبك بإجابة صالحة. |
| ذو صلة | يتيح لك ذلك تخطي الأسئلة أو إجراء أسئلة إضافية تظهر على أساس الرد على سؤال سابق. يصبح السؤال مرئيًا من خلال استيفاء الشروط في العمود ذي الصلة (على سبيل المثال، ${name} = 'value'). يرسل السؤال المخفي بواسطة هذا العمود القيم الخالية فقط. |
| choice_filter | عند استخدام التحديدات المتتالية، يحتفظ هذا الحقل بالتعبير لمطابقة أعمدة السمات الإضافية في علامة تبويب الاختيارات (على سبيل المثال، attribute = ${value}). |
| repeat_count | تحدد هذه القيمة عدد السجلات المتوفرة في تكرار ما. بمجرد تحديد عدد التكرار، لا يمكن إضافة السجلات إلى تكرار أو حذفها منه. |
| media::audio | انسخ ملف صوتي إلى مجلد الوسائط الفرعي لمشروعك واكتب اسم ملف الصوت (على سبيل المثال، audio.mp3) لتقديم صوت مع سؤالك. |
| media::image | انسخ ملف صورة إلى مجلد الوسائط الفرعي لمشروعك واكتب اسم ملف الصورة (على سبيل المثال، image.jpg) لعرض صورة مع سؤالك. |
| bind::type | نوع حقل يستبدل نوع الحقل الافتراضي للسؤال. |
| bind::esri:fieldType | حدد نوع الحقل الهدف في طبقة المعلم. يمكن استخدام ذلك لاستبدال نوع الحقل الافتراضي (على سبيل المثال، حقلي "حساب" وselect_one هي سلاسل بشكل افتراضي. لحفظ القيم في طبقة المعلم كأعداد صحيحة، حدد esriFieldTypeInteger). |
| bind::esri:fieldLength | حدد طول الحقل الهدف في طبقة المعلم. يمكنك استخدام ذلك لاستبدال طول الحقل الافتراضي. |
| bind::esri:fieldAlias | أدخل قيم الاسم المستعار للحقل في طبقة المعالم. يمكنك استخدام ذلك لاستبدال قيم الاسم المستعار الافتراضية للحقل، والمشتقة من تسمية السؤال. |
| body::esri:style | قدم تعبيرات لتحديد نمط السؤال وسلوكه (على سبيل المثال، لون الخلفية للمجموعات والتكرارات). |
| bind::esri:parameters | قدم معلمات لسؤال مخصص لـ Survey123 (على سبيل المثال، معلمات التحكم في سلوك التكرارات عند تحرير استطلاعك). |
| bind::esri:workflow | يوفر معلمات لتمكين المسح ليكون متاحًا لوضع قياس مقياس المسافة. |
| المعلمات | قدم معلمات XLSForm القياسية لسؤال ما (على سبيل المثال، معلمات start وend وstep لسؤال النطاق). |
| body::accept | قم بتعيين أنواع الملفات المقبولة لسؤال الملف. لقبول امتدادات الملفات، بامتدادات ملفات متعددة مفصولة بفواصل (على سبيل المثال، .jpg, .png). |
| body::esri:visible | يتيح لك ذلك تخطي الأسئلة أو إجراء أسئلة إضافية تظهر على أساس الرد على سؤال سابق. يصبح السؤال مرئيًا بتلبية الشروط في عمود body::esri:visible (على سبيل المثال، ${name} = 'value'). لا يزال السؤال المخفي بواسطة هذا العمود يحتوي على قيم ويقوم بإرسالها. |
| body::esri:inputMask | وفر تعبيرًا لاستخدام قناع الإدخال لتوفير تنسيق مجموعة لإدخال البيانات باستخدام الأحرف والرموز. |
| label::language (xx) | وفر الترجمات لتسميات السؤال. يجب تحديد اللغة حسب اسمها وكودها (على سبيل المثال، label::Español (es)). أضف عمودًا جديدًا لكل لغة. ستظهر قائمة اللغات في قائمة منسدلة في الاستطلاع. |
| hint::language (xx) | وفر الترجمات لتلميحات السؤال. يجب تحديد اللغة حسب اسمها وكودها (على سبيل المثال، hint::Español (es)). أضف عمودًا جديدًا لكل لغة. ستظهر قائمة اللغات في قائمة منسدلة في الاستطلاع. |
| guidance_hint::language (xx) | وفر الترجمات للتلميحات الإرشادية. يجب عليك تحديد اللغة حسب اسمها وكودها (على سبيل المثال، guidance_hint::Español (es)). أضف عمودًا جديدًا لكل لغة. ستظهر قائمة اللغات في قائمة منسدلة في الاستطلاع. |
| required_message::language (xx) | قدم ترجمات للرسالة التي تظهر إذا لم تتم الإجابة عن السؤال المطلوب. يجب تحديد اللغة حسب اسمها وكودها (على سبيل المثال، required_message::Español (es)). أضف عمودًا جديدًا لكل لغة. ستظهر قائمة اللغات في قائمة منسدلة في الاستطلاع. |
| body::accuracyThreshold | قم بتوفير قيمة رقمية للحد (بالأمتار) الذي لن يتم قبول قيم الموضع إذا تجاوزته. ينطبق على النقطة الجغرافية والنقاط القممية لأسئلة الشكل الجغرافي والتتبع الجغرافي. |
| bind::esri:warning | طبّق تعبيرًا يعرض التحذيرات إذا لم يتم استيفاء الشروط. |
| bind::esri:warning_message | الرسالة التي تظهر إذا لم تتم تلبية شروط bind::esri:warning. |
| bind::saveIncomplete | قم بالتعيين على صحيح إذا كان التطبيق يحفظ الرد تلقائيًا بعد السؤال. |
المظاهر
يمكنك إدخال القيم التالية في عمود المظهر لأنواع محددة من الأسئلة لتبديل كيفية ظهورها أو ماهية سلوكها. لمزيد من المعلومات عن كل منها، راجع موضوع المظهر.
| المظهر | نوع أسئلة قابل للتطبيق | الوصف | مدعوم في تطبيق Survey123 الميداني | مدعوم في تطبيق Survey123 على الويب |
|---|---|---|---|---|
| إضافة تعليق توضيحي | صورة | يتيح للمستخدم فتح نافذة لوحات للرسم عليها، والتي تدعم أيضًا التعليق التوضيحي على الصور. | نعم | نعم |
| اكتمال تلقائي | select_one | تظهر خيارات الإجابة في قائمة منسدلة بإدخال نصي لتضييق الخيارات. | نعم | نعم |
| الحاسبة | رقم صحيح، عشري | يعرض عنصر واجهة مستخدم حاسبة مخصصة لهذا السؤال. | نعم | لا |
| مدمج | select_one، select_multiple، بدء التجميع، بدء تكرار | بالنسبة لأسئلة select_one و select_multiple، تعرض الاختيارات أفقيًا بطريقة موفرة للمساحة. بالنسبة للمجموعات والتكرارات، تعرض الأسئلة في حالة مطوية عند بدء التشغيل، الذي يمكن للمستخدم توسيعه. | نعم | نعم |
compact-n | select_one وselect_multiple | تعرض الاختيارات أفقيًا بطريقة موفرة للمساحة، مع تحديد أقصى عدد من الأعمدة بواسطة n. على سبيل المثال، تحدد أداة Compact-3 السؤال بثلاثة أعمدة كحد أقصى. | نعم | نعم |
| خطر | عدد صحيح | يعرض السؤال كمقياس تمرير مُلون. | نعم | لا |
| رسم | صورة | يتيح للمستخدم فتح نافذة لوحات للرسم عليها. | نعم | نعم |
| قائمة الحقول | بدء التجميع، بدء التكرار | تعرض مجموعة أسئلة في صفحة منفصلة عند تعيين نمط الاستطلاع إلى صفحات. | نعم | نعم |
التكويد الجغرافي | النص | ابحث عن عنوان مكود جغرافيًا وأرسله. | نعم | نعم |
com.getinframarkerid | النص | قم باسترجاع وتخزين معرف علامة InfraMarker الفريد المكون من 24 حرفًا. | نعم | لا |
مخفي | الكل | يخفي السؤال من العرض في حين الاستمرار في قبول الإعدادات الافتراضية والحسابات. | نعم | نعم |
| إخفاء المدخلات | نقطة جغرافية | قم بطي قسم إدخال الإحداثيات عند فتح الاستطلاع في تطبيق الويب. | لا | نعم |
| أفقي | select_one وselect_multiple | يعرض خيارات الإجابة أفقيًا وفي أعمدة. | نعم | نعم |
| أفقي-مدمج | select_one وselect_multiple | مثل المظهر المدمج. | نعم | نعم |
| خريطة الصورة | select_one وselect_multiple | يعرض صورة .svg مرفقة مع مناطق محددة. | نعم | لا |
inframarker | النص | قدِّم المعلومات المراد كتابتها إلى علامة InfraMaker. | نعم | لا |
| likert | select_one | يجعل خيارات الإجابة تظهر كمقياس Likert. | نعم | نعم |
| الأدنى | select_one، select_multiple، الرمز الشريطي، بدء تكرار | تمثيل العديد من الاستجابات (select_one, select_multiple) والعديد من الأسئلة (التكرارات) ومربع نصي (كود شريطي) في نمط مخفي أو مُصغّر. | نعم | نعم |
| الحد الأدنى للضغط | بدء التكرار | يمثل الأسئلة داخل التكرار في صورة كل من المطوي (الضغط) والمخفي (الحد الأدنى). | نعم | نعم |
| شهر-سنة | تاريخ | يحدد شهر وسنة التاريخ. | نعم | نعم |
| متعدد السطور | النص، الصورة، الملف | لتقديم سؤال نصي كمربع نص متعدد السطور. يسمح بمرفقات متعددة لسؤال صورة أو ملف. | نعم | نعم |
الواجهة الأمامية الجديدة | صورة | لتقييد السؤال على التقاط صورة فقط، باستخدام الكاميرا الأمامية كإعداد افتراضي. | نعم | لا |
الواجهة الخلفية الجديدة | صورة | لتقييد السؤال على التقاط صورة فقط، باستخدام الكاميرا الخلفية كإعداد افتراضي. | نعم | لا |
no-ticks | نطاق | لعرض شريط تمرير النطاق دون مواضع أو قيم دنيا أو قيم قصوى. | نعم | نعم |
nopredictivetext | النص | لتعطيل النص التنبؤي للأجهزة المحمولة. | نعم | لا |
| أرقام | رقم صحيح، عشري | يعرض لوحة مفاتيح رقمية مخصصة لهذا السؤال. | نعم | لا |
predictivetext | النص | لتمكين النص التنبؤي للأجهزة المحمولة. | نعم | لا |
اضغط لتحديد الموقع | النقطة الجغرافية والتتبع الجغرافي والشكل الجغرافي | بالنسبة لأسئلة النقطة الجغرافية، لا تقبل الموقع إلا بعد تفاعل المستخدم مع السؤال. يالنسبة لسؤال التتبع الجغرافي أو الشكل الجغرافي، يركز السؤال على موقع المستخدم دون التقاط نقطة عند التفاعل لأول مرة مع السؤال. | للنقاط الجغرافية فقط | نعم |
rangefinder | النص | يقبل إما كائن JSON الكامل أو قيمة محددة يتم إرجاعها من أداة تحديد المدى. | نعم | لا |
بحث | النص | يملأ قائمة الاختيار بقيم من جدول CSV في مجلد وسائط الاستطلاع، أو طبقة معالم موجودة أو جدول. | نعم | لا |
| التوقيع | صورة | تُمثّل واجهة مستخدم لالتقاط التوقيع. يتم إضافة التوقيع إلى المعلم كمرفق. | نعم | نعم |
إدخال خاص | صورة | يتطلب جهاز Spike وتطبيق Spike. يستخدم تكامل Spike لقياس المسافة والموقع في صورة. | نعم | لا |
قياس spike كامل | صورة | يتطلب جهاز Spike وتطبيق Spike. يستخدم تكامل Spike لقياس المسافة والموقع والمنطقة والأطوال في صورة. | نعم | لا |
نقطة إلى نقطة Spike | صورة | يتطلب جهاز Spike وتطبيق Spike. يستخدم تكامل Spike لقياس المسافة بين نقطتين مصورتين. | نعم | لا |
| زيادة أو نقصان | رقم صحيح، عشري | يضيف أزرارًا لزيادة القيمة وتقليلها. | نعم | لا |
قائمة الجدول | بدء مجموعة | لتقديم مجموعة من أسئلة select_one داخل مجموعة بقائمة اختيار شائعة بتنسيق جدول. | نعم | نعم |
| thousands-sep | عشري | لعرض الإجابات بفواصل الآلاف. ينطبق على الإجابات المعبأة مسبقًا فقط. | نعم | لا |
| أسبوع-رقم | تاريخ | يحدد رقم الأسبوع. | نعم | لا |
| عام | تاريخ | يحدد سنة التاريخ فقط. | نعم | نعم |
المعلمات
تحتوي بعض أنواع الأسئلة في XLSForm على معلمات إضافية تسمح لك بالتحكم في أسلوب أو سلوك الأسئلة في الاستطلاع. في بعض الحالات، تكمل هذه المعلمات المظاهر التي يدعمها نوع السؤال. للحصول على نظرة عامة حول المعلمات التي يدعمها كل نوع من أنواع الأسئلة، راجع معلمات XLSForm.
القيم الافتراضية
يقوم إدخال اليوم() في عمود الافتراضي في سؤال تاريخ بتعيين القيمة الافتراضية لتاريخ اليوم.
أدخل اسم الاختيار (وليس تسمية الاختيار) للقيم الافتراضية لأسئلة Select_one.
تعمل الاستجابات إلى نوع أسئلة select_multiple بشكل يختلف عن بعضها البعض؛ بإدخال كل إجابة تم التأشير عليها بنفس ترتيب تحديدها مفصولة بفاصلة. لتحديد العديد من القيم في صورة أوضاع افتراضي في سؤال select_multiple ، افصل بينها بفواصل، على سبيل المثال item1,item2,item3.
التحقق من صحة البيانات
إدخال نعم كقيمة في العمود المطلوب يتسبب في أن يتطلب سؤال الاستطلاع احتواء السؤال على قيمة قبل اكتمال النماذج.
العوامل
يمكن استخدام المشغلات المدرجة في الجدول التالي في أعمدة XLSForm التي تدعم التعبيرات، بما فيها القيد والحساب والأعمدة ذات الصلة.
لمزيد من المعلومات بشأن الحسابات والقيود، راجع موضوع الصيغ، وللمزيد عن استخدام العمود ذي الصلة، راجع موضوع تعبيرات النموذج.
| مُشغل | الوصف | مثال |
|---|---|---|
| . | الإجابة الحالية | .=1 |
| + | إضافة | ${question_one} + 4 |
| - | طرح | ${question_one} - 4 |
| * | علامة الضرب | ${question_one} * 4 |
| div | تقسيم | ${question_one} div 4 |
| = | مساوي | ${price}=9.80 |
| != | غير مساوي | ${price}!=9.80 |
| < | أقل من | ${price}<9.80 |
| <= | أقل من أو يساوي | ${price}<=9.80 |
| > | أكبر من | ${price}>9.80 |
| >= | أكبر من أو يساوي | ${price}>=9.80 |
| and | و | ${price}>9.00 and ${price}<9.90 |
| mod | النموذج (القسمة المتبقية) | ${question_one} mod ${question_two} |
| or | أو | ${price}=9.80 or ${price}=9.70 |
الدوال
الوظائف التالية مدعومة في Survey123:
| وظيفة | الوصف | مثال |
|---|---|---|
| boolean(question, expression, or value) | إرجاع صحيح إذا كانت القيمة المقدمة غير فارغة. يوصى باستخدام boolean-from-string() بدلاً من ذلك. تنبيه:ستُرجع هذه الدالة دائمًا "صواب" في تطبيق Survey123 على الويب. للاطلاع على البدائل، راجع القيم الفارغة. | boolean(${question_one}) |
| boolean-from-string() | إرجاع صحيح إذا كانت السلسلة المقدمة 'صحيحة' أو تساوي '1'. وبخلاف ذلك يكون الإرجاع خطأ. | boolean-from-string(${question_one}) |
| coalesce(value1, value2) | يعود بالقيمة الأولى غير الفارغة. تدعم هذه الدالة قيمتين فقط. | coalesce(${question_one}, ${question_two}) |
| concat(value1, value2, …) | إرجاع السلسلة من قيم السلسلة. | concat(${question_one}, ' and ', ${question_two}) |
| contains(string, substring) | إرجاع صحيح إذا كانت السلسلة المقدمة تتضمن سلسلة فرعية. | contains(${question_one}, 'red') |
| count(repeat) | يعود بكمية الاستجابات إلى السؤال المحدد عبر التكرارات. لمزيد من المعلومات، راجع دوال التجميع. ملاحظة:عند استخدام هذه الدالة في تطبيق Survey123 الميداني، يمكن وضعها داخل التكرار أو خارجه. في حال عدم استخدام الدالة في تطبيق ويب Survey123، يلزم وضعها خارج التكرار. يمكن الإشارة إلى قيمة العدد من خارج التكرار في عملية حسابية داخل التكرار. | count(${question}) |
| count-selected(question) | لعرض عدد الإجابات المحددة لأسئلة select_one و select_multiple. تُرجع هذه الدالة أيضًا عدد الملفات المرفقة لأسئلة الصور والصوت والملفات باستخدام المظهر المتعدد الأسطر. | count-selected(${question_one}) |
| date(question, expression, or value) | تحويل رقم أو سلسلة إلى كائن تاريخ، دون الاحتفاظ بالتاريخ. | date('2017-05-28T04:39:02+10:00') |
| date-time(question, expression, or string) | تحويل رقم أو سلسلة إلى كائن تاريخ. | date-time('2017-05-28T04:39:02+10:00') |
| تحويل كائن تاريخ إلى رقم وقت-تاريخ عشري. | decimal-date-time(${date_question}) | |
| decimal-time(question, expression, or string) | تحويل كائن زمني إلى رقم يمثل يومًا جزئيًا في المنطقة الزمنية للجهاز. | decimal-time(${time_question}) |
| ends-with(string, substring) | إرجاع صحيح إذا كانت السلسلة المقدمة تنتهي بسلسلة فرعية. | ends-with(${question_one}, 'hand.') |
| false() | خطأ | false() |
يلائم قيمة التاريخ أو الوقت الحالية لتنسيق محدد. | format-date(${previous_time}, '%H:%M') | |
| if(condition, a, b) | إذا تم تقييم الشرط إلى صحيح، يتم إرجاع أ؛ خلاف ذلك، يتم إرجاع ب. | if(selected(${question_one}, 'yes') and selected(${question_two}, 'yes'), 'yes', 'no') |
مكرر مفهرس (سؤال، تكرار، رقم فهرس) | ترجع القيمة من سؤال محدد في سجل مكرر. للحصول على مزيد من المعلومات، راجع التكرارات. | indexed-repeat(${room_no}, ${floor}, 3) |
| int(question, expression, or value) | تحويل إلى عدد صحيح. يتنوع التحويل بناءً على نوع البيانات. ملاحظة:إذا كانت هذه الوظيفة فارغة، فستعيد NaN وسيظل السؤال فارغًا. | int(${question_one}) |
| join(separator, question) | يسلسل كل الإجابات إلى سؤال محدد في تكرار، مفصول بفاصلة محددة. | join(',', ${question_in_repeat}) |
| jr:choice-name(choice_name, 'question') | تُستخدم لأسئلة select_one. يُرجع التسمية المقترنة باسم الاختيار في السؤال المقدم. انتبه إلى إنه يجب تعريف السؤال داخل اقتباسات. | jr:choice-name(${select_one}, '${select_one}') |
مستخدم لأسئلة select_multiple. يُرجع التسمية المقترنة باسم الاختيار في السؤال المقدم. يجب استخدام دالة selected-at() لاستخراج تسمية الإجابات الفردية. انتبه إلى إنه يجب تعريف السؤال داخل اقتباسات. | jr:choice-name(selected-at(${select_multiple}, 3), '${select_multiple}') | |
| max(value1, value2, ...) | يعود بالحد الأقصى للقيمة في النطاق المحدد، أو إلى سؤال أحادي عبر التكرارات. | max(${question_one}, ${question_two}) |
| min(value1, value2, ...) | يعود بالحد الأدنى للقيمة في النطاق المحدد، أو إلى سؤال أحادي عبر التكرارات. | min(${question_one}, ${question_two}) |
| not(expression) | إرجاع قيمة خاطئة إذا كان التعبير سيعود صحيحًا، وقيمة صحيحة إذا كان التعبير سيعيد خطأ. | not(selected(., 'yes')) |
| now() | يعود بالطابع الزمني لهذه اللحظة. تُستخدم هذه الدالة في أسئلة الوقت وأسئلة التاريخ-الوقت. يتصرف مثل اليوم() في أسئلة التاريخ. | now() |
| number(question, expression, or value) | تحويل إلى رقم. يتنوع التحويل بناءً على نوع البيانات. ملاحظة:إذا كانت هذه الوظيفة فارغة، فستعيد NaN وسيظل السؤال فارغًا. | number(${question_one}) |
| once() | إذا كان السؤال يحتوي على قيمة، يتم إرجاع القيمة الحالية. هذه الدالة مفيدة عند استخدام عشوائي() أو uuid() في سؤال متكرر لضمان عدم تغيير القيمة عند الاستعراض من خلال سجلات التكرار في النموذج. | once(uuid()) |
موضع (..) | إرجاع فهرس السجل الحالي بشكل متكرر. للحصول على مزيد من المعلومات، راجع التكرارات. | position(..) |
| pulldata() | يرجع قيمة من ملف CSV خارجي. للحصول على مزيد من المعلومات، راجع استرداد قيمة من CSV. | pulldata('users', 'email', 'name', ${respondent_name}) |
pulldata("@exif") | يرجع قيمة من بيانات تعريف EXIF في صورة. للحصول على مزيد من المعلومات، راجع استخراج بيانات التعريف الخاصة بالصورة. | pulldata("@exif", ${photo}, "GpsLatitude") |
pulldata("@geopoint") | يرجع قيمة من سؤال نقطة جغرافية. للحصول على مزيد من المعلومات، راجع استخراج قيم النقطة الجغرافية. | pulldata("@geopoint", ${location}, "horizontalAccuracy") |
pulldata("@javascript") | يشغل دالة JavaScript في النموذج ويرجع النتيجة. للحصول على مزيد من المعلومات، راجع دوال JavaScript في نماذج الاستطلاع. | pulldata("@javascript", "functions.js", "uniqueID", ${buildings}) |
pulldata("@json") | يرجع قيمة من كائن JSON. للحصول على مزيد من المعلومات، راجع استرداد قيمة من JSON. | pulldata("@json", ${json_output}, "attributes.ZIP_CODE") |
pulldata("@layer") | الاستعلام عن طبقة معالم ArcGIS أو جدول المعالم أو خدمة الخريطة الممكنة للاستعلام وإرجاع النتيجة. لمزيد من المعلومات، راجع الاستعلام عن طبقة معالم. | pulldata("@layer", "getRecordAt", "https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/World_Time_Zones/FeatureServer/0", ${location}) |
pulldata("@property") | يرجع المعلومات المتعلقة بالجهاز أو المستخدم الذي سجل الدخول. للحصول على مزيد من المعلومات، راجع الجهاز وخصائص المستخدم. | pulldata("@property", 'username') |
| random() | إرجاع قيمة عشوائية بين 0 (شامل) و1 (حصري). | random() |
regex() | يطبق تعبيرًا عاديًا على مدخلات السؤال. يرجع قيمة صحيحة في حال تطابق النمط. لمزيد من المعلومات، راجع موضوع التعبيرات العادية. | regex(., '^\d{5}$') |
محدد(السؤال, القيمة) | تحقق مما إذا تم تحديد الإجابة. تُستخدم هذه الدالة لأسئلة الاختيار_الواحد والاختيار_المتعدد. | selected(${question_one}, 'a') |
| selected-at(question, number) | مستخدم لأسئلة select_multiple. يُرجع اسم الاختيار المحدد للرقم المقدم؛ الذي يُحتسب من الصفر، على سبيل المثال، سيرجع الرقم '2' الاختيار الثالث المحدد. | selected-at(${question_one}, 2) |
| starts-with(string, substring) | إرجاع صحيح إذا كانت السلسلة المقدمة تبدأ بسلسلة فرعية. | starts-with(${question_one}, 'The') |
| string(question, expression, or value) | تحويل إلى سلسلة. يتنوع التحويل بناءً على نوع البيانات. | string(${question_one}) |
| string-length(question, expression, or value) | إرجاع طول سلسلة ليست فارغة. | string-length(${question_one}) |
| substr(question, start, end) | إرجاع السلسلة الفرعية بدءًا من البداية المحددة وتمتد إلى الحرف في نهاية الفهرس -1، حيث تبدأ البداية والنهاية عند 0. | substr(${question_one}, 1, 2) |
| sum(repeat) | يعود بإجمالي جميع الاستجابات إلى السؤال المحدد عبر التكرارات. لمزيد من المعلومات، راجع دوال التجميع. ملاحظة:عند استخدام هذه الدالة في تطبيق Survey123 الميداني، يمكن وضعها داخل التكرار أو خارجه. في حال عدم استخدام الدالة في تطبيق ويب Survey123، يلزم وضعها خارج التكرار. يمكن الإشارة إلى قيمة مجموع من خارج التكرار في عملية حسابية داخل التكرار. | sum(${question}) |
| today() | إرجاع تاريخ اليوم، المخزن داخليًا في منتصف النهار المحلي. تُستخدم هذه الدالة في أسئلة التاريخ. | today() |
| true() | صواب | true() |
| uuid() | إرجاع سلسلة UUID عشوائية. | uuid() |
| version() | إرجاع إصدار المسح المعرف في مصنف إعدادات | version() |
الدوال الرياضية التالية مدعومة في Survey123:
| وظيفة | الوصف | مثال |
|---|---|---|
| acos(القيمة) | يرجع جيب التمام القوسي للقيمة. | acos(${question_one}) |
| asin(القيمة) | يرجع جيب الزاوية القوسي للقيمة. | asin(${question_one}) |
| atan(القيمة) | يرجع ظل القوس للقيمة. | atan(${question_one}) |
| atan2(القيمة1, القيمة2) | يرجع ظل القوس لحاصل قسمة القيم. | atan2(${question_one}, ${question_two}) |
| cos(القيمة) | يرجع جيب التمام للقيمة كزاوية بوحدات الراديان. | cos(${question_one}) |
| sin(القيمة) | يرجع جيب الزاوية للقيمة كزاوية بوحدات الراديان. | sin(${question_one}) |
| tan(القيمة) | يرجع ظل القيمة كزاوية بوحدات الراديان. | tan(${question_one}) |
| exp(القيمة) | إرجاع الأس الطبيعي للقيمة. | exp(${question_one}) |
| exp10(القيمة) | إرجاع 10 إلى قوة القيمة. | exp10(${question_one}) |
| السجل(القيمة) | إرجاع اللوغاريتم الطبيعي للقيمة. | log(${question_one}) |
| log10(القيمة) | إرجاع اللوغاريتم العشر الأساسي للقيمة. | log10(${question_one}) |
| pi() | إرجاع pi. | pi() |
| pow(القيمة, القوة) | إرجاع القيمة إلى القوة المحددة. | pow(${question_one}, 3) |
| الجولة (القيمة، الأماكن) | إرجاع القيمة المستديرة. | round(${question_one}, 5) |
| sqrt(القيمة) | إرجاع الجذر التربيعي للقيمة. | sqrt(${question_one}) |
تنسيق HTML
يمكنك استخدام تنسيق HTML في تسميات الأسئلة والتلميحات، بالإضافة إلى التسميات الموجودة في قوائم الاختيار. يكون تنسيق HTML المدعوم على النحو التالي:
| العلامة | بيان جدولي |
|---|---|
a | href، style |
abbr | title |
audio¹ | autoplay، controls، loop، muted، preload |
b، strong، i، em، u، ul، ol، li، tbody، br، hr | |
dd، dl، dt | style |
div¹ | style، align |
figcaption | style |
figure | style |
font | size، color، style |
h1، h2، h3، h4، h5، h6 | style |
img | src، width، height، border، alt، style |
p | style |
source¹ | media، src، type |
span | style |
sub | style |
sup | style |
table | width، height، cellpadding، cellspacing، border، style |
| td، th | height، width، valign، align، colspan، rowspan، nowrap، style |
tr | height، valign، align، style |
video¹ | autoplay، controls، height، loop، muted، poster، preload، width |
¹مدعوم فقط في تطبيق ويب Survey123.
تلميح:
افتراضيًا، يؤدي فتح رابط تشعبي تم إنشاؤه بتنسيق HTML في تطبيق الويب Survey123 إلى فتح الوجهة في علامة التبويب نفسها مثل الاستطلاع. لفتح هذا الرابط في علامة تبويب جديدة بدلاً من ذلك، أضف target="_blank" إلى علامة a href، على سبيل المثال:
<a href="https://www.esri.com" target="_blank">Link to Esri website</a>
التعبيرات العادية
التعبيرات المنتظمة هي تسلسلات الأحرف التي تُعرّف نمط البحث. ويمكن استخدامها في سؤال واحد لتحديد قيمتها بناءً على الأسئلة الأخرى أو تقييد إدخال البيانات. يمكن إنشاء تعبير منتظم من التعبيرات الفرعية المدرجة في الجدول التالي. للحصول على مزيد من المعلومات، راجع الصيغ.
| التعبير الفرعي | مطابقة |
|---|---|
| ^ | يطابق بداية السطر |
| $ | يطابق نهاية السطر. |
| . | يطابق أي حرف مفرد باستثناء السطر الجديد. |
| [...] | يطابق أي حرف مفرد في أقواس. |
| [^...] | يطابق أي حرف مفرد ليس في أقواس. |
| (re) | تجميع التعبيرات المنتظمة وتذكُّر النص المطابق. |
| (?: re) | تجميع التعبيرات المنتظمة دون تذكُّر النص المطابق. |
| a| b | يطابق إما a أو b. |
| \A | بداية السلسلة بالكامل. |
| \b | تتطابق مع حدود الكلمات عندما تكون خارج الأقواس، وتتطابق مع مسافة للخلف (0x08) عندما تكون داخل الأقواس. |
| \B | مطابقة حدود nonword. |
| \d | يُطابق الأرقام. يساوي [0 إلى 9]. |
| \D | مطابقة nondigits. |
| \G | يُطابق نقطة آخر تُطابق. |
| \n، \t، \e، وما إلى ذلك | مطابقة السطر الجديد وعلامة التبويب والإلغاء وما إلى ذلك. |
| \N | إسناد خلفي لالتقاط رقم المجموعة N. |
| re* | يُطابق 0 أو تكرارات أكثر من التعبير السابق. |
| re+ | يُطابق 1 أو تكرارات أكثر من التعبير السابق. |
| re? | يُطابق 0 أو 1 تكرار من التعبير السابق. |
| re{ n} | يطابق عددًا محددًا من تكرارات التعبير السابق المعرفة في موضع n. |
| re{ n,} | يُطابق n أو تكرارات أكثر من التعبير السابق. |
| re{ n, m} | يُطابق على الأقل عدد التكرارات المعرفة بواسطة n والمعرفة في الغالب بواسطة m في التعبير السابق. |
| \s | يطابق حرف مسافة بيضاء: علامة تبويب أو إضافة سطر أو إضافة نموذج أو عودة إلى أول السطر أو مسافة. |
| \S | مطابقة nonwhitespace. |
| \w | يُطابق أحرف الكلمة. |
| \W | مطابقة أحرف nonword. |
| \z | نهاية السلسلة بالكامل. |
| \Z | نهاية السلسلة بالكامل باستثناء فاصل السطر النهائي المسموح به. |
على سبيل المثال، يتطلب التعبير المنتظم regex(.,'^[A-Za-z]*$') من المستخدم إدخال أحرف فقط دون أرقام أو أحرف خاصة في سؤال السلسلة.
أنواع حقول Esri
يمكن استخدام عمود bind::esri:fieldType لاستبدال نوع الحقل الافتراضي بإحدى القيم التالية. لمزيد من المعلومات، راجع موضوع أعمدة Esri المخصصة.
| قيمة الحقل | النتيجة |
|---|---|
| esriFieldTypeDate | قيم التاريخ والوقت |
esriFieldTypeDateOnly | قيم التاريخ فقط بدون قيم الوقت |
esriFieldTypeTimeOnly | قيم الوقت فقط بدون قيم تاريخ |
esriFieldTypeTimestampOffset | التاريخ والوقت والإزاحة من قيمة UTC |
| esriFieldTypeDouble | أرقام النقاط العائمة للدقة المزدوجة |
| esriFieldTypeGUID | المعرف المميز عالميًا |
| esriFieldTypeInteger | الأعداد الصحيحة (32 بت) |
| esriFieldTypeBigInteger | الأعداد الصحيحة من (64 بت) |
| esriFieldTypePointZ | تمكين التقاط خط الارتفاع في النقاط الجغرافية |
| esriFieldTypeString | سلسلة من الرموز الأبجدية |
| فارغ | حقل فارغ، لا يُخزّن القيم |
الأحرف الخاصة
يجب ألا تحتوي أسماء الأسئلة وأسماء الاختيارات على أحرف خاصة، مثل المسافات أو الفواصل أو الواصلات أو الأقواس أو الأقواس المتوسطة أو أحرف مثل $ و٪ و #. من المهم ألا تحتوي أسماء الاختيارات لأسئلة select_multiple على مسافات أو فواصل.