تشغيل Survey123 Mobile

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

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

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

ملاحظة:‏

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

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

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

   يتم فتح Survey123 Mobile (أو يُطلب منك فتحه).

   ملاحظة:‏

   لبدء تشغيل استطلاع وتنزيله من بوابة إلكترونية محددة، قم بتضمين معلمة عنوان URL للبوابة الإلكترونية، على سبيل المثال، arcgis-survey123-mobile://?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-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19

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

   ملاحظة:‏

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

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

   على سبيل المثال، لتعبئة حقل Surname، اكتب &field:surname= والقيمة.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   ملاحظة:‏

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

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

   على سبيل المثال، لتعبئة حقل Surname، اكتب &field:surname= والقيمة.

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

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

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

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

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

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

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

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

معلمات عنوان URL لبدء تشغيل Survey123 Mobile

يمكن استخدام المعلمات التالية لتخصيص كيفية فتح Survey123 Mobile:

المعلمة	الوصف	النوع
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	منطقي
callback	عنوان URL للرجوع إليه عند اكتمال إجراء نموذج (على سبيل المثال، إرسال المسودات أو النقل إليها أو الإلغاء أو الخروج). مثال: callback=https://quickcapture.arcgis.app	محدد موقع معلومات (URL)
callback:status	مثال: callback:draft=https://quickcapture.arcgis.app	السلسلة