سيقوم Survey123 Connect بتحويل النماذج المصممة باستخدام مواصفات XLSForm إلى XForm لاستخدامها في Survey123 ونشرها في ArcGIS Online أو ArcGIS Enterprise. قد تظهر بعض المشكلات أثناء هذه العملية.
تلميح:
تتحقق أداة تحليل الاستطلاع من XLSForm للاستطلاع لمتابعة المشكلات الشائعة وتوفير توصيات لأفضل الممارسات في تصميم الاستطلاع.أخطاء محادثة النموذج
عند إنشاء استطلاع في Survey123 Connect، فإنك تستخدم مواصفات XLSForm لتصميم النموذج الخاص بك باستخدام جدول بيانات. يحول Survey123 Connect جدول البيانات إلى XForm، مما يسمح لك بمعاينة استطلاعك كما سيظهر في Survey123.
تحدث المحادثة بعد قيامك بما يلي:
- احفظ التغييرات في جدول البيانات.
- انقر فوق زر التحديث في Survey123 Connect
في حالة وجود مشكلة في الاستطلاع، ستتلقى خطأً من خدمة تحويل النموذج. في المثال التالي، تُشير رسالة الخطأ إلى أن المشكلة تكمن في إدخال الاسم الذي يُطلق عليه الاسم الأخير. في هذه الحالة، يحتوي الإدخال على مسافه فيه. ينبغي إزالة المسافة أو استبدالها بشرطة سفلية أو شرطة.
يتم إدراج بعض أخطاء النموذج الشائعة في الجدول التالي:
| وصف الخطأ | التشخيص |
|---|---|
خطأ تحويل نموذج XLS | في المثال المذكور أعلاه، يطلق على هذا الخطأ الذي ميّز السؤال بالاسم الأخير. في تلك الحالة، يكون الخطأ هو المسافة الموجوددة في عمود الاسم. خطأ آخر شائع الذي ينتج عن هذه الراسلة يكون عند استخدام أحرف غير ASCII في عمود الاسم من ورقة عمل الاستطلاع أو الاختيارات. يمكن استخدام أحرف ASCII في عمود لافتة التسمية لكن ليس عمود الاسم. |
[الصف : 2] اسم القايمة ليس في جدول الاختيارات: [JobType] | يوضح هذا الخطأ أن أحد أسئلة select_one أوselect_multiple يُشير إلى قائمة غير موجودة في ورقة عمل الاختيارات. في هذا المثال، ينبغي إزالة الأقواس. |
يجب أن يكون هناك اختيارات لهذا السؤال. | يوضح هذا الخطأ أن أحد أسئلة select_one أو select_multiple الذي يحتوي على معلمة or_other إضافية كجزء من النوع يحتوي أيضًا على عامل تصفية اختيار محدد. حدد الأسئلة التي تشمل خيار إدخال قيمة من أخرى يتعذر استخدامها في تحديد متتالي. |
أخطاء الشبكة
إذا كان لديك مشاكل في الوصول إلى خدمة محادثة النموذج، سوف تستلم خطأ مماثل لما يلي:
يتم إدراج بعض أخطاء الشبكة الشائعة في الجدول التالي:
| رقم الخطأ | وصف الخطأ | التشخيص |
|---|---|---|
-1 | يتعذر فتح C:/Users/Username/ArcGIS/My Survey Designs/Form 1/Form 1.xlsx | قد يحتوي Excel على قفل على الملف الخاص بك. تأكد من عدم فتح الاستطلاع بواسطة تطبيق آخر أو مستخدم آخر. |
3 | لم يتم العثور على Host survey123.arcgis.com | أنت تقوم بتشغيل إصدار سابق من Survey123 Connect. قم بالترقية إلى الإصدار الأحدث. |
6 | فشل تأكيد اتصال SSL | هناك عدد من المشكلات التي قد تتسبب في فشل اتصال SSL، مثل ما يلي:
يمكنك اختبار شهادات SSL المستخدمة في خادم ويب باستخدام أداة اختبار عبر الإنترنت مثل مختبرات SSL. |
99 | تم انقضاء فترة الاتصال | تمت ملاحظة شيء ما عند العمل مع الاستطلاعات الكبيرة جدًا. حاول مرة أخرى. |
202 | حدث خطأ أثناء تنزيل https://survey123.esri.com/api/xls2xform - رد الخادم: ممنوع | أي خطأ يحتوي على esri.com في الرسالة يشير إلى الخادم القديم. قم بالترقية إلى الإصدار الأحدث. |
203 | حدث خطأ أثناء تنزيل https://survey123.esri.com/api/xls2xform - رد الخادم: غير موجود | أي خطأ يحتوي على esri.com في الرسالة يشير إلى الخادم القديم. قم بالترقية إلى الإصدار الأحدث. |
401 | حدث خطأ أثناء تنزيل https://survey123.arcgis.com/api/xls2xform - رد الخادم: خطأ داخلي في الخادم | يتم تشغيل هذا الخطأ عادةً بواسطة التعبيرات الموجودة في الأعمدة ذات الصلة أو أعمدة الحسابات. استخدم الأقواس المتعرجة وتشمل الرمز $ في بداية العبارة. |
403 | حدث خطأ أثناء تنزيل https://survey123.esri.com/api/xls2xform - رد الخادم: الخدمة غير متوفرة مؤقتًا | إبلاغ Esri بهذا الآن. |
498 | رمز مميز غير صالح | لم يتم قبول الرمز المميز الذي حاول Survey123 Connect تمريره إلى ArcGIS. هذا يحدث في كثير من الأحيان عن طريق إرسال عنوان URL في محاولة لتمرير الرمز المميز إلى طبقة معلم عامة. |
499 | حدث خطأ في تحويل https://survey123.arcgis.com/api/xls2xform - رد الخادم: خطأ في الوكيل | واجهة برمجة تطبيقات Survey123 غير متوفرة أو انتهت مهلتها. حاول مرة أخرى بعد فترة قصيرة. إذا استمرت المشكلة، فراجع Survey123 مجتمع Esri لمزيد من المعلومات. |
في مربع حوار الخطأ، يمكنك التقاط الخطأ لإرساله إلى Esri. أضف أي معلومات إضافية إلى البريد الإلكتروني التي قد تساعد في تصحيح مسألتك.
أخطاء النشر
تأتي هذه الأخطاء عادةً من مسألة إنشاء العناصر من الاستطلاع الخاص بك في ArvGIS.
يتم إدراج أخطاء النشر الشائعة في الجدول التالي:
| خطأ | التشخيص |
|---|---|
عنوان url للإرسال يكون غير متوافق (الحقل غير موجود) | الحقل الذي لديه الاسم غير موجود في طبقة المعلم المُعيّنة بواسطة عنوان URL للإرسال، مما يعني أن ردود الاستطلاع غير متوافقة مع الاستطلاع. إما إلغاء تعيين عنوان URL للإرسال لإنشاء عنوان جديد، أو تأكيد أن عنوان URL للإرسال يكون هو طبقة المعلم الصحيحة. يحدث هذا الخطأ عادةً بسبب الحقل الإضافي الذي يتم إنشاؤه عند استخدام الخيار or_other لسؤال select_one أو select_multiple. لمزيد من المعلومات، راجع أنواع أسئلة الاختيار من متعدد. |
عنوان url للإرسال يكون غير متوافق (خطأ في الطلب) | تحقق من أن المستخدم الذي سمحت بتسجيل دخوله إلى Survey123 Connect لديه إذن للوصول إلى طبقة المعالم. |
لا يوجد حقل أساسي تابع في SurveyName لـ parent repeat_1 | هذا يحدث إذا كانت طبقة المعلم التي تقوم بإرسالها تعتمد على المفاتيح الأصلية للمعرف العالمي الذي يكون غير موجود في الاستطلاع. في نافذة خيارات النشر، قم بتعيين استخدام المفاتيح الأصلية للمعرف العالمي في علاقات التكرار إلى صواب. |
فشلت عملية إنشاء جدول CREATE TABLE لأن العمود 'x' في الجدول 'y' يتجاوز الحد الأقصى لـ 1024 عمود | يحتوي الاستطلاع الذي تحاول نشره على مزيد من الحقول عن التي تكون مسموح بها بواسطة طبقة المعلم في مؤسسة ArcGIS (1024). قم بتقليل عدد الحقول إلى أقل من 1024 ونشر الاستطلاع مرة أخرى. لمزيد من المعلومات حول هذه القيود، راجع استكشاف المشكلات وإصلاحها في تعليمات ArcGIS Online. |
عنوان URL الخاصة بإرسال خدمة المعالم المخصصة ليس متوافقًا مع هذا الاستطلاع (خدمة المعالم لا تلبي متطلبات الاستطلاع ذي التكرارات - supportsApplyEditsWithGlobalIds) | يتم تعيين خاصية supportsApplyEditsWithGlobalIds إلى خطأ، ويجب أن تكون صحيحة. تتمثل أسهل الطرق للقيام بذلك في المزامنة عند نشر طبقة معالم. |
عنوان URL لتقديم خدمة المعلم المخصص غير متوافق مع هذا الاستطلاع (لم يتم العثور على علاقة الوجهة للجدول) | يقترن التكرار في الاستطلاع بشكل غير صحيح بجدول ذي صلة في طبقة المعلم أو الجدول غير موجود. تأكد أن التكرار يحمل نفس اسم الجدول المتعلق بالوجهة. |
أخطاء البوابة الإلكترونية
تتضمن الاستطلاعات المنشورة في ArcGIS Enterprise القيود الواردة فيما يلي، وهي تختلف عن تلك المنشورة في ArcGIS Online.
- يتعذر عليك نشر الاستطلاعات على ArcGIS Enterprise التي تستخدم كلمات رئيسية محددة تم الاحتفاظ بها في صورة أسماء الحقل، مثل end (تكون أسماء الحقل التي تحتوي على تلك الكلمات الرئيسية مقبولة، مثل endSurvey، طالما أنها ليست الكلمة الرئيسية بالضبط). يتم سرد الكلمات الأساسية المحجوزة في ورقة العمل المحجوزة لقوالب Survey123 XLSForm.
- يجب أن تكون جميع أسماء الحقول بالأحرف الصغيرة عند النشر في ArcGIS Enterprise.
- يعتمد الحد الأقصى لعدد الأعمدة التي يمكن أن تحتويها طبقة المعالم المنشورة على البوابة الإلكترونية على قاعدة البيانات الجغرافية الخاصة بمؤسستك. راجع وثائق نظام إدارة قاعدة البيانات لديك لتحديد حدود الحجم. إذا كان عدد الأسئلة في الاستطلاع الخاص بك يتجاوز حد العمود لقاعدة البيانات الجغرافية الخاصة بمؤسستك، فإن الحل هو تضمين تكرار، وتعيين تكرار_العدد إلى 1 لتوسيع الاستطلاع عبر جداول متعددة.
- يجب أن يكون اسم السؤال في ورقة عمل الاستطلاع أقل من 32 حرفًا.
- يتعذر عليك تحميل محتوى Survey123 على ArcGIS Enterprise أو Portal for ArcGIS في حالة عدم استخدام ArcGIS Data Store.
- عند نشر ArcGIS Enterprise في بيئة غير متصلة، لن تعمل قوالب الاستطلاع والعينات وعناوين URL للإرسال إلى طبقات معالم ArcGIS Online.
- يتعذر إرسال عناوين URL للإرسال مباشرةً مع طبقة معلم ArcGIS Server غير الموحدة. يتوفر حل بديل بواسطة تسجيل الخدمة مع ArcGIS Online أو ArcGIS Enterprise.
- في حالة استخدام قاعدة بيانات جغرافية متعددة المستخدمين، يمكن للطبقات استخدام الإصدار الفرعي وليس الإصدار التقليدي. سيستهدف Survey123 الإصدار الافتراضي عند استخدام قاعدة بيانات جغرافية تم إصدارها في الفرع. لمزيد من المعلومات، راجع أنواع الإصدارات.
- esriFieldTypeDateOnlyesriFieldTypeTimeOnly وesriFieldTypeTimestampOffset وesriFieldBigInteger لا يمكن استخدامها إلا في ArcGIS Online. تتوفر أنواع الحقول هذه في ArcGIS Enterprise الإصدار 11.2 والإصدارات الأحدث.
تمكين التسجيل التشخيصي
إذا لاحظت رسائل خطأ لم يتم إدراجها في هذا الموضوع أو أي سلوك آخر غير متوقع، فقد يكون من المُفيد تسجيل سجلّ معلومات من Survey123 Connect لمشاركته مع شخص آخر (مثل مركز دعم Esri) لاستكشاف الأخطاء وإصلاحها.
لتمكين التسجيل، افتح القائمة في الصفحة الرئيسية للتطبيق، وانقر فوق إعدادات، ثم انقر فوق علامة تبويب التشخيصات.
لالتقاط الرسائل في ملف، انقر فوق زر التبديل التسجيل لتمكين التسجيل. تتم تعبئة نص موقع ناتج السجل تلقائيًا باستخدام الموقع الافتراضي لملف السجل. يمكنك تحرير مسار هذا الملف. لالتقاط الرسائل على وحدة تحكم متوافقة لسجل النظام على الإنترنت، أدخل عنوان URL الخاص به في المربع النصي موقع ناتج السجل في مكان موقع ملف السجل.
يمكن مشاركة ملفات السجل أو إرسالها عبر البريد الإلكتروني. عندما تختار إرسال السجل عبر البريد الإلكتروني من التطبيق، سيتم تضمين رقم إصدار التطبيق واسم نظام التشغيل والإعدادات المحلية لنظام التشغيل في نص رسالة البريد الإلكتروني وسيتم تضمين السجل في صورة مرفق.
ملاحظة:
بالنسبة إلى التسجيل في الوقت الحقيقي، تَعرِض علامة تبويب التشخيصات أي من مثيلات وحدة تحكم AppStudio مفتوحة حاليًا على شبكتك. يظهر رمز دائرة بحث في علامة تبويب التشخيصات حتى تعثُر على وحدة تحكم AppStudio قيد التشغيل. إذا حددت وحدة تحكم AppStudio أولاً، ونقرت فوق زر تبديل التسجيل، فستبدأ معلومات التسجيل في الظهور في وحدة التحكم. للمزيد من المعلومات، راجع التقاط مخرجات وحدة التحكم في تعليمات ArcGIS AppStudio.