الإعداد لتحرير بيانات الاستطلاع الحالية

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

تمكين التحرير

يمكن تحرير إجابات الاستطلاع من مجلد المُرسَل ومجلد الوارد. لتمكين تحرير الاستطلاع، يجب أيضًا تمكين التحرير لطبقة المعالم الأساسية.

يمكنك تحرير استطلاعات تم إرسالها مسبقًا موجودة في مجلد Survey123المُرسَل بتطبيق الميداني. لمزيد من المعلومات عن كيفية تكوين الخيارات للاستطلاعات المرسلة، راجع مجلد المُرسَل.

لتحرير بيانات الاستطلاع الموجودة والمخزنة في طبقة معالم الاستطلاع (على سبيل المثال، البيانات التي جمعها مستخدم آخر)، يجب تمكين صندوق الوارد.

تنبيه:

يؤدي تمكين صندوق الوارد إلى تمكين الوصول لقراءة بيانات الاستطلاع الخاصة بك، والتي ستكشف عن إجاباتك على الاستطلاع. لمزيد من المعلومات وللتعرف على أفضل الممارسات المستخدمة لتأمين بياناتك، راجع موضوع مشاركة الاستطلاع.

لتمكين الوارد، انتقل إلى علامة التبويب الخيارات في استطلاعك في Survey123 Connect وانقر فوق تمكين مجلد الوارد. تظهر سلسلة من الخيارات، مما يسمح لك بالتحكم في كيفية تفاعل المستخدمين مع الاستطلاعات في صندوق الوارد. تسري أي تغييرات على هذه الخيارات عند نشر الاستطلاع.

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

ملاحظة:‏

يمكن أن يحتوي صندوق الوارد على إجابات استطلاع تبلغ 5,000 كحد أقصى. ينطبق هذا الحد على سجلات الاستطلاع الرئيسية فقط (لا ينطبق على التكرارات).

كلما زاد عدد السجلات المراد إرجاعها، استغرق تحديث صندوق الوارد وقتًا أطول. بالنسبة للاستطلاع الذي يتضمن تكرارات، يجب أن تدرك أن العدد الإجمالي للسجلات التي يستردها صندوق الوارد عند تحديثه قد يكون أكبر بكثير من عدد السجلات الرئيسية. على سبيل المثال، إذا تضمنت طبقة معالم 2,000 سجل رئيسي وتضمن كل سجل رئيسي 10 سجلات تكرار، فسيسترد صندوق الوارد إجمالي 22,000 سجلاً. يمكنك تحديد عدد السجلات الرئيسية من خلال تطبيق تعبير الاستعلام أو التصفية المكانية. يمكنك تحديد عدد سجلات التكرار من خلال تعريف استعلام في العمود bind::esri:parameters.

تنبيه:

لا يمكن لاستجابات الاستطلاع أن توجد على جهاز واحد في أكثر من مجلد في نفس الوقت. عند تمكين كل من مجلد المرسَل و البريد الوارد لإجراء استطلاع، لن يؤدي تحديث صندوق الوارد إلى تنزيل الردود الموجودة بالفعل في مجلد المرسَل. هذا يعني أنه إذا تم تحديث إجابة موجودة في مجلد المرسّل من قبل مستخدم على جهاز آخر، فلن يتم تنزيل الإجابة المحدثة إلى صندوق الوارد.

لهذا السبب، يوصى بعدم تمكين مجلد المُرسَل ومجلد الوارد لنفس الاستطلاع إذا كان القصد هو أن يقوم العديد من المستخدمين بتحرير الإجابات الموجودة وتحديثها باستمرار.

تعبيرات WHERE

يتم تحديد الاستطلاعات المتوفرة للتحرير في صندوق الوارد في تطبيق Survey123 الميداني بواسطة تعبير الاستعلام المحدد في علامة تبويب الخيارات في الاستطلاع الخاص بك في Survey123 Connect. يجب نشر الاستطلاع في كل مرة يتم فيها تعديل الاستعلام لإجراء التغييرات.

يجب أن تستخدم تعبيرات الاستعلام بناء الجملة SQL الشائع والوظائف المدعومة من ArcGIS. يتم تشغيل جميع الاستعلامات على طبقة المعالم الخاصة بالاستطلاع، ومن ثَم يمكنك إنشاء تعبيرك واختباره باستخدام عملية الاستعلام على نقطة نهاية REST الخاصة بطبقة المعالم. لمزيد من المعلومات عن هذه العملية وللحصول على أمثلة على بناء جملة الاستعلام، راجع الاستعلام (خدمة المعالم). لمزيد من المعلومات عن الوظائف المدعومة، راجع وظائف SQL القياسية في ArcGIS Online.

فيما يلي مثال على حالات الاستخدام وبناء الجملة:

• يُرجع هذا المثال الاستطلاعات التي يكون فيها الرقم في حقل rating أكبر من أو يساوي اثنين:

  rating>=2

• يُرجع هذا المثال الاستطلاعات التي يكون التاريخ الموجود فيها في حقل EditDate موافقًا ليوم 13 أبريل 2017 أو بعده:

  EditDate>='2017-4-13'

• يُرجع هذا المثال الاستطلاعات التي يكون فيها حقل Editor متساويًا مع 'BKlauser':

  Editor='BKlauser'

• يُرجع هذا المثال الاستطلاعات التي كون فيها حقل status متساويًا مع 'for_review':

  status='for_review'

• يُرجع هذا المثال الاستطلاعات التي يكون فيها التاريخ في حقل inspection_date في الأيام السبعة الأخيرة:

  inspection_date>CURRENT_DATE-7 AND inspection_date<=CURRENT_DATE

• يُرجع هذا المثال الاستطلاعات التي لا يكون فيها حقل project_status متساويًا مع 'مكتمل':

  project_status<>'complete'

• يُرجع هذا المثال الاستطلاعات التي يكون فيها حقل final_approval فارغًا (خاليًا):

  final_approval IS NULL

• يُرجع هذا المثال الاستطلاعات التي لا يكون فيها حقل final_approval فارغًا (خاليًا):

  final_approval IS NOT NULL

تدعم استعلامات صندوق الوارد أيضًا متغير username. يجب تحديد هذا المتغير بتنسيق تعبيرات XLSForm نفسها. على سبيل المثال، سيُرجع استعلام Creator=${username} جميع سجلات الاستطلاع التي تم إنشائها بواسطة المستخدم المسجّل الدخول حاليًا.

ملاحظة:‏

المتغير username هو الحالة الوحيدة التي يمكن فيها استخدام بناء جملة XLSForm في تعبير استعلام علبة الوارد. على الرغم من أنه يجب كتابة المتغير username باسم ${username}، فإن قيمته مشتقة من حساب ArcGIS الخاص بالمستخدم الذي قام بتسجيل الدخول، وليس من سؤال في الاستطلاع.

لإرجاع سجلات للمستخدم الذي قام بتسجيل الدخول من حقل يحتوي على قائمة بمستخدمين متعددين، يجب استخدام دالة POSITION() في الاستعلام. على سبيل المثال، قد يقوم الاستعلام POSITION(${username} IN assigned_to) > 0 بإرجاع كافة سجلات الاستطلاع التي تتضمن المستخدم الذي قام بتسجيل الدخول، حيث قد تكون القيم الموجودة في حقل assigned_to عبارة عن قائمة مفصولة بفواصل تضم كافة المكلفين المحتملين، مثل "George_Smith وNick_Jones".

عامل التصفية المكاني

في صندوق الوارد، يؤدي تحديد تحديث إلى تحديث قائمة الاستطلاعات المعروضة في علامة التبويب القائمة. يُرجع إجراء التحديث بشكل عام كل الاستطلاعات التي تفي بتعبير استعلام صندوق الوارد (في حالة تعيينها) والتي لم يتم تخزينها بالفعل في مجلدات أخرى على الجهاز. عند تحديد تحديث في علامة التبويب الخريطة، يمكن تطبيق عامل تصفية مكاني لتحديث القائمة لعرض تلك الاستطلاعات الموجودة ضمن نطاق الخريطة الحالي فقط.

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

تكرار

يسمح Survey123 بتحرير المعالم التي تحتوي على سجلات ذات صلة إما من مجلد الوارد أو مجلد المُرسَل. في تطبيق Survey123 الميداني يمكن إضافة سجلات جديدة وتحرير السجلات الحالية، بالرغم من أن حذف السجلات الحالية غير مدعوم. يتم تعطيل تحرير السجلات الموجودة بشكل افتراضي إلا إذا تم تمكين allowUpdates=true من خلال معلمة استعلام.

تنبيه:

يمكنك إضافة السجلات وتحريرها وحذفها بشكل متكرر في تطبيق وموقع الويب Survey123، بصرف النظر عن المعلمات الموجودة في العمود bind::esri:parameters. لمزيد من المعلومات، راجع موضوع تحرير بيانات الاستطلاع الموجودة.

يمكن استخدام العمود bind::esri:parameters لتوفير معلمات اختيارية للتكرار. يتم تنسيق هذه المعلمات كأجواج قيمة أساسية، بقيم تحتوي على مسافات موضوعة في علامات اقتباس.

افتراضيًا، لا توجد سجلات ذات صلة متوفرة بها إجابات الاستطلاع من مجلد الوارد أو مجلد المُرسَل. للوصول إلى سجلات ذات صلة للاستجابة، قم بتحديد استعلام في عمود bind::esri:parameters في نوع سؤال بدء التكرار. تدعم خاصية الاستعلام معلمات تعبيرات WHERE نفسها الواردة أعلاه، على سبيل المثال، query="Editor='BKlauser'"، لتنزيل السجلات المرتبطة بـ 'BKlauser' فقط في حقل Editor.

لتنزيل جميع السجلات في جدول ذات صلة، حدد استعلامًا بدون أي معلمات (query).

تشمل المعلمات التي يمكن تطبيقها على التكرارات من خلال عمود bind::esri:parameters على نوع سؤال بدء التكرار ما يلي:

• query - يتيح الاستعلام عن السجلات وتنزيلها إلى الجدول ذي الصلة، على سبيل المثال، query="severity='high'".
• allowAdds—يتيح إضافة سجلات جديدة إلى التكرار عند التحرير. الوضع الافتراضي هو صحيح. يمكن تعيينه إلى خطأ باستخدام allowAdds=false.
• allowUpdates—يتيح تحديث السجلات الحالية في التكرار عند التحرير. القيمة الافتراضية خطأ. يمكن تعيينها إلى صحيح باستخدام allowUpdates=true.

يمكن استخدام العديد من أزواج القيمة الرئيسية بعضها مع بعض مفصولة بمسافات، على سبيل المثال، allowUpdates=true query="Editor='BKlauser'". إذا وُجدِت مسافات بين القيم، يمكن وضعها بين علامات اقتباس.

الصور

يتيح Survey123 للمستخدم إضافة صور إلى سجلات الاستطلاع الحالية. عندما يكون تحرير الصور الحالية غير مدعوم، يوفر كل سؤال صورة زر نسخ عند تحرير استطلاع لنسخ صورة حالية يمكن تحريرها بواسطة التدوير أو إعادة التسمية أو التحرير باستخدام المظهرين draw وannotate.

تم تمكين توفير صور جديدة بشكل افتراضي. لتعطيل هذه الوظيفة، اكتب allowAdds=false في العمود bind::esri:parameters.

هناك بعض القيود المعروفة لتحرير الصور:

• مهام سير العمل غير المتصلة غير مدعومة.
• مظهر signature لا يدعم وظيفة التكرار.
• تستخدم مرفقات الصور خصائص الكلمات الأساسية لإقران صورة بالسؤال الذي تم إرساله مقابلها. خصائص الكلمات الأساسية غير مدعومة من ArcGIS Enterprise قبل الإصدار 10.8.1، لذلك لن يتم ربط الصورة التي تم إرسالها إلى استطلاع تم نشره في بوابة ArcGIS Enterprise الإلكترونية قبل الإصدار 10.8.1 بسؤال. وبالمثل، لا يمكن أن تحتوي الصور المرفقة بأحد المعالم من خلال طريقة أخرى غير الاستطلاع (على سبيل المثال، في ArcGIS Pro أو خريطة ArcGIS Online على الويب) على كلمات أساسية.
• عند تنزيل استطلاع موجود على جهاز لاستخدامه من صندوق الوارد، لا يتم تنزيل الصور الموجودة. ستقوم وظيفة count-selected فقط بإحصاء الصور الموجودة على الجهاز وستعيد 0 عند فتح الاستطلاع لأول مرة. سيتم احتساب أي صور جديدة تم التقاطها.