تعبيرات الصورة والمرفقات الأخرى

تتوفر أمثلة على تعبيرات التقرير لأسئلة الصور والمرفقات أدناه.

للحصول على أسئلة الصور، يمكن تعيين الأحجام للتأكد أن تقاريرك تتضمن صورًا ذات حجم ثابت. يكون تنسيق تلك التعبيرات كما يلي:

${image1 | size:width:height:max_width:max_height}

تتحكم قيم العرض والارتفاع في تعيين حجم الصورة، والتي يتم قياسها بالبكسل. بينما تكون هذه القيم لازمة للتعبير، فإن توفير قيمة 0 لا يضع أي قيود على أبعاد تلك الصور. على سبيل المثال، سيجعل التعبير التالي عرض الصورة 300 بكسل، مع الحفاظ على نسبة العرض إلى الارتفاع للصورة:

${image1 | size:300:0}

يقتصر الحد الأقصى لقيم الارتفاع والعرض على الحد الأقصى لحجم الصورة وتكون قيم اختيارية. يجعل المثال التالي عرض الصورة 300 بكسل، ويُقيّد ارتفاع الصورة على 200 بكسل بحد أقصى:

${image1 | size:300:0:0:200}

يستخدم المثال التالي طريقة rotate لتحديد دوران الصورة في اتجاه عقارب الساعة. يقبل قيم من 0 إلى 360.

${image1 | size:300:0:0:200 | rotate:90}

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

${image1 | getValue:"name"}

${image1 | getValue:"size"}

${image1 | getValue:"width"}

${image1 | getValue:"height"}

يمكن استخدام نفس الطريقة لعرض بيانات EXIF من الصورة، وهو ما يعرض تفاصيل مكان التقاط الصورة ووقتها كما يلي:

${image1 | getValue:"x"}

${image1 | getValue:"y"}

${image1 | getValue:"date"}

${image1 | getValue:"time"}

${image1 | getValue:"direction"}

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

${image1} أو ${image1 | getValue:""}

يعرض المثال التالي الصورة الأصلية بجودة فائقة ولكن بحجم معين، استخدم التعبيرين getValue وsize معًا:

${image1 | getValue:"" | size:300:0}

ملاحظة:‏

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

يتم تخزين التواريخ والأوقات كسلاسل في بيانات EXIF، لذلك لا يمكن تنسيق هذه القيم في تقرير باستخدام تعبير format لأسئلة التاريخ والوقت. إذا كان تنسيق هذه القيم مهمًا، فيمكنك استخراج EXIF كجزء من الاستطلاع باستخدام دالة pulldata("@exif"). لمزيد من المعلومات، راجع الصور.

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

${file1 | getValue:"name"}

${file1 | getValue:"size"}

${file1 | getValue:"globalId"}

${file1 | getValue:"id"}

${file1 | getValue:"contentType"}

${file1 | getValue:"keywords"}

لعرض صورة من الإنترنت، قم بتوفير عنوان URL المصدر الخاص بها بالإضافة إلى تعبير src عند الإشارة إلى الكلمة الأساسية $image بدلاً من اسم السؤال:

${$image |
src:"https://upload.wikimedia.org/wikipedia/commons/1/13/Esri_Headquarters%2C_Building_Q.jpg"
| size:400:0}

لإرجاع عدة صورة مرسلة إلى السؤال نفسه في رد، استخدم العناصر النائبة التالية مع وضع كل منها في سطر مخصص:

${#image1}
${$file}
${/}

يمكن استخدام الكلمة الأساسية $attachment لتكرار جميع المرفقات الخاصة بالمعلم الحالي:

${#attachment}
${$file}
${/}

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

${#$attachment}
${$file|getValue:"name"}
${/}

لعرض مرفقات معينة، قم بتضمين طريقة attachmentsDefExp لتحديد المرفق:

${#image1 | attachmentsDefExp:"DATA_SIZE > "+1*1024*1024}...${$file}...${/}

${#$attachment | attachmentsDefExp:"Keywords = 'image1'"}...${$file}...${/}

${#$attachment | attachmentsDefExp:"CONTENT_TYPE like '%image%'"}...${$file}...${/}

ملاحظة:‏

تعمل طريقة attachmentsDefExp بالصورة نفسها التي تعمل بها خاصية مرفقات الاستعلام attachmentsDefinitionExpression. راجع كائن attachmentProperties في طبقة JSON لرؤية الحقول التي يمكن استخدامها في الاستعلام عن المرفقات.