عودة لأعلى

إطلاق تطبيق الويب

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

https://survey123.arcgis.com/share/36ff9e8c13e042a58cfce4ad87f55d19?field:surname=Klauser&center=37.8199,-122.4783

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

ملاحظة:‏

إذا كانت قيمة المعلمة تشتمل على مسافات أو علامات جمع (+) أو أحرف خاصة أخرى، فيجب ترميز هذه الأحرف بنسبة مئوية. لمزيد من المعلومات، راجع ترميز عنوان URL.

معلمات عنوان URL لبدء تشغيل تطبيق الويب

المعلمةالوصفالنوع

signIn

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

مثال:

signIn=show

السلسلة

isOrgSignIn

يستخدم صفحة تسجيل الدخول الخاصة بالمؤسسة. بشكل افتراضي، يستخدم Survey123 صفحة تسجيل الدخول الخاصة بالمؤسسة، ولكن عند مشاركة الاستطلاعات مع أكثر من مؤسسة، قد يكون استخدام صفحة تسجيل الدخول إلى ArcGIS Online هو المفضل. قم بتعيين هذه المعلمة على false لاستخدام صفحة تسجيل الدخول إلى ArcGIS Online.

مثال:

isOrgSignIn=false

منطقي

center

توسيط الخريطة إلى خط طول ودائرة عرض وارتفاع اختياري معروف.

مثال:

center=37.8199,-122.4783,20

السلسلة

field:fieldname

يملأ أسئلة الاستطلاع بقيم الحقول.

مثال:

 field:surname=Klauser

السلسلة

portalUrl

يحدد عنوان URL للبوابة الإلكترونية حيث يتم استضافة عنصر الاستطلاع.

مثال:

portalUrl=https://myorg.arcgis.com

السلسلة

open

يحدد التطبيق المستخدم لفتح الاستطلاع. القيم الصالحة هي web، التي تفتح الاستطلاع في تطبيق الويب (الإعداد الافتراضي)؛ و native، الذي يفتح الاستطلاع في التطبيق الميداني إذا كان التطبيق الميداني مثبتًا، و menu، الذي يفتح صفحة ويب لتحديد التطبيق الذي سيفتح الاستطلاع.

مثال:

open=web

السلسلة

hide

يخفي عناصر الاستطلاع في تطبق الويب. يمكن أن تقبل المعلمة قيمًا متعددة تفصل بينها فاصلة. القيم الصالحة هي navbar (الشريط الموجود أعلى الاستطلاع، بما في ذلك خيارات تسجيل الدخول وتسجيل الخروج وتغيير اللغة) وheader وdescription وfooter وsubmit وtheme وleaveDialog (رسالة التحذير التي تظهر عند التنقل بعيدًا عن الصفحة أو إغلاقها). يمكنك أيضًا استخدام معلمة field:fieldName لإخفاء سؤال أو مجموعة أو صفحة أو تكرار محدد، بتوفير الاسم في مكان fieldName. لا يمكن إخفاء الأسئلة داخل التكرارات بشكل فردي.

مثال:

hide=header,description,footer,theme

السلسلة

locale

تغير لغة الاستطلاع. يعمل فقط إذا كان الاستطلاع يتضمن لغات متعددة.

مثال:

locale=zh-cn

السلسلة

mode

يحدد وضع تطبيق الويب. القيم الصالحة هي edit، والتي تضبط الاستطلاع لتحرير إدخال موجود بدلاً من إنشاء واحد؛ وview، الذي يفتح إدخالًا موجودًا في وضع القراءة فقط؛ وcopy، الذي يقوم بإنشاء استطلاع يتم ملؤه بمحتويات الإدخال المحدد. عند استخدام هذه المعلمة، يجب تقديم معلمة globalId كذلك.

مثال:

mode=edit&globalId=1d392670-33e2-456d-8435-7fad3abd8bb9

السلسلة
globalId

يحدد سجل الاستطلاع الذي تم تحميله في النموذج. القيم الصالحة هي المعرفات العالمية لسجلات الاستطلاع الحالية. اسم هذه المعلمة حساس لحالة الأحرف.

مثال:

globalId=1d392670-33e2-456d-8435-7fad3abd8bb9

السلسلة

recalculate

يمكن استخدامه فقط في mode=edit. يفرض هذا الأسئلة المحددة المراد إعادة حسابها أثناء تحميل الاستطلاع دون استخدام زر إعادة حساب.

مثال:

recalculate=field:question1,field:question2

السلسلة

version

يعين إصدار تطبيق الويب الذي سيتم تطبيقه. القيمة الصالحة الوحيدة هي latest، التي تستخدم أحدث إصدار من تطبيق الويب، حتى إذا كان تطبيق الاستطلاع مؤمّنًا.

مثال:

version=latest

السلسلة
token

يمرر رمزًا صالحًا للاستطلاع. يمكن استخدام هذا للسماح للمستجيبين للاستجابة على استطلاع يتطلب حساب ArcGIS للوصول إليه دون تسجيل الدخول.

مثال:

token=E60M4Gsc-h4Q8plqQ...

السلسلة

autoReload

يعيد تحميل الاستطلاع بعد الإرسال. حدد التأخير (بالثواني) قبل إعادة تحميل الاستطلاع. كانت تُعرف سابقًا باسم autoRefresh. معلمة autoRefresh مدعومة للتوافق مع الإصدارات السابقة.

مثال:

autoReload=3

عدد صحيح

encodeUrlParams

يحجب معلمات URL. سيشمل عنوان URL الناتج بدلاً من ذلك معلمة code تمثل جميع المعلمات المكودة؛ وسيتم تجاهل المعلمات المضمنة خارج معلمة code هذه.

مثال:

encodeUrlParams=true

منطقي

width

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

أمثلة:

width=1000
width=600px
width=0.5

السلسلة

ملاحظة:‏

تدعم المعلمة field:fieldname أسئلة النقاط الجغرافية والتتبع الجغرافي والشكل الجغرافي في تطبيق الويب. بالنسبة لأسئلة النقاط الجغرافية، حدد خطوط الطول ودوائر العرض والارتفاع (اختياري) مفصولة بمسافات. بالنسبة إلى التتبع الجغرافي والشكل الجغرافي، حدد خطوط الطول ودوائر العرض لكل نقطة قممية مفصولة بمسافة، مع فصل كل زوج من الإحداثيات بفاصلة منقوطة. سيعمل هذا المثال مع سؤال الشكل الجغرافي:

field:geoshape=-37.842156723211474 144.95942945338243;-37.83554486071995 144.9726235713864;-37.85681405373047 144.98240735651922;-37.85954045531896 144.97715349053766

هل تريد إبداء ملاحظات على هذا الموضوع؟