يدعم Survey123 أسئلة select_one (تحديد إجابة واحدة فقط)، وselect_multiple (تحديد إجابات متعددة)، والمرتبة (ترتيب قائمة الخيارات).
ملاحظة:
أسئلة المرتبة مدعومة حاليًا في التطبيق الميداني وتطبيق الويب فقط.
تتطلب كتابة العديد من سؤال الاختيارات المتعددة إضافة ورقة عمل اختيارات إلى مُصنّف Excel. فيما يلي مثال على سؤال select_one:


يجب أن يتطابق اسم القائمة في جدول بيانات الاستطلاع، yes_no، مع اسم القائمة في جدول بيانات الاختيارات. هذا يؤكد أن النموذج يعرض القائمة الصحيحة لاختيارات الإجابة الخاصة بسؤال محدد.
بشكل افتراضي، عند نشر استطلاع، تتم إضافة الاختيارات في أسئلة select_one إلى طبقة معالم الاستطلاع كمجالات قيمة مكودة. يمكنك تعطيل إنشاء المجالات في أثناء عملية النشر. لمزيد من المعلومات، راجع خيارات النشر.
تنبيه:
فيما يلي قيود عند استخدام قائمة اختيار بها أسماء اختيارات مكررة:
- لا يتم دعم أسماء الاختيارات المكررة لأسئلة select_multiple.
- لا يتم دعم أسماء الاختيارات المكررة للاستطلاعات متعددة اللغات.
- تقوم دالة jr:choice-name() بإرجاع تسمية أول اختيار مكرر في القائمة.
- عند فتحه من مجلد الوارد أو المسودات أو الصادر أو المُرسَل أو نظرة عامة، تعود أسئلة select_one إلى الخيار الأول المكرر في القائمة.
فيما يخص الاعتبارات الإضافية عند تعديل قوائم الاختيارات في الاستطلاعات الحالية، يمكنك الاطلاع على تحديث استطلاع.
يمكنك أيضًا إضافة أسئلة اختيارات متعددة تتيح تحديد إجابات متعددة، مثل التالي:


بشكل افتراضي، تظهر هذه الخيارات بالترتيب الموضح في ورقة عمل الخيارات. يمكنك بدلاً من ذلك جعل الترتيب الذي تظهر به هذه الخيارات عشوائيًا بإدخال randomize=true في عمود المعلمات.
تنبيه:
تم حفظ كل القيم التي تم جمعها في سؤال select_multiple أو تصنيف كقائمة مفصولة بفاصلة، لذا تجنب استخدام الفواصل في عمود الاسم بقائمة الخيارات. لاحظ أيضًا أن أسئلة select_multiple والتصنيف لن ترسل إلا اسم خيار إلى طبقة المعالم، بدلاً من الاسم والتسمية المرسلَين بواسطة أسئلة select_one.
تظل قيمة سؤال التصنيف فارغة حتى يتم تعديل ترتيب الخيارات بواسطة المستخدم. إذا تم تعيين قيمة افتراضية، فيتم تطبيق الترتيب الافتراضي ما لم يتم تعديل ترتيب الاختيار من قبل المستخدم.
يمكن إعادة إجابة فردية لسؤال select_multiple باستخدام دالة selected-at. يقوم ما يلي بإرجاع قيمة الاسم للإجابة الأولى المقدمة لسؤال select_multiple:
selected-at(${species}, 0)
لإرسال تسمية لإجابة ما، يمكنك استخدام دالة jr:choice-name. للحصول على قيمة تسمية للإجابة الثانية المقدمة لنفس السؤال select_multiple، استخدم ما يلي:
jr:choice-name(selected-at(${species}, 1), '${species}')
المظهر
بتعيين عمود المظهر إلى الحد الأدنى، يتم عرض سؤال التحديد في قائمة منسدلة.

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

المظهر المدمج مشابه للمظهر الأفقي ولكنه يستخدم طريقة مختلفة لتحديد عرض العمود الذي قد ينتج عنه أن تشغل الاختيارات مساحة أقل.
ملاحظة:
في Survey123 Connect، يمكنك تحديد الحد الأقصى لعدد الأعمدة للمظهر المدمج من خلال توفير رقم مفصول بواصلة. على سبيل المثال، تحدد أداة Compact-3 السؤال بثلاثة أعمدة كحد أقصى لأسئلة الاختيارات المتعددة في الاستطلاعات المستخدمة من خلال التطبيق الميداني أو تطبيق الويب.
يتطابق المظهران المدمج و الأفقي المدمج. في تطبيق الويب Survey123، بدلاً من استخدام الأعمدة، تلائم هذه المظاهر تسميات الاختيار لسؤال التحديد جنبًا إلى جنب في صفوف بدون مسافات إضافية.
فيما يخص سؤال تحديد إجابة واحدة، يعرض تعيين عمود المظهر إلى likert اختيارات باعتبارها نطاق Likert. مقياس Likert هو مقياس تصنيفي يتيح للمستجيبين بتحديد مستوى الاتفاقية الخاصة بهم على مقياس أوافق-لا أوافق المتماثل من العبارة.

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

ملاحظة:
لا يكون مظهر الإكمال التلقائي مدعومًا لأسئلة تحديد إجابات متعددة إلا في Survey123 Mobile. ليس مدعومًا في التطبيق الميداني أو تطبيق الويب.
من خلال تعيين المظهر على بحث، يمكنك ملء قائمة الاختيار لسؤال التحديد بقيم من جدول CSV في مجلد وسائط الاستطلاع، أو طبقة معالم موجودة أو جدول حالي. لمزيد من المعلومات، يمكنك الاطلاع على إنشاء قائمة اختيار ديناميكية باستخدام مظهر البحث.
من خلال تعيين المظهر إلى صورة-خريطة، يمكن عرض سؤال التحديد في التطبيق الميداني كصورة تضم مناطق قابلة للتحديد كاختيارات باستخدام ملف SVG. لمزيد من المعلومات، راجع العمل باستخدام ملفات SVG
إنشاء قائمة اختيار ديناميكية باستخدام مظهر البحث
ملاحظة:
يصف هذا القسم وظائف متاحة فقط في Survey123 Connect وفي التطبيق الميداني Survey123. هذه الوظائف غير متاحة في Survey123 Studio أو Survey123 Mobile.
تدعم أسئلة تحديد إجابة واحدة وتحديد إجابات متعددة مظهر البحث، والذي يمكن استخدامه لتعبئة قائمة الاختيار بقيم من جدول CSV في مجلد وسائط الاستطلاع، أو طبقة معالم حالية أو جدول حالي. عند استخدام مظهر البحث، لا يزال يتعين عليك تضمين إدخال في ورقة عمل الاختيارات، ولكن بدلاً من سرد كل خيار من الخيارات، ستقوم بالإشارة إلى اسم الحقل من طبقة المعالم الحالية أو الجدول الحالي.
في المثال التالي، يتم تحديد قائمة اختيار تُعرف باسم us_states في ورقة عمل الاختيارات، وستستخدم الحقل STATE_NAME لكل من اسم الاختيار وتسميته.

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

تجب هيكلة تعبير مظهر البحث بالطريقة التالية، مع مراعاة فصل المتغيرات بفواصل:
search(tableName, searchType, searchColumn, searchText, filterColumn, filterText)تقبل معلمة tableName إما اسم ملف .csv في مجلد media الخاص بالاستطلاع، على سبيل المثال، airports أو عنوان URL لطبقة المعالم أو طبقة خدمة الخريطة مسبوقًا باسم Survey123 للإشارة إلى الجدول داخليًا. لا يلزم أن يتطابق اسم الجدول هذا مع اسم الطبقة المستضافة، ولكن نظرًا إلى أن هذه هي كيفية إشارة Survey123 داخليًا إلى بحثك، يجب أن يكون مختلفًا عن جميع أسماء الجداول الأخرى وملفات .csv المستخدمة في الاستطلاع. يمكنك اختياريًا إلحاق معلمات طلب الاستعلام بنقطة نهاية REST لـ طبقة المعالم أو طبقات خدمة الخريطة لتكوين سلوك البحث. في المثال التالي، يتم إلحاق عنوان URL لطبقة المعالم بمعلمة resultRecordCount لتعبئة قائمة الاختيار بأول 10 نتائج استعلام، مع تخزين البحث داخليًا باسم airports:
"airports?url=https://services1.arcgis.com/e7dVfn25KpfE6dDd/arcgis/rest/services/Airports2/FeatureServer/0&resultRecordCount=10"يمكن تصفية قائمة الاختيار باستخدام التعبير "أين". عند استخدام المثال التالي بوصفه اسم الجدول (tableName)، ستتم تصفية قائمة الاختيار لإظهار الولايات التي لا يكون اسمها ألاباما أو ألاسكا:"state?url=https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/USA_States_Generalized_Boundaries/FeatureServer/0&where=STATE_NAME
NOT IN('Alabama', 'Alaska')"
ملاحظة:
يجب ترميز معلمات البحث التي تتضمن أحرفًا خاصة إذا كان الاستطلاع سيُستخدم في تطبيق الويب Survey123. ويؤدي الترميز إلى استبدال الأحرف الخاصة (مثل حرف البدل في التعبير) بعلامة النسبة المئوية (%) متبوعةً بمكافئها السداسي العشري.
تُعد المعلمات الإضافية التالية اختيارية ولكن يمكن استخدامها لتضييق نطاق النتائج التي يوفرها البحث.
| المعلمة | الوصف |
|---|---|
searchType | يتحكم في نوع البحث الذي يتم إجراؤه، ويقبل قيمًا مختلفة بناءً على ما إذا كان الجدول الذي يتم البحث فيه جدولاً مكانيًا داخل طبقة معالم أم جدولاً غير مكاني في CSV أم جدول معالم. بالنسبة إلى الجداول المكانية، أنواع البحث المقبولة هي intersects، contains، crosses، envelope_intersects، index_intercepts، overlaps، touches، وwithin. لمعرفة المزيد، راجع العلاقات المكانية. بالنسبة إلى الجدول غير المكاني، أنواع البحث المدعومة هي contains، startswith، endswith، وmatches. |
searchColumn | يحدد العمود الذي سيتم البحث فيه عن النص في معلمة searchText. هذه الأعمدة مأخوذة من الجدول نفسه. بالإضافة إلى ذلك، يمكن للجدول المكاني في طبقة المعالم البحث في الأعمدة @geopoint و@geotrace و@geoshape. |
searchText | يحتوي على النص الذي سيتم البحث عنه وإرجاعه في معلمة searchColumn. |
بالإضافة إلى ذلك، يمكن إضافة معلمات التصفية التالية إلى تعبير البحث لتحسين قيم قائمة الاختيار بشكل أكبر:
| المعلمة | الوصف |
|---|---|
filterColumn | يعين عمودًا للبحث عن مطابقات للنص الوارد في معلمة filterText. لن يُرجع استعلام البحث سوى النتائج التي تحتوي على هذا النص. يجب استخدام معلمتي filterColumn وfilterText معًا. |
filterText | النص الذي يتم البحث عنه في العمود المحدد بواسطة معلمة filterColumn. يجب استخدام معلمتي filterColumn وfilterText معًا. |
فيما يلي مثال على تعبير بحث يتضمن بعض المعلمات الاختيارية لمظهر البحث. يقوم بتعبئة قائمة اختيار بمحتويات ملف .csv باستخدام سؤال سابق كنص بحث.
search('csvName', 'matches', 'breed', ${DogQuestion})
ملاحظة:
تُعرض الأسئلة التي تتضمن مظهر البحث في تطبيق الويب Survey123 على غرار أسئلة التحديد التي تتضمن مظهر الإكمال التلقائي.
حدد أخرى
فيما يتعلق بأسئلة الاختيار من متعدد، قد تتضمن الاستطلاعات خيار اختيار غير ذلك عند عدم إدراج الخيار المطلوب. قد يُطلب من المستجيب بعد ذلك تحديد الخيار "غير ذلك". يمكنك القيام بذلك في XLSForm باستخدام الطريقة اليدوية أو الطريقة المدمجة. الطريقة المدمجة أسرع وأسهل في التكوين من الطريقة اليدوية، ولكنها تحتوي على العديد من القيود.
الطريقة اليدوية
يوصى باستخدام الطريقة اليدوية لأنها تسمح لك بتحديد اسم وتسمية الخيار "غير ذلك" واسم وتسمية السؤال النصي الذي يجمع إجابات "غير ذلك". يمكنك تقديم ترجمات لهذه الأسماء والتسميات. يمكنك أيضًا تطبيق القيود والمظاهر على السؤال النصي وجعله مطلوبًا.
أولاً، قم بإضافة خيار غير ذلك إلى قائمة الاختيارات للسؤال الموجود في ورقة عمل الاختيارات. حدد اسمًا وتسمية لهذا الاختيار كما تفعل مع أي خيار آخر في القائمة. في المثال التالي، تحتوي قائمة اختيارات اللون على خيار يسمى غير ذلك.

في ورقة عمل الاستطلاع، أضف سؤالاً نصيًا لجمع إجابات "غير ذلك". أضف تعبيرًا ذا صلة بحيث يكون السؤال النصي ذا صلة فقط عند تحديد خيار "غير ذلك". في المثال التالي، يكون سؤال other_color مرتبطًا عندما تكون الإجابة على سؤال select_one "غير ذلك".

يمكن ترجمة الأسئلة والاختيارات في الاستطلاعات المتعددة اللغات. في المثال التالي، يتم توفير الترجمات الفرنسية واليونانية في ورقة عمل الاستطلاع لكل من سؤالي select_one والسؤال النصي.

يتم أيضًا توفير الترجمات في ورقة عمل الاختيارات، بما فيها خيار غير ذلك.

الطريقة المدمجة
باستخدام هذه الطريقة المدمجة، ينشئ Survey123 Studio وSurvey123 Connect تلقائيًا الخيار الأخر والسؤال لجمع الاستجابة الأخرى. لاستخدام هذه الطريقة، اكتب or_other بعد اسم قائمة الاختيارات في عمود النوع في ورقة عمل الاستطلاع. يتم عرض خيار غير ذلك في قائمة الاختيارات الخاصة بالسؤال. عند تحديد الخيار الآخر، يتم عرض سؤال تحديد آخر للسماح للمستخدمين بإدخال إجابتهم الخاصة. لتخزين هذه الإجابة، ينشئ Survey123 Studio وSurvey123 Connect تلقائيًا حقلًا إضافيًا في طبقة المعالم باستخدام اسم سؤال الاختيار من متعدد متبوعًا بـ _other، على سبيل المثال، favorite_toppings_other. راجع الأمثلة التالية:

تنبيه:
لن تُعرض تسمية تحديد سؤال آخر بلغات أخرى غير الإنجليزية.
في حالة إنشاء استطلاع من طبقة معالم موجودة، فلن يتم إنشاء حقل تحديد سؤال آخر تلقائيًا، ولن يتم نشر الاستطلاع. يجب عليك إنشاء الحقل لسؤال تحديد آخر يدويًا في طبقة المعالم، مع اسم سؤال الاختيار المتعدد متبوعًا بـ _other، على سبيل المثال، Favorite_toppings_other.
قوائم الخيارات الخارجية
يمكنك تخزين قوائم الخيارات لأسئلة select_one وselect_multiple في ملف .csv خارجي. يعد هذا مثاليًا لقوائم الاختيار الكبيرة جدًا، والاستطلاع الذي يحتوي على قوائم اختيار متعددة، وقوائم الاختيار التي تتم إدارتها خارج نطاق Survey123. يجب عدم الخلط بين قوائم الخيارات الخارجية و التحديدات الخارجية، والتي يجب فيها إدراج الخيارات في ورقة عمل إضافية.
يجب أن يحتوي ملف .csv على أعمدة الاسم والتسمية.
ملاحظة:
إذا كان ملف .csv الخاص بك يفتقر إلى رأس عمود، أو يحتوي على فاصلة لاحقة في نهاية صفوف الملف، فسيفشل استيراد الملف إلى الاستطلاع.
للحصول على أفضل النتائج، قم بترميز ملف .csv باستخدام ترميز أحرف UTF-8. إذا كنت تستخدم Microsoft Excel لإنشاء ملف .csv الخاص بك، فاحفظه بتنسيق CSV UTF-8.
قد يتم تضمين أعمدة التسمية المترجمة في ملف .csv، ولكن سيتم عرض الاختيارات المترجمة فقط في التطبيق الميداني وSurvey123 Studio وSurvey123 Connect وSurvey123 Mobile، وليس تطبيق الويب.
لتضمين سؤال في قائمة خيارات خارجية، أدخل نوع السؤال أو select_one_from_file أو select_multiple_from_file، واسم ملف .csv، على سبيل المثال، select_one_from_file CoverType.csv. أسماء الملفات حساسة لحالة الأحرف ولا يُسمح باستخدام مسافات.
هناك طريقتان لتضمين ملف .csv: تخزين الملف في مجلد media للاستطلاع أو الارتباط بملف .csv مستضاف في ArcGIS.
تلميح:
قم بتشغيل أداة تحويل قوائم الاختيار إلى ملف CSV لأتمتة ترحيل قوائم الاختيار من ورقة عمل الاختيارات إلى ملفات .csv.
ربط ملف .csv
ملاحظة:
يصف هذا القسم وظائف متاحة فقط في Survey123 Connect وفي التطبيق الميداني Survey123. هذه الوظائف غير متاحة في Survey123 Studio أو Survey123 Mobile.
لربط ملف .csv من محتوى ArcGIS بالاستطلاع، قم بما يلي:
- تأكد من أن ملف .csv مستضاف في ArcGIS Online أو ArcGIS Enterprise وأن لديه أذونات المشاركة نفسها مثل الاستطلاع.
- تأكد من نشر الاستطلاع في ArcGIS قبل محاولة ربط المحتوى.
- في Survey123 Connect، افتح الاستطلاع وانقر فوق علامة التبويب المحتوى المرتبط. انقر فوق الزر ربط المحتوى، واختر ملف CSV، واستعرض للوصول إلى ملف .csv الذي تريد ربطه وحدده.
لكي تعرض معاينة النموذج الاختيارات من ملف .csv المرتبط، في Survey123 Connect بعلامة تبويب المحتوى المرتبط، انقر فوق زر التنزيل
. يؤدي هذا إلى وضع نسخة من ملف .csv في مجلد الوسائط الخاص بالاستطلاع. يتم تنزيل الملفات المرتبطة تلقائيًا مع الاستطلاع في التطبيق الميداني.
إذا وضعت ملف .csv يدويًا في مجلد الوسائط الخاص بالاستطلاع، وقمت في وقت لاحق بتحميل ملف .csv بالاسم نفسه على ArcGIS وربطه بالاستطلاع، فسيتم تحديث ملف .csv في الاستطلاع من المحتوى المرتبط (إذا كان أحدث).
تحويل قوائم الاختيار إلى CSV
ملاحظة:
يصف هذا القسم وظائف متاحة فقط في Survey123 Connect وفي التطبيق الميداني Survey123. هذه الوظائف غير متاحة في Survey123 Studio أو Survey123 Mobile.
قم بتشغيل أداة تحويل قوائم الاختيار إلى ملف CSV في Survey123 Connect لترحيل قوائم الاختيار المحددة تلقائيًا من ورقة عمل الاختيارات إلى ملفات .csv جديدة في مجلد الوسائط. تقوم الأداة أيضًا بتعديل الأسئلة المقابلة في ورقة عمل الاستطلاع لاستخدام أنواع أسئلة Select_one_from_file وselect_multiple_from_file.
لتشغيل الأداة قم بما يلي:
- قم بتكوين بيئة Python في Survey123 Connect بحيث يمكنك تشغيل الأداة. لمزيد من المعلومات، راجع تكوين Python.
- افتح XLSForm الخاص بالاستطلاع. في ورقة عمل الاختيارات، أضف عمودًا باسم esri_tool_convert_csv. أضف قيمة نعم إلى صف واحد على الأقل لكل قائمة من قوائم الاختيار التي تريد تحويلها إلى قوائم اختيار خارجية. احفظ الملف وأغلقه.
- في Survey123 Connect، افتح الاستطلاع، وانقر فوق الأدوات، ثم اختر تحويل قوائم الاختيار إلى ملف CSV.
عند اكتمال التحويل، يتم حفظ ملف .csv في مجلد الوسائط لكل قائمة اختيار تم ترحيلها. يتطابق اسم الملف مع قيمة اسم قائمة الاختيار الأصلية (عمود list_name). يتم تحديث ورقة عمل الاختيارات لتشمل فقط القوائم المتبقية التي لم يتم ترحيلها. ولا يزال يتضمن أي رؤوس أعمدة مخصصة من الأصل. في ورقة عمل الاستطلاع، تم تغيير أسئلة Select_one وselect_multiple القابلة للتطبيق إلى Select_one_from_file وselect_multiple_from_file للإشارة إلى قوائم الاختيار الخارجية الجديدة. يتم حفظ ورقة عمل الاختيارات الأصلية في ورقة عمل Choice_backup حتى تتمكن من التحقق من النتائج أو الرجوع. يمكنك الاحتفاظ بورقة عمل النسخ الاحتياطي أو حذفها.
لن تقوم الأداة بتحويل قوائم الاختيار المستخدمة في أسئلة التصنيف أو مجموعات قوائم الجداول أو الأسئلة التي لها مظهر البحث. لم يتم تعديل أي من الأسئلة التي تستخدم قوائم الاختيار هذه في الاستطلاع.
إذا اكتشفت الأداة أسئلة غير مدعومة، فسيتم إنشاء ملف .xlsx في مجلد تصحيح الأخطاء بأسماء قائمة الاختيار المتأثرة. يمكنك العثور على هذا الملف في المجلد التالي:
C:\Users\<username>\ArcGIS\My Survey Designs\<surveyName>\debug\convertchoicelists