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

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

تلميح:

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

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

الصور

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

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

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

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

لا تؤثر أحجام الصور هذه في معاينة الصورة المقدمة في تطبيق 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.

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

ملاحظة:‏

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

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

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

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

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

يمكنك استخدام خاصية 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 مذكورة أدناه. بناءً على الأجهزة المستخدمة، لن تكون كل هذه العلامات متاحة.

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

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

يُسجل 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. يلتقط التسجيل ملفًا صوتيًا باستخدام تنسيق التقاط الصوت الافتراضي لجهازك. يشير شريط التقدم إلى مقدار الوقت المتبقي للتسجيل. يمكن للمستخدمين إيقاف التسجيل مؤقتًا أو إيقافه في أي وقت. بمجرد اكتمال التسجيل، يمكنك تحرير اسم الملف عن طريق تحديده.

ملاحظة:‏

خاصية إيقاف الصوت مؤقتًا في أثناء تسجيله في التطبيق الميداني غير مدعومة في Android.

إمكانية تحميل ملف صوتي حالي غير مدعومة في التطبيق الميداني.

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

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

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

تنبيه:

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

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

ملاحظة:‏

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

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

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

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

ملفات

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

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

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

يستخدم 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 تلقائيًا اسم ملف للصور والصوت والملفات المرسلة في سؤال. يحتوي اسم الملف على اسم السؤال كبادئة متبوعة برقم فريد. يمكنك تخصيص أسماء الملفات لجعلها أكثر وضوحًا. على سبيل المثال، يمكنك إدخال الاسم الأول والأخير للموقِّع في اسم الملف الخاص بالتوقيع. بالنسبة للصور، يمكنك تضمين التاريخ أو واصف الكائن الذي تقوم بتصويره.

تنبيه:

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

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

يمكنك استخدام المعلمة 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.