التكامل مع التطبيقات الأخرى

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

يمكنك أيضًا الارتباط بتطبيقات أخرى من Survey123، مثل ArcGIS QuickCapture وArcGIS Field Maps.

تلميح:

يفتح Survey123 Mobile روابط لثلاثة تطبيقات: Survey123 Mobile وتطبيق Survey123 الميداني وQuickCapture. عند تشغيل أي من هذه الروابط من داخل Survey123 Mobile (من استخدام رابط، أو امسح رمز الاستجابة السريعة أو من رابط موجود في استطلاع أو مشروع QuickCapture)، فإنها ستفتح داخل Survey123 Mobile. لمزيد من المعلومات، راجع فتح المحتوى.

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

ماذا تشغل	من أين يتم الارتباط	نمط URL المراد استخدامه
Survey123 Mobile	Android iOS	Survey123 رابط التطبيق^1: https://survey123-mobile.arcgis.app مثال: https://survey123-mobile.arcgis.app?itemID=e1c38715587b4e4faf1e419090c25270
	Windows Android iOS^2	مخطط عنوان URL مخصص^3: arcgis-survey123-mobile:// مثال: arcgis-survey123-mobile://?itemID=e1c38715587b4e4faf1e419090c25270
تطبيق الويب	مستعرض الويب	نموذج الاستطلاع حسب الهوية: https://survey123.arcgis.com/share/ID مثال: https://survey123.arcgis.com/share/e1c38715587b4e4faf1e419090c25270
التطبيق الميداني	Android iOS	Survey123 رابط التطبيق^1: https://survey123.arcgis.app مثال: https://survey123.arcgis.app?itemID=e1c38715587b4e4faf1e419090c25270
	Windows Android iOS^2	مخطط عنوان URL مخصص^3: arcgis-survey123:// مثال: arcgis-survey123://?itemID=e1c38715587b4e4faf1e419090c25270
Survey123 Studio	Windows	مخطط عنوان URL مخصص^3: arcgis-survey123-studio:// مثال: arcgis-survey123-studio://?portalUrl=https://www.arcgis.com%26itemID=e1c38715587b4e4faf1e419090c25270
Survey123 Connect	Windows	مخطط عنوان URL مخصص^3: arcgis-survey123connect:// مثال: arcgis-survey123connect://?portalUrl=https://www.arcgis.com%26itemID=e1c38715587b4e4faf1e419090c25270
تطبيق آخر	نموذج الاستطلاع	رابط من Survey123: يختلف حسب التطبيق

¹—تتوافق روابط تطبيق Survey123 مع المتطلبات المحددة بواسطة App Store وGoogle Play، وتمكِّن الارتباط بالمزيد من التطبيقات ودعم الروابط المختصرة التي تسهل مشاركتها.

²—على أجهزة iOS، لا يتم اعتماد مخططات عنوان URL المخصص إلا لمجموعة محددة من التطبيقات.

³—لا يمكن اختصار روابط مخطط عنوان URL المخصصة، وقد يصعب فتحها على نظام Android. ضع في اعتبارك تقديم روابط مخطط عنوان URL المخصصة في شكل ارتباطات تشعبية، مماثلة لما يلي:

<a href="arcgis-survey123-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19">Open survey</a>

معلمات عنوان URL

يمكنك إضافة معلمات URL إلى نهاية الروابط لتخصيص كيفية فتح التطبيق بشكل أكبر. على سبيل المثال، يمكنك تعيين الموقع الافتراضي لسؤال النقطة الجغرافية أو تعبئة سؤال نصي.

تبدأ معلمات عنوان URL بالحرف؟، ويتم الفصل بينها بالحرف &. يوضح المثال التالي مخطط عنوان URL مخصصًا، حيث تبدأ المعلمة الأولى (itemID) بالحرف؟، ويفصل كل معلمة عن معلمات الحقل التالي (color_1 وcolor_2) بالحرف &.

arcgis-survey123-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:color_1=red&field:color_2=blue

للحصول على مزيد من الأمثلة على عناوين URL ومعلمات URL المدعومة، راجع تشغيل Survey123 Mobile، وظائف المعالم | ArcGIS Arcade | مطور Esri، تشغيل تطبيق الويب، وتشغيل التطبيق الميداني، وتشغيل Survey123 Connect، وتشغيل تطبيق آخر من Survey123.

ملاحظة:‏

قبل استخدام رابط يحتوي على معلمات لبدء استطلاع في Survey123 Mobile أو التطبيق الميداني، يوصى بتثبيت التطبيق بالفعل على الجهاز. لمزيد من المعلومات، راجع موضوع تثبيت ArcGIS Survey123.

تشفير URL

بالرغم من أن معلمات URL غير المرمزة تعمل في بعض البيئات، فمن المستحسن أن تقوم بترميز معلمات URL. يستبدل الترميز الحروف غير الصالحة بعلامة النسبة المئوية (% ) متبوعة بشكل سداسي مكافئ لها.

على سبيل المثال، ما يلي هو ارتباط Survey123 يستخدم رد اتصال للعودة إلى مشروع معين في QuickCapture مع معلمات غير مشفرة:

https://survey123-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https://quickcapture.arcgis.app?itemID=867895a71a1840399476fc717e76bb43

ما يلي هو نفس عنوان URL مع المعلمات المشفرة:

https://survey123-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https%3A%2F%2Fquickcapture.arcgis.app%3FitemID=867895a71a1840399476fc717e76bb43

يجب عدم تكويد علامة يساوي التي تحدد فاصلاً بين مفتاح وقيمته.

تلميح:

طريقة واحدة لإنشاء معلمات مشفرة هي باستخدام ArcGIS Arcade. تتيح لك دالة UrlEncode تحديد مجموعة من أزواج القيم الرئيسية التي تمثل كل معلمة وتنتج عنوان URL بترميز مناسب.

قد يرغب مؤلف الاستطلاع أيضًا في إخفاء معلمات عنوان URL بحيث لا تظهر البيانات الحساسة في عنوان URL. في هذه الحالة، عند إنشاء عنوان URL لاستخدامه في تطبيق الويب، قم بتضمين encodeUrlParams=true. لمزيد من المعلومات، راجع معلمات URL لفتح تطبيق الويب.