يمكن لتطبيق الويب Survey123 قبول المعلمات بنفس تنسيق التطبيق الميداني. أحد الفروق التي يجب ملاحظتها هو أن معرف العنصر للاستطلاع هو جزء من مسار عنوان URL بدلاً من معلمة عنوان URL مثل الروابط الأخرى التي تستخدم لفتح الاستطلاعات. عندما تقوم بإضافة معلمات إلى عنوان URL هذا، يجب عليك استخدام علامة استفهام لفصل معرف عنصر الاستطلاع في المسار عن المعلمة الأولى ثم استخدام علامات العطف لفصل المعلمات اللاحقة. يُمرِّر مثال عنوان URL التالي اللقب والمعلمات الإحداثية إلى استطلاع في تطبيق ويب Survey123:
https://survey123.arcgis.com/share/36ff9e8c13e042a58cfce4ad87f55d19?field:surname=Klauser¢er=37.8199,-122.4783يدعم تطبيق الويب Survey123 أيضًا عددًا من المعلمات التي لا يدعمها تطبيق Survey123 الميداني. ترتبط هذه المعلمات بتقديم الاستطلاع داخل المستعرض. راجع الجدول التالي للتعرف على معلمات عنوان URL والأمثلة التي تعمل على تخصيص كيفية فتح تطبيق الويب.
ملاحظة:
إذا كانت قيمة المعلمة تشتمل على مسافات أو علامات جمع (+) أو أحرف خاصة أخرى، فيجب ترميز هذه الأحرف بنسبة مئوية. لمزيد من المعلومات، راجع ترميز عنوان URL.
معلمات عنوان URL لبدء تشغيل تطبيق الويب
| المعلمة | الوصف | النوع |
|---|---|---|
isOrgSignIn | يستخدم صفحة تسجيل الدخول الخاصة بالمؤسسة. بشكل افتراضي، يستخدم Survey123 صفحة تسجيل الدخول الخاصة بالمؤسسة، ولكن عند مشاركة الاستطلاعات مع أكثر من مؤسسة، قد يكون استخدام صفحة تسجيل الدخول إلى ArcGIS Online هو المفضل. قم بتعيين هذه المعلمة على false لاستخدام صفحة تسجيل الدخول إلى ArcGIS Online. مثال: | منطقي |
center | توسيط الخريطة إلى خط طول ودائرة عرض وارتفاع اختياري معروف. مثال: | السلسلة |
field:fieldname | يملأ أسئلة الاستطلاع بقيم الحقول. مثال: | السلسلة |
portalUrl | يحدد عنوان URL للبوابة الإلكترونية حيث يتم استضافة عنصر الاستطلاع. مثال: | السلسلة |
| open | يحدد التطبيق المستخدم لفتح الاستطلاع. القيم الصالحة هي web، التي تفتح الاستطلاع في تطبيق الويب (الإعداد الافتراضي)؛ و native، الذي يفتح الاستطلاع في التطبيق الميداني إذا كان التطبيق الميداني مثبتًا، و menu، الذي يفتح صفحة ويب لتحديد التطبيق الذي سيفتح الاستطلاع. مثال: | السلسلة |
| hide |
يخفي عناصر الاستطلاع في تطبق الويب. يمكن أن تقبل المعلمة قيمًا متعددة تفصل بينها فاصلة. القيم الصالحة هي navbar (الشريط الموجود أعلى الاستطلاع، بما في ذلك خيارات تسجيل الدخول وتسجيل الخروج وتغيير اللغة) وheader وdescription وfooter وsubmit وtheme وleaveDialog (رسالة التحذير التي تظهر عند التنقل بعيدًا عن الصفحة أو إغلاقها). يمكنك أيضًا استخدام معلمة field:fieldName لإخفاء سؤال أو مجموعة أو صفحة أو تكرار محدد، بتوفير الاسم في مكان fieldName. لا يمكن إخفاء الأسئلة داخل التكرارات بشكل فردي. مثال: | السلسلة |
| locale | تغير لغة الاستطلاع. يعمل فقط إذا كان الاستطلاع يتضمن لغات متعددة. مثال: | السلسلة |
| mode | يحدد وضع تطبيق الويب. القيم الصالحة هي edit، والتي تضبط الاستطلاع لتحرير إدخال موجود بدلاً من إنشاء واحد؛ وview، الذي يفتح إدخالًا موجودًا في وضع القراءة فقط؛ وcopy، الذي يقوم بإنشاء استطلاع يتم ملؤه بمحتويات الإدخال المحدد. عند استخدام هذه المعلمة، يجب تقديم معلمة globalId كذلك. مثال: | السلسلة |
| globalId | يحدد سجل الاستطلاع الذي تم تحميله في النموذج. القيم الصالحة هي المعرفات العالمية لسجلات الاستطلاع الحالية. اسم هذه المعلمة حساس لحالة الأحرف. مثال: | السلسلة |
recalculate | يمكن استخدامه فقط في mode=edit. يفرض هذا الأسئلة المحددة المراد إعادة حسابها أثناء تحميل الاستطلاع دون استخدام زر إعادة حساب. مثال: | السلسلة |
| version | يعين إصدار تطبيق الويب الذي سيتم تطبيقه. القيمة الصالحة الوحيدة هي latest، التي تستخدم أحدث إصدار من تطبيق الويب، حتى إذا كان تطبيق الاستطلاع مؤمّنًا. مثال: | السلسلة |
| token | يمرر رمزًا صالحًا للاستطلاع. يمكن استخدام هذا للسماح للمستجيبين للاستجابة على استطلاع يتطلب حساب ArcGIS للوصول إليه دون تسجيل الدخول. مثال: | السلسلة |
autoReload | يعيد تحميل الاستطلاع بعد الإرسال. حدد التأخير (بالثواني) قبل إعادة تحميل الاستطلاع. كانت يُسمى سابقًا autoRefresh. معلمة autoRefresh مدعومة للتوافق مع الإصدارات السابقة. مثال: | عدد صحيح |
| encodeUrlParams | يحجب معلمات URL. سيشمل عنوان URL الناتج بدلاً من ذلك معلمة code تمثل جميع المعلمات المكودة؛ وسيتم تجاهل المعلمات المضمنة خارج معلمة code هذه. مثال: | منطقي |
width | يقوم بتعيين عرض الاستطلاع بالبكسل. يؤثر هذا أيضًا على عناصر التحكم الأخرى داخل الاستطلاع، مثل مربعات النص. مثال: | عدد صحيح |
ملاحظة:
تدعم المعلمة field:fieldname أسئلة النقاط الجغرافية والتتبع الجغرافي والشكل الجغرافي في تطبيق الويب. بالنسبة لأسئلة النقاط الجغرافية، حدد خطوط الطول ودوائر العرض والارتفاع (اختياري) مفصولة بمسافات. بالنسبة إلى التتبع الجغرافي والشكل الجغرافي، حدد خطوط الطول ودوائر العرض لكل نقطة قممية مفصولة بمسافة، مع فصل كل زوج من الإحداثيات بفاصلة منقوطة. سيعمل هذا المثال مع سؤال الشكل الجغرافي:
field:geoshape=-37.842156723211474 144.95942945338243;-37.83554486071995 144.9726235713864;-37.85681405373047 144.98240735651922;-37.85954045531896 144.97715349053766