يمكن دمج ArcGIS Survey123 مع تطبيقات أخرى باستخدام الروابط لفتح تطبيق الويب Survey123 أو التطبيق الميداني Survey123 Connect أو تطبيق آخر. على سبيل المثال، يمكنك إنشاء روابط التطبيق لتشغيل التطبيق الميداني Survey123 وفتحه من تطبيق Esri آخر، أو خريطة ويب منبثقة، أو رابط تشعبي بسيط في بريد إلكتروني أو موقع ويب. يمكنك استخدام عنوان URL لتنزيل الاستطلاع وفتحه تلقائيًا لتحريره في Survey123 Connect. يمكنك أيضًا الارتباط بتطبيقات أخرى من Survey123، مثل ArcGIS QuickCapture وArcGIS Field Maps.
استخدم أنماط عنوان URL الموجودة في الجدول لإنشاء روابط للوصول من متصفح الويب أو تطبيق آخر.
| ماذا تشغل | من أين يتم الارتباط | نمط URL المراد استخدامه |
|---|---|---|
تطبيق الويب | مستعرض الويب | نموذج الاستطلاع حسب الهوية: |
التطبيق الميداني | Android وiOS | رابط تطبيق Survey123 |
Windows، Android، مجموعة مختارة من التطبيقات على نظام iOS | مخطط عنوان URL المخصص: | |
Survey123 Connect | Windows | مخطط عنوان URL المخصص: |
تطبيق آخر | نموذج الاستطلاع | رابط من Survey123: يختلف حسب التطبيق |
توضح الأمثلة التالية كيفية فتح استطلاع محدد باستخدام أنماط عنوان URL هذه:
- https://survey123.arcgis.com/share/36ff9e8c13e042a58cfce4ad87f55d19
- https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19
- arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19
- arcgis-survey123connect://?portalUrl=https://www.arcgis.com&itemID=36ff9e8c13e042a58cfce4ad87f55d19
تتوافق روابط تطبيق Survey123 مع المتطلبات المحددة بواسطة App Store وGoogle Play، وتمكِّن الارتباط بالمزيد من التطبيقات ودعم الروابط المختصرة التي تسهل مشاركتها.
لا يمكن اختصار روابط مخطط عنوان URL المخصصة، وقد يصعب فتحها على نظام Android. ضع في اعتبارك تقديم روابط مخطط عنوان URL المخصصة في شكل ارتباطات تشعبية، مماثلة لما يلي:
<a href="arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19">Open survey</a>معلمات عنوان URL
يمكنك إضافة معلمات URL إلى نهاية الروابط لتخصيص كيفية فتح التطبيق بشكل أكبر. على سبيل المثال، يمكنك تعيين الموقع الافتراضي لسؤال النقطة الجغرافية أو تعبئة سؤال نصي.
تبدأ معلمات عنوان URL بالحرف؟، ويتم الفصل بينها بالحرف &. يوضح المثال التالي مخطط عنوان URL مخصصًا، حيث تبدأ المعلمة الأولى (itemID) بالحرف؟، ويفصل كل معلمة عن معلمات الحقل التالي (color_1 وcolor_2) بالحرف &.
arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:color_1=red&field:color_2=blueللحصول على مزيد من الأمثلة على عناوين URL ومعلمات URL المدعومة، راجع تشغيل تطبيق الويب، وتشغيل التطبيق الميداني، وتشغيل Survey123 Connect، وتشغيل تطبيق آخر من Survey123.
ملاحظة:
قبل استخدام رابط يحتوي على معلمات لبدء استطلاع في التطبيق الميداني، يوصى بتثبيت التطبيق بالفعل على الجهاز. للحصول على مزيد من المعلومات، راجع موضوع تثبيت تطبيق Survey123 الميداني.
تشفير URL
بالرغم من أن معلمات URL غير المرمزة تعمل في بعض البيئات، فمن المستحسن أن تقوم بترميز معلمات URL. يستبدل الترميز الحروف غير الصالحة بعلامة النسبة المئوية (% ) متبوعة بشكل سداسي مكافئ لها.
على سبيل المثال، ما يلي هو ارتباط Survey123 يستخدم رد اتصال للعودة إلى مشروع معين في QuickCapture مع معلمات غير مشفرة:
https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https://quickcapture.arcgis.app?itemID=867895a71a1840399476fc717e76bb43ما يلي هو نفس عنوان URL مع المعلمات المشفرة:
https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https%3A%2F%2Fquickcapture.arcgis.app%3FitemID=867895a71a1840399476fc717e76bb43يجب عدم تكويد علامة يساوي التي تحدد فاصلاً بين مفتاح وقيمته.
تلميح:
طريقة واحدة لإنشاء معلمات مشفرة هي باستخدام ArcGIS Arcade. تتيح لك دالة UrlEncode تحديد مجموعة من أزواج القيم الرئيسية التي تمثل كل معلمة وتنتج عنوان URL بترميز مناسب.
قد يرغب مؤلف الاستطلاع أيضًا في إخفاء معلمات عنوان URL بحيث لا تظهر البيانات الحساسة في عنوان URL. في هذه الحالة، عند إنشاء عنوان URL لاستخدامه في تطبيق الويب، قم بتضمين encodeUrlParams=true. لمزيد من المعلومات، راجع معلمات URL لفتح تطبيق الويب.