أسئلة الوسائط

يمكنك تضمين أسئلة تتضمن وسائط (ملفات صوتية، وملفات، وصور) في الاستطلاعات، مما يتيح للمستخدمين إرفاق ملفات مع ردودهم.

تلميح:

يمكن أيضًا إضافة الصور والمقاطع الصوتية إلى أسئلة أخرى في الاستطلاع لأغراض مرجعية ولأغراض تصميم. لمزيد من المعلومات، راجع إضافة الوسائط إلى استطلاع.

بشكل افتراضي، تسمح أسئلة الوسائط بإرفاق ملف واحد. للسماح بمرفقات متعددة، حدد مظهرها.

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

الصوت

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

ملاحظة:‏

في التطبيق الميداني Survey123، لا يتم دعم إيقاف التسجيل الصوتي مؤقتاً أثناء التسجيل في Android.

بشكل افتراضي، يقتصر حجم التسجيلات الصوتية على ملف يبلغ 10 ميجابايت بحد أقصى في Survey123 Mobile وفي التطبيق الميداني Survey123 و 10 دقائق في تطبيق الويب Survey123.

يمكنك تعيين حد مختلف للحجم بالميجابايت باستخدام المعلمة max-size في العمود bind::esri:parameters يتوقف التسجيل تلقائيًا عند الوصول إلى الحد الأقصى لحجم الملف. على سبيل المثال، يسمح max-size=5 للمستخدمين بتسجيل مقطع صوتي تصل مساحته إلى 5 ميجابايت.

بدلاً من ذلك، يمكنك تحديد حد الوقت بالثواني باستخدام المعلمة max-duration في العمود bind::esri:parameters. يتوقف التسجيل تلقائيًا عند الوصول إلى الحد الأقصى لمدة المقطع الصوتي. على سبيل المثال، يسمح max-duration=30 للمستخدمين بتسجيل مقطع صوتي تصل مدته إلى 30 ثانية.

تنبيه:

في التطبيق الميداني Survey123، يبلغ الحد الأقصى لحجم الملف لأي مرفق مُرسَل 10 ميجابايت. تأكد من أن القيمة max-duration أو max-size التي تم تعيينها لا تتسبب في أن يتجاوز حجم الملف الصوتي الحد الأقصى لحجم الملف.

يمكنك تحديد برامج الترميز الصوتي المفضلة باستخدام المعلمة codec في العمود bind::esri:parameters. يمكن إدخال برامج ترميز متعددة مفصولة بفواصل، مثل codec=amr-nb,aac. يُستخدم أول برنامج ترميز متوافق مع الجهاز.

ملاحظة:‏

في Survey123 Mobile، يتم ترميز الملفات الصوتية افتراضيًا باستخدام برنامج الترميز AAC (Advanced Audio Coding) إذا كان الجهاز يدعمه. فيما يلي برامج الترميز المدعومة لكل نظام تشغيل:

• Android—AAC،‏ MP3
• iOS—AAC، ‏ALAC،‏ FLAC، ‏MP3، ‏PCM،‏ Vorbis
• Windows—AAC، ‏ALAC، MP3،‏ PCM،‏ Vorbis،‏ WMAudioLossless، ‏WMAudioV8، ‏WMAudioV9

ملاحظة:‏

في التطبيق الميداني Survey123، يلتقط التسجيل ملفًا صوتيًا باستخدام تنسيق التقاط الصوت الافتراضي لجهازك. برامج الترميز المدعومة بواسطة الجهاز مُدرجة في صفحة نبذة عن في التطبيق. اضغط مطولاً على عنوان نبذة عن ArcGIS Survey123 في أعلى صفحة نبذة عن لإظهار معلومات إضافية عن الجهاز، بما في ذلك برامج الترميز الصوتي التي يدعمها. في أجهزة Windows، يتم تسجيل الملفات الصوتية دائمًا بتنسيق WAV غير المضغوط.

قد لا تتمكن من تشغيل بعض ملفات الصوت في مستعرض الويب إذ إن المستعرضات لا تدعم جميع برامج الترميز. لمزيد من المعلومات عن برامج ترميز الصوت على الويب، راجع وثائق شبكة المطورين في Mozilla.

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

ملفات

ملاحظة:‏

يصف هذا القسم وظائف متاحة فقط في Survey123 Connect وفي التطبيق الميداني Survey123. هذه الوظائف غير متاحة في Survey123 Studio أو Survey123 Mobile.

يسمح نوع سؤال الملف للمستخدمين بإرسال مجموعة من أنواع الملفات.

الحد الأقصى لحجم الملف الافتراضي لملف فردي هو 10 ميجابايت. بالنسبة لأسئلة الملف في تطبيق الويب Survey123، يمكنك تحديد الحد الأقصى لحجم الملف بالميجابايت باستخدام max-size في العمود bind::esri:parameters. على سبيل المثال، يتيح max-size=5 للمستخدمين إرفاق ملف بحجم يصل إلى 5 ميجابايت.

ملاحظة:‏

الحد الأقصى لحجم الملف لمرفق فردي تم إرساله من تطبيق Survey123 الميداني هو 10 ميغابايت.

عند التطبيق على أسئلة الملفات، تكون المعلمة max-size مدعومة فقط في تطبيق الويب Survey123. لا يمكن أن يتجاوز الحجم الأقصى 500 ميجابايت لـ ArcGIS Online و20 ميجابايت لـ ArcGIS Enterprise.

يقبل نوع سؤال الملف جميع أنواع مرفقات الملفات التي يدعمها ArcGIS Online و ArcGIS Enterprise. تكون أنواع الملف المدعومة على النحو التالي:

فئة	نوع الملف
أرشيف	7Z و GTAR و GZ و TAR و TGZ و ZIP
الصوت	AIF و M4A و MID و MP2 و MP3 و MPA و RA و RAM و RMI و WAV و WMA
البيانات	CSV و GEODATABASE و GEOJSON و GML و GPKG* و JSON و MDB و PBF* و SD* و VRML و XML
مستند	DOC و DOCX و DOT و PDF و PPT و PPTX و TXT و WPS و XLS و XLSX و XLT
صورة	BMP و ECW و EMF و EPS و GIF و IMG و J2K و JP2 و JPC و JPE و JPEG و JPF و JPG و PNG و PS و PSD و RAW و SID و TIF و TIFF و WMF
مقاطع الفيديو	AVI و MOV و MP4 و MPE و MPEG و MPG و MPV2 و QT و WMV

*هذا النوع من المرفقات غير مدعوم في ArcGIS Enterprise.

يمكنك تقييد أنواع الملفات التي يمكن إرسالها إلى سؤال ملف باستخدام العمود body::accept. يقبل هذا العمود كلا امتدادّي الملفات (على سبيل المثال، .wav) وأنواع MIME (على سبيل المثال، audio/*). يمكن تعيين امتدادات الملفات المتعددة أو أنواع MIME عن طريق فصلها بفاصلات.

للحصول على معلومات حول التنسيقات المقبولة لأنواع MIME، راجع قائمة Mozilla لأنواع MIME الشائعة.

الصور

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

سيتم حفظ صورة ملتقطة في Survey123 في صورة ملف .jpg بمستوى جودة اعتمادًا على كاميرا الجهاز. يمكن تحديد حجم الصورة —مقاساً بالبكسل على طول الحافة الأطول— باستخدام خيارات في Survey123 Studio أو Survey123 Connect. يتم تطبيق هذا الحجم على جميع أسئلة الصور في الاستطلاع. تتوفر الخيارات التالية:

• 320 بكسل
• 640 بكسل
• 1280 بكسل
• 1920 بكسل
• غير مُقيّد (إرفاق أي حجم للصورة بالاستطلاع.)

حجم الصورة الافتراضي هو 1280 بكسل. تحتفظ الصور المُرسَلَة المحفوظة على جهازك بنوع الملف الأصلي ودقته وجودته.

لا تؤثر أحجام الصور هذه في معاينة الصورة المقدمة في Survey123 Mobile أو في التطبيق الميداني Survey123.

الحد الأقصى لحجم الملف الافتراضي لأي صورة فردية هو 10 ميجابايت. بالنسبة لأسئلة الصورة في تطبيق الويب Survey123، يمكنك تحديد الحد الأقصى لحجم الملف بالميجابايت باستخدام max-size في العمود bind::esri:parameters. على سبيل المثال، يتيح max-size=5 للمستخدمين إرفاق صورة بحجم يصل إلى 5 ميجابايت.

ملاحظة:‏

الحد الأقصى لحجم الملف لمرفق فردي تم إرساله من تطبيق Survey123 الميداني هو 10 ميغابايت.

عند التطبيق على أسئلة الصورة، تكون معلمة max-size مدعومة فقط في تطبيق ويب Survey123. لا يمكن أن يتجاوز الحجم الأقصى 100 ميغابايت لـ ArcGIS Online، و 20 ميغابايت لـ ArcGIS Enterprise.

تخصيص حجم الصورة وطريقة الالتقاط

ملاحظة:‏

يصف هذا القسم وظائف متاحة فقط في التطبيق الميداني Survey123. هذه الوظائف غير متاحة في Survey123 Mobile.

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

يمكنك تعيين الحد الأقصى للحجم المسموح به للصورة لكل سؤال صورة فردي في الاستطلاع. حدد max-pixels في عمود المعلمة في XLSForm للسؤال الذي تريد تقييده. على سبيل المثال، يقيس max-pixels=100 الصورة لأسفل بشكل متناسب مع 100 بكسل على الحافة الأطول. إذا لم يتم تحديد المعلمة max-pixels، يتم استخدام حجم الصورة المحدد في Survey123 Connect.

يمكنك قصر سؤال الصورة على طريقة التقاط معينة من خلال تحديد method=camera أو method=browse في عمود body::esri:style الخاص بـ XLSForm. يمكنك أيضًا تعيين المظهر على واجهة أمامية جديدة أو واجهة خلفية جديدة ليقتصر سؤال الصورة فقط على استخدام الصور من كاميرا الجهاز، باستخدام الكاميرا الأمامية أو الكاميرا الخلفية على التوالي كإعداد افتراضي. عند استخدام مظهر التعليق التوضيحي، يمكنك أيضًا تحديد method=map.

المظهر

يمكنك تغيير سلوك الأسئلة وطريقة عرضها من خلال ضبط المظهر. للتحقق من تطبيقات الإرسال التي تدعم مظهراً معيناً، راجع جدول المظاهر.

عند ضبط عمود المظهر على متعدد الأسطر، يقبل سؤال الملف أو الصورة مرفقات متعددة ضمن سؤال واحد.

يمكن دمج هذا المظهر مع مظاهر أخرى عن طريق كتابة كلا المظهرين مع الفصل بينهما بمسافة، مثل multiline annotate في سؤال الصورة.

يمكنك التحكم في عدد الملفات أو الصور التي يمكن إرسالها باستخدام الدالة count-selected الموجودة في عمود القيد. فيما يلي أمثلة على ذلك:

• count-selected(${file_question}) <= 5 سيقيد عدد الملفات التي يمكن إرسالها بحد أقصى خمسة.
• count-selected(${image_question}) <= 3 سيقيد عدد الصور التي يمكن تقديمها بحد أقصى ثلاث صور.

عند ضبط المظهر على توقيع، يمكن استخدام سؤال من نوع صورة لالتقاط توقيع بخط اليد.

ملاحظة:‏

في Survey123 Connect، يمكنك أيضاً تحديد خيارات المظهر التالية لأسئلة الصور في الاستطلاعات المستخدمة مع التطبيق الميداني Survey123:

• من خلال ضبط خيار المظهر على واجهة أمامية جديدة أو واجهة خلفية جديدة، يمكنك قصر استخدام الكاميرا في الأسئلة التي تتضمن صوراً على الكاميرا الأمامية أو الخلفية للجهاز -حسب الحالة- باعتبارها الخيار الافتراضي. يمكن دمج هذه المظاهر مع التعليق التوضيحي عن طريق تعيين كلا المظهرين مفصولين بمسافة، مثل new-front annotate.
• من خلال ضبط المظهر على خيار الرسم أو إضافة التعليقات التوضيحية، يمكنك السماح للمستخدمين بالرسم على الصور أو إضافة تعليقات توضيحية عليها.
• عند ضبط المظهر على spike، يعرض سؤال الصورة زراً لفتح تطبيق الجوال Spike من أجلضم Survey123 مع Spike. لمزيد من المعلومات، راجع Spikeمظاهر الصور.

مظهر التوقيع

من خلال تعيين قيمة المظهر على التوقيع، يعرض سؤال الصورة نافذة منبثقة لالتقاط توقيع.

يتم حفظ التوقيع في شكل مرفق صورة .jpg بأبعاد النافذة المنبثقة نفسها. افتراضيًا، يمتد عرض النافذة المنبثقة إلى عرض شاشة الجهاز بارتفاع ثابت يبلغ 200 بكسل. لضبط الحد الأقصى لعرض هذه النافذة المنبثقة باستخدام المعلمة max-pixels، راجع تخصيص حجم الصورة وطريقة الالتقاط.

يمكنك أيضًا إدخال صورة في العمود الافتراضي لتعيين خلفية مخصصة للتوقيع. تحدد أبعاد الصورة الافتراضية نسبة العرض إلى الارتفاع للنافذة المنبثقة.

سيكون عرض النافذة المنبثقة أصغر مما يلي:

• قيمة max-pixels
• عرض الصورة الافتراضية
• عرض شاشة الجهاز

سيبلغ الارتفاع 200 بكسل، ما لم يتم إدخال صورة افتراضية.

عند تصميم استطلاع باستخدام مظهر التوقيع، احرص على مراعاة حجم الشاشة لجميع الأجهزة الهدف.

يمكن توفير نص التذييل للنافذة المنبثقة لسؤال التوقيع باستخدام المعلمة footerText في عمود body::esri:style. باستخدام معلمة footerText فقط بدون قيمة، سيظهر التلميح الإرشادي للسؤال أسفل التوقيع. يمكن تغيير هذا إلى تلميح السؤال باستخدام footerText=@[hint]. لن يظهر التلميح أو التلميح الإرشادي المستخدم لنص التذييل في الموقع الافتراضي أسفل اسم السؤال. لمزيد من المعلومات حول التلميحات، راجع التلميحات.

ملاحظة:‏

لا يدعم تطبيق الويب Survey123 متعدد الأسطر أو معلمة max-pixels أو إعدادات افتراضية عند تطبيقه على مظهر التوقيع.

مظهر الرسم وإضافة تعليق توضيحي

ملاحظة:‏

يصف هذا القسم وظائف متاحة فقط في Survey123 Connect وفي التطبيق الميداني Survey123. هذه الوظائف غير متاحة في Survey123 Studio أو Survey123 Mobile.

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

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

تلميح:

بدءاً من Survey123 الإصدار 3.13 وما بعده، يتم نسخ بيانات EXIF ​​من الصورة المصدر إلى الصورة المُضاف إليها تعليقات توضيحية.

أو يمكنك السماح للمستخدم بإضافة تعليق توضيحي إلى صورة حالية من وحدة تخزين الجهاز، أو لقطة لخريطة. للقيام بذلك، قم بتعيين body::esri:style لهذا السؤال على method=browse أو method=camera أو method=map. السلوك الافتراضي لمظهر التعليق التوضيحي مماثل لتقديم method=camera. يمكنك تعيين السؤال لتوفير عدد من الخيارات للصورة المصدر من خلال توفير خيارات متعددة مفصولة بفواصل، على سبيل المثال، method=camera,browse.

تنبيه:

بغض النظر عن الطريقة التي تم تعيينها، يعرض تطبيق الويب Survey123 فقط خيار الاستعراض بحثًا عن الملف.

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

ملاحظة:‏

يمكنك ضبط دقة الصورة عن طريق تحديد قيمة max-pixels في عمود المعلمات. بالنسبة إلى سؤال الرسم، سيؤدي تعيين max-pixels=1000 إلى تعيين اللوحة على صورة مربعة بحجم 1000 x‏ 1000 بكسل. بالنسبة إلى سؤال التعليق التوضيحي، سيعمل تعيين max-pixels=1000 على تعيين أطول جانب من الصورة على 1000 بكسل، مع الحفاظ على نسبة العرض إلى الارتفاع للصورة المقدمة. إذا لم يتم تعيين max-pixels، فسيتم تحديد حجم الصورة بدلاً من ذلك من خلال إعداد حجم الصورة في إعدادات الخيارات لاستطلاعك في Survey123 Connect.

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

مظهر الصور Spike

ملاحظة:‏

يصف هذا القسم وظائف متاحة فقط في Survey123 Connect وفي التطبيق الميداني Survey123. هذه الوظائف غير متاحة في Survey123 Studio أو Survey123 Mobile.

ملاحظة:‏

تكامل Spike غير مدعوم في تطبيق الويب Survey123.

تدعم أسئلة الصور أيضًا المظاهر من أجل تكامُل Survey123 مع Spike، والذي يُمثل حل قياس باستخدام الليزر تم تطويره بواسطة ikeGPS، وهو ما يتيح لك التقاط قياسات وموقع الكائن من صورة. بتعيين المظهر على spike، أو قياس spike الكامل، أو spike نقطة إلى نقطة، يعرض سؤال صورة زرًا لفتح تطبيق Spike على الجوال على الأجهزة التي تعمل بنظامي التشغيل iOS و Android.

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

يتمثل الاختلاف بين مظاهر Spike في مدى القيم المخزنة في الصورة. لا يقيس مظهر spike إلا المسافة والموقع، في حين يقيس مظهر قياس spike الكامل المسافة والموقع والمنطقة والطول. يلتقط المظهر Spike نقطة إلى نقطة سلسلة من القيم الحصرية التي تدل عليها أسماء الخصائص التي تبدأ بـ P2P.

لمزيد من المعلومات عن علامات EXIF، راجع تكامل Spike . لمزيد من المعلومات عن Spike، راجع موقع Spike الإلكتروني.

استخراج بيانات تعريف الصور

يمكنك استخدام خاصية pulldata("@exif") لاستخراج علامات بيانات تعريف ملف صور قابل للتغيير (EXIF) من الرد على سؤال خاص بصورة. عند إدخال هذا المثال إلى سؤال عشري، يتم استخراج قيمة خط العرض الخاص بالجهاز من الصورة:

pulldata("@exif", ${image}, "GpsLatitude")

تُدرج في الجدول التالي وسوم EXIF ​​الشائعة المتعلقة بالموقع، والتي يمكنك استخدامها مع هذه الدالة pulldata("@exif"):

علامة EXIF	الوصف
GpsLatitude	خط عرض موقع الجهاز كسلسلة
GpsLongitude	خط طول موقع الجهاز كسلسلة
GpsAltitude	ارتفاع موقع الجهاز كسلسلة
GpsLatitudeRef	إسناد دائرة العرض (وذلك يعني الشمال، الشرق، الجنوب، الغرب) لموقع الجهاز كسلسلة
GpsLongitudeRef	إسناد خط الطول (وذلك يعني الشمال، الشرق، الجنوب، الغرب) لموقع الجهاز كسلسلة
GpsDestDistance	المسافة بين موقع الجهاز والموقع الوجهة بالكلومتر، كعدد صحيح
GpsImgDirection	الاتجاه إلى الموقع الوجهة من موقع الجهاز كسلسلة
GpsDestLatitude	دائرة عرض الموقع الوجهة كسلسلة
GpsDestLongitude	خط طول الموقع الوجهة كسلسلة
GpsDestLatitudeRef	إسناد دائرة العرض (وذلك يعني الشمال، الشرق، الجنوب، الغرب) لموقع الوجهة كسلسلة
GpsDestLongitudeRef	إسناد خط الطول (وذلك يعني الشمال، الشرق، الجنوب، الغرب) لموقع الوجهة كسلسلة

يمكنك استخدام المثال التالي لعرض كل من قيمة خط الطول ودائرة العرض في حقل فردي، والذي يمكنك استخدامه لملء سؤال نقطة جغرافية.

string(pulldata("@exif", ${image}, "GpsLatitude")) + " " + string(pulldata("@exif", ${image}, "GpsLongitude"))

علامات EXIF للصور الأخرى التي يمكن استخراجها بواسطة Survey123 مذكورة أدناه. بناءً على الأجهزة المستخدمة، لن تكون كل هذه العلامات متاحة.

علامة EXIF
GpsAltitudeRef	GpsTimeStamp	GpsSatellites
GpsStatus	GpsMeasureMode	GpsDop
GpsSpeedRef	GpsSpeed	GpsTrackRef
GpsTrack	GpsImgDirectionRef	GpsMapDatum
GpsDestBearingRef	GpsDestBearing	GpsDestDistanceRef
GpsProcessingMethod	GpsAreaInformation	GpsDateStamp
GpsVersionId	GpsDifferential	GpsHPositioningError
عرض الصورة	ImageLength	ImageBitsPerSample
ImageCompression	ImagePhotometricInterpretation	ImageDescription
ImageMake	ImageModel	ImageStripOffsets
ImageOrientation	ImageSamplesPerPixel	ImageRowsPerStrip
ImageStripByteCounts	ImageXResolution	ImageYResolution
ImagePlanarConfiguration	ImageResolutionUnit	ImageTransferFunction
ImageSoftware	ImageDateTime	ImageArtist
ImageWhitePoint	ImagePrimaryChromaticities	ImageYCbCrCoefficients
ImageYCbCrSubSampling	ImageYCbCrPosition	ImageReferenceBlackWhite
ImageRating	ImageRatingPercent	ImageCopyright
ImageXPTitle	ImageXPComment	ImageXPAuthor
ImageXPKeywords	ImageXPSubject	ImageLensSpecification
ImageLensModel	ImageLensMake	ImageLensSerialNumber
ExtendedSubjectDistanceRange	ExtendedExposureTime	ExtendedFNumber
ExtendedExposureProgram	ExtendedSpectralSensitivity	ExtendedISOSpeedRatings
ExtendedOecf	ExtendedExifVersion	ExtendedDateTimeOriginal
ExtendedDateTimeDigitized	ExtendedComponentsConfiguration	ExtendedCompressedBitsPerPixel
ExtendedShutterSpeedValue	ExtendedApertureValue	ExtendedBrightnessValue
ExtendedExposureBiasValue	ExtendedMaxApertureValue	ExtendedSubjectDistance
ExtendedMeteringMode	ExtendedLightSource	ExtendedFlash
ExtendedFocalLength	ExtendedSubjectArea	ExtendedMakerNote
ExtendedUserComment	ExtendedSubSecTime	ExtendedSubSecTimeOriginal
ExtendedSubSecTimeDigitized	ExtendedFlashPixVersion	ExtendedColorSpace
ExtendedPixelXDimension	ExtendedPixelYDimension	ExtendedRelatedSoundFile
ExtendedFlashEnergy	ExtendedSpatialFrequencyResponse	ExtendedFocalPlaneXResolution
ExtendedFocalPlaneYResolution	ExtendedFocalPlaneResolutionUnit	ExtendedSubjectLocation
ExtendedExposureIndex	ExtendedSensingMethod	ExtendedFileSource
ExtendedSceneType	ExtendedCfaPattern	ExtendedCustomRendered
ExtendedExposureMode	ExtendedWhiteBalance	ExtendedDigitalZoomRatio
ExtendedFocalLengthIn35mmFilm	ExtendedSceneCaptureType	ExtendedGainControl
ExtendedContrast	ExtendedSaturation	ExtendedSharpness
ExtendedDeviceSettingDescription	ExtendedImageUniqueId

للاطلاع على علامات التبويب هذه بالتفصيل، راجع نموذج EXIF في Survey123 Connect.

تنبيه:

إذا كان هناك سؤال صورة يحتوي على صور متعددة، فلا يمكن استخراج بيانات EXIF من الصور باستخدام دالة pulldata("@exif"). لاستخراج بيانات EXIF من الصور المتعددة المرسلة للسؤال نفسه، ففكر في استخدام التكرار.

تكامل Spike

ملاحظة:‏

يصف هذا القسم وظيفةً متاحةً فقط في Survey123 Connect. هذه الوظيفة غير متاحة في Survey123 Studio.

تدعم أسئلة الصور أيضًا التكامل مع حل Spike للقياس بواسطة الليزر، والذي تم تطويره بواسطة ikeGPS، وهو ما يتيح لك التقاط قياسات كائن من صورة وموقعه. للحصول على معلومات حول كيفية استخدام Spike مع Survey123، راجع مظهر صور Spike.

يُسجل Spike عددًا من العلامات المخصصة الإضافية بواسطة كتابة كائن JSON في علامة ImageDescription EXIF التي تحتوي على خصائص غير قياسية متعلقة بجهاز Spike والقياسات التي سجلها. يوضح الجدول التالي العلامات:

علامة Spike	الوصف
device_id	معرف جهاز Spike كسلسلة
local_accuracy	دقة جهاز Spike ككسر عشري
destination_altitude	ارتفاع موقع الوجهة كعدد منطقي
declination	رفض جهاز Spike كعدد منطقي
pitch	مقياس خطوط جهاز Spike كعدد منطقي
rotation	استدارة جهاز Spike كسلسلة
objects	صفيف JSON للكائنات المقاسة (المنطقة والأطوال) كسلسلة
P2P.capture_id	معرف صورتي المعالجة من نقطة إلى نقطة كسلسلة
P2P.horizontal_distance	المسافة الأفقية بين النقطتين بالأمتار
P2P.distance	المسافة بين النقطتين بالأمتار
P2P.gradient	الانحدار بين النقطتين بالدرجات
P2P.vertical_distance	المسافة الرأسية بين النقطتين بالأمتار
P2P.azimuth	زاوية السمت للنقطتين بالدرجات

للوصول إلى علامات التبويب Spike هذه، استخرج أولاً كائن JSON الذي تم تخزينه في EXIF باستخدام pulldata("@exif") في خاصية objects كما يلي:

pulldata("@exif", ${image}, "objects")

بمجرد وجود كائن JSON هذا في حقل آخر، يمكنك استخدام مسار اسم كائن Spike. في دالة pulldata("@json") لاستخراج قيمة محددة من صفيف JSON. لمزيد من المعلومات بشأن دالة pulldata("@json")، راجع موضوع استرداد قيمة من JSON. يستخرج المثال التالي مقياس خطوط جهاز Spike من السؤال الذي يضم المصفوفة:

pulldata("@json", ${spikedata}, "Spike.pitch")

تحتوي مصفوفة objects أيضًا على المناطق والأطوال الملتقطة بواسطة جهاز Spike. يحتوي هذا الصفيف على الكائنات المُقاسَة في الصورة، بما في ذلك الأشكال والخطوط، وكذلك شكل المحاذاة المستخدم لتحويل الصورة. يمكن استخراج الكائنات في الصفيف بواسطة الإشارة إلى موضعها في الصفيف، وهو أمر يتوافق مع الأمر الذي تم التقاطها به. يرجع المثال التالي المنطقة الأولى أو الخط الأول في المصفوفة:

pulldata("@json", ${spikedata}, "Spike.objects[1].type")

ملاحظة:‏

يحتوي دائمًا الموضع 0 في المصفوفة على شكل المحاذاة.

لإرجاع كمية الكائنات المعروضة في الصفيف، استخدم خاصية length كما يلي:

pulldata("@json", ${spikedata}, "Spike.objects.length")

لرؤية أمثلة على هذه العلامات قيد الاستخدام، راجع نموذج استطلاع Spike في Survey123 Connect. لمزيد من المعلومات عن Spike، قم بزيارة صفحة منتجات ikeGPS.

الكلمات الأساسية

يستخدم Survey123 الكلمات الأساسية للمرفقات لربط المرفقات بأسئلة معينة في الاستطلاع. عند إنشاء صورة أو صوت أو سؤال ملف في استطلاع ونشره، يتم استخدام اسم السؤال ككلمة أساسية في جدول المرفقات. على سبيل المثال ، إذا كان الاستطلاع يحتوي على أسئلة صورة تسمى image_closeup و image_wideview، فإن القيمة المخزنة في عمود KEYWORDS من جدول المرفقات ستكون إما image_closeup أو image_wideview لكل صورة. يطابق Survey123 تلقائيًا الكلمة الأساسية المرفقة مع اسم السؤال لربط المرفقات بالأسئلة.

يكون الغرض من اقتران الكلمات الأساسية أكثر وضوحًا عند طباعة التقارير، وسيضمن Survey123 طباعة الصورة الصحيحة كرد على السؤال الصحيح في الاستطلاع. يُستخدم اقتران الكلمات الأساسية أيضًا للسماح بتحرير الصور في البريد الوارد.

إذا قمت بتغيير اسم سؤال صورة وأعدت نشر الاستطلاع، يجب عليك أيضًا تغيير الكلمة الأساسية لأي سجلات مرفقات موجودة.

تنبيه:

عند تصدير بيانات Survey123، لن يتم الاحتفاظ بعمود KEYWORDS في جدول المرفقات.

إذا تمت إعادة نشر هذه البيانات كخدمة معالم مستضافة، فيكون لديك سؤال صورة واحد، وتم استخدام أسماء ملفات افتراضية للمرفقات، يمكنك استخدام دفتر ملاحظات تحديث الكلمات الأساسية للمرفقات Python لإعادة ملء عمود KEYWORDS. إذا كان لديك أكثر من سؤال صورة واحد في الاستطلاع الخاص بك، فلا يمكنك استخدام دفتر الملاحظات ويجب عليك يدويًا تحديد الملف المرتبط بأي سؤال وإدخال اسم السؤال في عمود KEYWORDS لكل سجل مرفق. لمزيد من المعلومات، راجع مقالة الدعم الفني هذه.

إذا تم إعادة نشر البيانات كخدمة معالم ArcGIS Server، فيجب عليك أولاً إضافة عمود KEYWORDS إلى جدول المرفقات. يمكنك استخدام أداة ترقية المرفقات لإضافة هذا العمود. إذا كان لديك سؤال صورة واحد، وتم استخدام أسماء ملفات افتراضية للمرفقات، يمكنك استخدام دفتر ملاحظات تحديث الكلمات الأساسية للمرفقات Python لإعادة ملء عمود KEYWORDS. إذا كان لديك أكثر من سؤال صورة واحد في الاستطلاع الخاص بك، فلا يمكنك استخدام دفتر الملاحظات ويجب عليك يدويًا تحديد الملف المرتبط بأي سؤال وإدخال اسم السؤال في عمود KEYWORDS لكل سجل مرفق. لمزيد من المعلومات، راجع مقالة الدعم الفني هذه.

في أي من البيئتين، عند عرض هذه السجلات في المرة التالية في Survey123، ستتطابق قيمة الكلمة الأساسية في جدول المرفق مع اسم السؤال، وسيتم إجراء الاقتران تلقائيًا.

تخصيص أسماء الملفات

ملاحظة:‏

يصف هذا القسم وظائف متاحة فقط في Survey123 Connect وفي التطبيق الميداني Survey123. هذه الوظائف غير متاحة في Survey123 Studio أو Survey123 Mobile.

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

تنبيه:

في تطبيق الويب، يتم دعم أسماء الملفات المخصصة لأسئلة الصور والصوت والملفات. في التطبيق الميداني، يتم دعم أسماء الملفات المخصصة لأسئلة الصور فقط.

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

يمكنك استخدام المعلمة fileName في عمود bind::esri:parameters لتعيين اسم الملف ديناميكيًا للملف المراد إنشاؤه. في المثال التالي، يتم إنشاء اسم ملف صورة مشابه لـ ASSET406-20221018145109.jpg من سؤال asset_id والتاريخ والوقت الحاليين:

للاطلاع على أمثلة على بناء الجملة، راجع عينة الصور والتعليق التوضيحي في Survey123 Connect.

يجب التزام أسماء الملفات بما يلي:

• يجب أن تكون أسماء الملفات فريدة لجميع الأسئلة في جميع الاستطلاعات على الجهاز. يخزن مجلد مرفقات الاستطلاع الخاص بي جميع الصور الخاصة بجميع الاستطلاعات على الجهاز، وبالتالي لا يمكن تضمين أسماء ملفات مكررة. للتأكد من أن أسماء الملفات الفريدة، ضع في اعتبارك استخدام خاصية مثل now() في التعبير fileName.
• يجب ألا يزيد طول أسماء الملفات على 140 حرفًا.
• يجب ألا تحتوي أسماء الملفات على مسافات أو الرموز الخاصة التالية: \ / : * ? < > ; | . , ". ستُستبدل المسافات والرموز الخاصة بشرطة سفلية.

تنبيه:

في تطبيق الويب، إذا نتج من تعبير المعلمة fileName، أو التحرير اليدوي لاسم الملف تكرار، فسيتم إلحاق رقم إضافي باسم الملف الجديد.

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

يمكن تطبيق المعلمات التالية في العمود body::esri:style الخاص بسؤال للتحكم بشكل أكبر في أسماء ملفات الصور:

• fileNameVisible—يحدد ما إذا كان اسم الملف سيصبح مرئيًا في الاستطلاع. الوضع الافتراضي هو true. لإخفاء اسم الملف، اكتب fileNameVisible=false.
• allowRename—يحدد ما إذا كان يُسمح للمستخدمين بتحرير اسم الملف يدويًا. الوضع الافتراضي هو true. يتعذر على المستخدمين تحرير اسم الملف في حالة fileNameVisible=false، حتى في حالة allowRename=true.