تشغيل التطبيق الميداني

يمكنك إنشاء روابط التطبيق لفتح التطبيق الميداني Survey123 من تطبيق آخر، أو خريطة ويب منبثقة، أو رابط تشعبي في بريد إلكتروني أو موقع ويب. استخدم مخطط عنوان URL مخصصًا لتشغيل التطبيق من متصفح الويب أو استخدم رابط تطبيق Survey123 لتشغيله من تطبيق على أجهزة Android أو iOS. استخدم معلمات عنوان URL لتخصيص كيفية فتح التطبيق الميداني، مثل تحميل استطلاع محدد، وتعيين الإحداثيات لموقع الخريطة الافتراضي، وملء الإجابات على الأسئلة بقيم محددة مسبقًا أو عن طريق تمرير سمات البيانات من خريطة الويب المنبثقة.

رابط من متصفح ويب على أجهزة Windows

يمكنك إنشاء رابط لفتح التطبيق الميداني الذي يمكن تضمينه في تطبيق آخر. ويمكن أيضًا إدخال نفس الارتباط في مستعرض ويب بهدف الاختبار.

ملاحظة:‏

بمجرد إنشاء الرابط، يمكنك استبدال arcgis-survey123:// بـ https://survey123.arcgis.app كرابط Survey123 للاستخدام في iOS أو Android.

تصف الخطوات التالية كيفية إنشاء مخطط عنوان URL مخصص واستخدامه في مستعرض ويب سطح المكتب:

1. اكتب arcgis-survey123:// في المستعرض.

   يفتح التطبيق الميداني Survey123 (أو تقوم بالترقية لفتحه).

   ملاحظة:‏

   لبدء تشغيل استطلاع وتنزيله من بوابة إلكترونية محددة، قم بتضمين معلمة عنوان URL للبوابة الإلكترونية، على سبيل المثال، arcgis-survey123://?portalUrl=host.domain.com/webadaptor (حيث يتم استبدال host وdomain وwebadaptor من قبل معلومات البوابة).

2. أضف مرجعًا فريدًا للاستطلاع وأضفه إلى عنوان URL:
   1. حدد معرف عنصر الاستطلاع الذي تريد فتحه.

      ملاحظة:‏

      هذه هي سلسلة الأحرف التي يستخدمها ArcGIS Online لتعريف الاستطلاع بشكل فريد، ويمكن العثور عليها في عنوان URL لعنصر النموذج في ArcGIS Online. على سبيل المثال، يكون عنوان URL الخاص بالاستطلاع هو https://exampleurl.maps.arcgis.com/home/item.html?id=36ff9e8c13e042a58cfce4ad87f55d19، ويكون معرف عنصر النموذج هو 36ff9e8c13e042a58cfce4ad87f55d19.

   2. قم بتضمين الاستطلاع في عنوان URL عن طريق إضافة ?itemID= ومعرف عنصر النموذج الخاص بك إلى نهاية عنوان URL.
   يجب أن يبدو عنوان URL مشابهًا لما يلي:

   arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19

   إذا قمت باختبار عنوان URL، فيجب الآن فتح تطبيق Survey123 الميداني وفتح الاستطلاع على الفور.

   ملاحظة:‏

   إذا لم يكن موجودًا بالفعل على جهازك، فسيتم تنزيل الاستبيان عليه.

3. قم بتضمين إجابات محددة مسبقًا للأسئلة عن طريق إضافة مرجع في عنوان URL إلى حقل باستخدام الاسم المخصص له في XLSForm (وليس في التسمية). على سبيل المثال، لتعبئة حقل اللقب، اكتب &field: surname= والقيمة.

   تعمل & كفاصل معلمة وتشير field: إلى اسم السؤال المراد ملؤه.

   يجب أن يبدو عنوان URL مشابهًا لما يلي:

   arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser

   يمكنك الآن استخدام عنوان URL لفتح تطبيق Survey123 الميداني والاستطلاع وملء السؤال المحدد بالإجابة التي حددتها. يمكنك تعبئة أسئلة متعددة في عنوان URL لاستطلاع واحد. أسماء الحقول حساسة لحالة الأحرف.

4. حدد موقعًا لسؤال النقطة الجغرافية في الاستطلاع عن طريق إضافة إحداثيات إلى عنوان URL:
   • اكتب &center=، واكتب الإحداثيات.
   • اكتب إحداثيات دائرة العرض وخط الطول بدرجات عشرية مفصول بفاصلة مفردة.
   • اختياريًا، أضف الارتفاع بالأمتار العشرية كقيمة ثالثة، مفصولة أيضًا بفاصلة واحدة.

   يجب أن يبدو عنوان URL النهائي مشابهًا لما يلي:

   arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser&center=37.8199,-122.4783,20

   سيفتح الآن عنوان URL تطبيق Survey123 الميداني، والاستطلاع المختار، ويملأ سؤالاً نصيًا، ويوفر موقعًا افتراضيًا جديدًا لسؤال النقطية الجغرافية.

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

5. افتح خريطة الويب وحدد النوافذ المنبثقة لإحدى الطبقات. يختار إضافة محتوى وتحديد نص. قم بتوفير النص الذي سيتم عرضه للرابط وانقر فوق الزر رابط لإدخال قيمة عنوان URL للرابط.

   

   يقوم عنوان URL هذا بتعبئة حقل اللقب بمحتويات سمة الاسم للمعلم المحدد بدلًا من قيمة معينة:

   arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname={name}

   يقوم عنوان URL هذا بتعبئة حقل hydrantGlobalID بالمعرف العالمي للصنبور المحدد:

   arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:hydrantGlobalID={globalid}

   ملاحظة:‏

   بشكل افتراضي، لا يمكن تمرير القيم إلا لتحديد سؤال أو تحديد عدة أسئلة من نافذة منبثقة في خريطة الويب إذا كان اسم الخيار المقابل وتسميته متطابقين. إذا كانت الأسماء والتسميات في قائمة الاختيار الخاصة بك مختلفة، فيمكنك استخدام دوال DomainCode أو UrlEncode في تعبير ArcGIS Arcade في القائمة المنبثقة لتمرير القيمة المطلوبة.

   لا يمكن ملء الأسئلة داخل التكرارات.

رابط من تطبيق آخر على أجهزة iOS أو Android

يمكنك إنشاء رابط لاستخدامه في تطبيقات ArcGIS لفتح Survey123 والتقاط البيانات في استطلاع. توضح الخطوات أدناه كيفية إنشاء رابط تطبيق Survey123 واستخدامه في نافذة منبثقة لخريطة الويب. يتم إدخال هذا الارتباط في النافذة المنبثقة لخريطة الويب في مؤسسة ArcGIS. يمكنك اختبار الرابط باستخدام مستعرض الويب (باستخدام خطوات مماثلة كما في القسم السابق) على أحد أجهزة iOS أو Android.

1. افتح خريطة الويب التي سيتم عرضها على الجهاز وحدد النوافذ المنبثقة لإحدى الطبقات.
2. اختر إضافة محتوى وحدد نص.
3. اكتب تشغيل Survey123، وقم بتمييز هذا النص، ثم انقر فوق الزر رابط لإدخال عنوان URL للرابط. اكتب https://survey123.arcgis.app، ثم انقر فوق موافق.
   1. افتح خريطة الويب على جهاز محمول إما من مستعرض أو تطبيق ArcGIS.
   2. حدد معلم وانقر فوق الارتباط Launch Survey123 في النافذة المنبثقة لفتح Survey123.
4. لتضمين الاستطلاع في عنوان URL، قم بإضافة ?itemID= ومعرف عنصر النموذج الخاص بك إلى نهاية عنوان URL.
   يجب أن يبدو عنوان URL مشابهًا لما يلي:

   https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19

   إذا قمت باختبار عنوان URL، فيجب الآن فتح تطبيق Survey123 الميداني وفتح الاستطلاع على الفور.

   ملاحظة:‏

   إذا لم يكن موجودًا بالفعل على جهازك، فسيتم تنزيل الاستبيان عليه.

5. قم بتضمين إجابات محددة مسبقًا للأسئلة عن طريق إضافة مرجع في عنوان URL إلى حقل باستخدام الاسم المخصص له في XLSForm (وليس في التسمية). على سبيل المثال، لتعبئة حقل اللقب، اكتب &field: surname= والقيمة.

   تعمل & كفاصل معلمة وتشير field: إلى اسم السؤال المراد ملؤه.

   يجب أن يبدو عنوان URL مشابهًا لما يلي:

   https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser

   يمكن الآن استخدام عنوان URL لفتح تطبيق Survey123 الميداني والاستطلاع، وملء السؤال المحدد بالإجابة التي حددتها. يمكنك تعبئة أسئلة متعددة في عنوان URL لاستطلاع واحد. أسماء الحقول حساسة لحالة الأحرف.

6. حدد موقعًا لسؤال النقطة الجغرافية في الاستطلاع عن طريق إضافة إحداثيات إلى عنوان URL:
   • اكتب &center=، واكتب الإحداثيات.
   • اكتب إحداثيات دائرة العرض وخط الطول بدرجات عشرية مفصول بفاصلة مفردة.
   • اختياريًا، أضف الارتفاع بالأمتار العشرية كقيمة ثالثة، مفصولة أيضًا بفاصلة واحدة.

   يجب أن يبدو عنوان URL النهائي مشابهًا لما يلي:

   https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser&center=37.8199,-122.4783,20

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

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

يمكن استخدام المعلمات التالية لتخصيص كيفية فتح التطبيق:

المعلمة	الوصف	النوع
center	توسيط الخريطة إلى خط طول ودائرة عرض وارتفاع اختياري معروف. مثال: center=37.8199,-122.4783,20	السلسلة
field:fieldname	يملأ أسئلة الاستطلاع بقيم الحقول. مثال: field:surname=Klauser	السلسلة
portalUrl	عنوان URL للبوابة الإلكترونية حيث يتم استضافة عنصر الاستطلاع. مثال: portalUrl=https://myorg.arcgis.com	السلسلة
itemID	النموذج المراد فتحه. مثال: itemID=36ff9e8c13e042a58cfce4ad87f55d19	UUID
download	يقوم بتنزيل الاستطلاع تلقائيًا عندما يكون الجهاز متصلاً بالإنترنت. الوضع الافتراضي هو true. مثال: download=false	منطقي
action	يحدد كيفية فتح الاستطلاع. القيم المدعومة هي collect (الافتراضي) و edit و view و copy. مثال: action=edit	السلسلة
folder	يحدد المجلد المراد عرضه عند فتح الاستطلاع. القيم المدعومة هي inbox وdrafts وoutbox وsent و* (مجلد نظرة عامة). أضف المعلمة filter إلى عنوان URL لتصفية الاستطلاعات الموجودة في المجلد المحدد. حدد المعلمة folder=* وfilter لتصفية الاستطلاعات في جميع المجلدات وعرضها في مجلد نظرة عامة. أمثلة: folder=inbox folder=*&filter=lake	السلسلة
callback	عنوان URL للرجوع إليه عند اكتمال إجراء نموذج (على سبيل المثال، إرسال المسودات أو النقل إليها أو الإلغاء أو الخروج). مثال: callback=https://quickcapture.arcgis.app	محدد موقع معلومات (URL)
callback:status	يحدد حالة الاستطلاع عند تنشيط رد الاتصال. القيم المدعومة للحالة هي cancel وdraft وsubmit وclose. يمكن استخدام الحالة close فقط عند action=view. مثال: callback:draft=https://quickcapture.arcgis.app	السلسلة
filter	يعمل على تصفية الاستطلاعات الحالية على الجهاز والتي تتطابق مع سلسلة موجودة إما في اسم المثيل أو حقل محدد. يعمل على تصفية صندوق الوارد بشكل افتراضي. أضف المعلمة folder إلى عنوان URL لتصفية الاستطلاعات الموجودة في مجلد محدد. عند تحديد اسم المثيل، أدخل سلسلة تمثل إما اسم المثيل كاملاً أو سلسلة فرعية لاسم المثيل. توضح الأمثلة التالية كيفية تصفية جميع السجلات التي تتضمن اسم المثيل Klauser كاملاً أو جميع السجلات في المسودات التي تتضمن الكلمة lake في اسم المثيل الخاص بها. أمثلة: filter=Klauser filter=lake&folder=drafts عند عدم تحديد اسم مثيل أو التصفية حسب حقل لا يُعد جزءًا من اسم المثيل، قم بتضمين اسم الحقل وقيمة الحقل، بالتنسيق filter=field:fieldname:fieldvalue. يمكن فقط تصفية قيم الحقل الكاملة باستخدام الحقل. توضح الأمثلة التالية طريقة التصفية لإظهار السجلات التي يكون نوع المسطح المائي فيها نهر أو التي يكون رقم المحطة الخاص بها 5171. أمثلة: filter=field:waterbodytype:River filter=field:ws_stationnumber:5171	السلسلة
update	يقوم بتحديث مجلد صندوق الوارد عند استخدامه مع المعلمة folder=inbox. إذا كان عنوان URL يتضمن كلاً من update وfilter، فسيتم تطبيق عامل التصفية بعد التحديث. الوضع الافتراضي هو false. مثال: update=true&folder=inbox	منطقي
q:queryparameter	يستعلم عن طبقة المعالم لسجل موجود. يُستخدم ذلك لاستعادة المحتوى غير الموجود على الجهاز بالفعل. أمثلة: q:where=ws_stationnumber=5171 q:where=waterbodytype='Lake' q:globalId=1d392670-33e2-456d-8435-7fad3abd8bb9	السلسلة