قوالب التقرير

تتيح لك وظيفة تقارير موقع الويب Survey123 تصميم القوالب المخصصة الخاصة بك وإنتاج تقارير متعددة في وقت واحد.

يمكن أن يحتوي التقرير على ما يلي:

• قسم ملخص
• سجل استطلاع فردي
• سجل استطلاع فردي وقسم ملخص
• سجلات الاستطلاعات المتعددة
• سجلات الاستطلاعات المتعددة وقسم الملخص

ملاحظة:‏

تُعد طباعة التقارير خدمة ArcGIS Online متميزة، وتستهلك اعتمادات. لمزيد من المعلومات، راجع طباعة التقارير.

لا تستهلك طباعة التقارير في ArcGIS Enterprise اعتمادات ولكن تكون لها قيود.

قالب التقرير هو ملف Microsoft Word (.docx) يوفر نص عنصر نائب ببناء جملة محدد. عند طباعة تقرير، يتم استبدال هذا النص للعنصر النائب بمحتويات الحقول المقابلة من استجابة الاستطلاع. يمكن استخدام هذا النص للعنصر النائب مع أي تنسيق أو جداول أو صور أو غيرها من إضفاء طابع شخصي لإنشاء قالب خاص باحتياجاتك.

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

ملاحظة:‏

لا يمكن تحميل قوالب التقارير إلا بواسطة مالك الاستطلاع ومسؤولي المؤسسة.

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

التعبيرات

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

${firstname}

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

${questionname | method:parameter}

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

سيعرض التعبير التالي حساب سؤال رقم يسمى floweringtrees مقسومًا على سؤال رقمي يسمى totaltrees. عند الإشارة إلى أسئلة متعددة في التعبير نفسه، لا تحتاج أسماء الأسئلة الفردية إلا إلى تسميتها مباشرة ولا تحتاج إلى أقواس متعرجة إضافية.

${floweringtrees / totaltrees}

سيعرض التعبير التالي قيمة الإحداثي السيني من سؤال الموقع، حيث تكون getValue هي الطريقة وس هي المعلمة.

${location | getValue:"x"}

يمكن ربط السلاسل في تعبير بربطها بعلامة الجمع. يستخدم هذا التعبير هذا التسلسل لتمرير محتويات سؤال يسمى field_0 إلى خدمة إنشاء رموز الاستجابة السريعة، وإنشاء رمز استجابة سريعة لإجابة السؤال.

${$image | src:"https://barcode.tec-it.com/barcode.ashx?code=QRCode&data="+field_0}

لا تدعم جميع أنواع الأسئلة التعبيرات والطرق. يسرد الجدول التالي الطرق والمعلمات التي يمكنك استخدامها مع أنواع الأسئلة.

الطريقة	المعلمات	نوع سؤال Connect	نوع سؤال مصمم الويب	الوصف
getValue	-	جميع أنواع الأسئلة	جميع أنواع الأسئلة	يسترجع قيمة البيانات الأولية من طبقة المعالم، أو صورة أولية من مرفق.
getValue	س، ص، ع، wkid	نقطة جغرافية	خريطة	يرجع إحداثيات س و ص و ع بشكل فردي في إسناد مكاني محدد. معلمة wkid اختيارية، وستكون هي نفسها الإسناد المكاني لطبقة المعالم إذا تم حذفها.
getValue	الطول والمساحة والوحدة ونوع القياس	التتبع الجغرافي والشكل الجغرافي	خريطة	يرجع طول خط متعدد أو محيط أو مساحة مضلع، في وحدات معينة وما إذا كانت القياسات مستوية أو جيوديسية. نوع القياس الافتراضي هو قياس جيوديسي.
getValue	الاسم والحجم	صورة، ملف صوتي، ملف	صورة، توقيع، ملف صوتي، ملف	يرجع اسم الملف أو حجم المرفق.
getValue	العرض، الارتفاع، س، ص، التاريخ، الوقت، الاتجاه	صورة	صورة، توقيع	يُرجع العرض والارتفاع قيمة العدد الصحيح لعرض الصورة وارتفاعها بالبكسل، وقيم إرجاع س، وص، والتاريخ، والوقت، والاتجاه المقروءة من الصورة EXIF إذا كانت موجودة.
getValue	count	بدء التكرار، صورة، ملف صوتي، ملف	تكرار، صورة، توقيع، ملف صوتي، ملف	يرجع العدد الإجمالي للتكرارات أو المرفقات.
getValue	المدة	ملف صوتي، ملف	ملف صوتي، ملف	إرجاع طول التسجيلات الصوتية في ثوانٍ. تنبيه: لن يتم إرجاع المدة في الاستجابات المجمعة في تطبيق الويب عند استخدام Safari.
المظهر	متعدد السطور	النص	نص متعدد السطور	تستخدم للاحتفاظ بفواصل الأسطر في السلسلة. إذا لم يتم تحديد أي مظهر، فتُرجع الإجابة سلسلة سطر واحد.
المظهر	نقاط	select_multiple	اختيار متعدد	يرجع الإجابة بتنسيق نقطي.
محدد	قيمة الاختيار	select_one وselect_multiple	اختيار متعدد، اختيار واحد، شبكة اختيار واحد، قائمة منسدلة، مقياس Likert، تصنيف	يرجع خانة اختيار تم التأشير عليها إذا كانت قيمة الحقل تساوي ChoiceValue، وإلا، يتم إرجاع خانة اختيار لم يتم التأشير عليها.
محدد	قيمة الاختيار	select_one وselect_multiple	اختيار متعدد، اختيار واحد، شبكة اختيار واحد، قائمة منسدلة، مقياس Likert، تصنيف	إذا كان مجال القيمة المكودة موجودًا، يتم إرجاع صحيح إذا كانت قيمة الحقل تساوي قيمة الاختيار، وإلا يتم إرجاع خطأ.
countSelected	-	select_one وselect_multiple	اختيار متعدد، اختيار واحد، شبكة اختيار واحد، قائمة منسدلة، مقياس Likert، تصنيف	يرجع عدد الخيارات المحددة.
selectedAt	فهرس	select_one وselect_multiple	اختيار متعدد، اختيار واحد، شبكة اختيار واحد، قائمة منسدلة، مقياس Likert، تصنيف	يرجع السلسلة في موضع الفهرس في قائمة الاختيار. يبدأ الفهرس من الصفر.
محلي	كود اللغة	التاريخ، التاريخ والوقت، البداية، النهاية، عشري	التاريخ، التاريخ والوقت، الرقم	يرجع التاريخ والوقت والرقم المعربة.
تنسيق	تنسيق السلسلة	التاريخ، التاريخ والوقت، العدد الصحيح، عدد عشري، البداية، النهاية	التاريخ، التاريخ والوقت	يرجع سلسلة تاريخ منسقة.
utcOffset	قيمة الإزاحة	التاريخ، التاريخ والوقت، البداية، النهاية	التاريخ، التاريخ والوقت	تُرجع قيمة التاريخ أو التاريخ والوقت التي تمت إزاحتها بواسطة قيمة الإزاحة بالتوقيت العالمي المنسق.
mapSettings	معرف عنصر خريطة الويب، مقياس الخريطة	النقطة الجغرافية والتتبع الجغرافي والشكل الجغرافي	خريطة	لتحديد خريطة الأساس ومقياس الرسم عند طباعة صورة الخريطة. قديم: الاستبدال بخريطة ونطاق خريطة.
نطاق الخريطة	xmin، ymin، xmax، ymax، wkid	النقطة الجغرافية والتتبع الجغرافي والشكل الجغرافي	خريطة	تحديد نطاق الخريطة الثابت عند طباعة صورة الخريطة. تُعد المعلمة wkid اختيارية، وسيتم تعيينها على 4326 (WGS 1984) في حال حذفها.
الخريطة	معرّف عنصر خريطة الويب	النقطة الجغرافية والتتبع الجغرافي والشكل الجغرافي	خريطة	تحديد خريطة الأساس عند طباعة صورة الخريطة.
mapScale	مقياس الخريطة	النقطة الجغرافية والتتبع الجغرافي والشكل الجغرافي	خريطة	تحديد مقياس الخريطة الأساس عند طباعة صورة الخريطة.
استدارة	درجات	النقطة الجغرافية والتتبع الجغرافي والشكل الجغرافي والصورة	الخريطة والصورة	تحديد زاوية دوران الخريطة أو الصورة.
معلومات الرسم	الطبقة الحالية، عنوان URL لطبقة المعالم	النقطة الجغرافية والتتبع الجغرافي والشكل الجغرافي	خريطة	لتحديد معلومات الرسم عند طباعة صورة الخريطة، بما في ذلك الرمز والتسمية والشفافية.
src	عنوان URL للصورة	-	-	لتحديد عنوان URL للمصدر لعنصر صورة ديناميكي.
الحجم	العرض، الارتفاع، أقصى عرض، أقصى ارتفاع	صورة	صورة	لتحديد حجم الصورة المطبوعة.
دائري	حفظ الأماكن	عدد عشري، نقطة جغرافية، شكل جغرافي، تتبع جغرافي	رقم	يقرب الرقم العشري إلى خانات عشرية محددة.
useGrouping	منطق	عشري	رقم	إذا كانت القيمة "صحيح"، يرجع رقمًا بفواصل تجميع محددة بواسطة الإعدادات المحلية، وإلا فلن يتم استخدام فواصل إذا كانت خطأ.
toFixed	حفظ الأماكن	عدد عشري، نقطة جغرافية، شكل جغرافي، تتبع جغرافي	رقم	يحدد عددًا ثابتًا من الأرقام بعد الفاصل العشري. ستملأ الصفر إذا لزم الأمر لتلبية عدد ثابت من الأرقام.

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

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

النص

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

${multilinetext1 | appearance:"multiline"}

ضع هذا التعبير في سطر مخصص؛ وإلا ستحدث أخطاء.

الأرقام

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

${number1 - 15}

${number1 * 6}

${number1 / number2}

${number1 % number2}

تلميح:

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

بالنسبة لأسئلة الأعداد العشرية، يمكن استخدام تعبير round لتعيين الحد الأقصى لعدد الخانات العشرية التي يتم تقريب القيمة إليها. المثال التالي يقرِّب العدد 3.141592 إلى أربع خانات عشرية 3.1416:

${decimal1 | round:4}

يمكن استخدام تعبير toFixed لتعيين الحد الأقصى لعدد الخانات العشرية التي يتم تقريب القيمة إليها. يصحح المثال التالي عدد الخانات العشرية في 3.14 إلى 3.140:

${decimal1 | toFixed:3}

يمكنك استخدام تعبير التنسيق لعرض الإجابة عن سؤال رقمي بطريقة معينة باستخدام الرموز النائبة. الرموز النائبة التالية مدعومة.

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

تلميح:

سيتم عرض الفواصل العشرية وفواصل الآلاف في النتيجة المطبوعة بناءً على الإعدادات المحلية المختارة.

يُرجع المثال التالي الإجابة إلى ثلاثة منازل عشرية بحد أقصى بفواصل الآلاف، مع التقريب إذا لزم الأمر.

${decimal1 | format:"#,##0.###"}

الصور والمرفقات الأخرى

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

${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"}

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

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

لإرجاع صور متعددة تم إرسالها إلى نفس السؤال في الرد، استخدم اسم سؤال الصورة بدلاً من $attachment:

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

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

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

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

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

أسئلة الخريطة

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

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

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

تدعم أسئلة الخريطة تعيين معرف عنصر خريطة الويب ومقياس الخريطة كمعلمات اختيارية. في المثال التالي، يُستخدم مقياس خريطة 1:100000:

${location | map:"7e2b9be8a9c94e45b7f87857d8d168d6" | mapScale:100000}

لجميع أسئلة الخريطة، يمكنك استخدام طريقة rotate لتحديد دوران عقارب الساعة للشمال المطلوب بالنسبة إلى العرض. يقبل قيم من 0 إلى 360.

${location | map:"7e2b9be8a9c94e45b7f87857d8d168d6" | mapScale:100000 | rotate:90}

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

يمكن استخدام الطريقة mapExtent لتعيين نطاق الخريطة في التقرير بشكل صريح. في المثال التالي، يُعرض نطاق خريطة ثابت لطوكيو عاصمة اليابان:

${location | mapExtent:139.7:35.6:139.9:35.8:4326}

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

${location | size:400:400}

يمكنك استخدام تعبيرات map وmapScale وsize معًا لتوفير معرف خريطة ويب ومقياس خريطة علاوة على دقة صورة خريطة كما هو موضح في المثال التالي:

${location | map:"7e2b9be8a9c94e45b7f87857d8d168d6" | mapScale:100000 | size:400:400}

ملاحظة:‏

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

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

${location | drawingInfo:"currentLayer"}

${location | drawingInfo:"https://.../FeatureServer/0"}

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

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

${location | where:"status='broken' !important" | map:"<itemID>" | size:400:300}

ملاحظة:‏

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

يمكنك تعيين تعبير where ليكون عبارة صحيحة دائمًا لضمان عرض كل الأشكال الهندسية في الطبقة:

${location | where:"1=1 !important"}

يمكن أيضًا استخدام هذا لعرض جميع النقاط خلال تكرار:

${repeat1.repeatLocation | where:"inspectionId=123 !important" | size:400:300}

يمكن أيضًا استخدام العنصر النائب ${$shape} لإرجاع العديد من الأشكال الهندسية للخريطة.

${$shape | where:"1=1 !important" | drawingInfo:"currentLayer" | size:400:300}

النقاط الجغرافية

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

${location | getValue:"x"}

${location | getValue:"y"}

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

تلميح:

يمكنك أيضًا عرض قيمة الارتفاع من خلال تعبير مماثل لكن إذا كانت طبقة المعالم الأساسية تدعم قيم Z.

${location | getValue:"z"}

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

${location | getValue:"x" | round:3}

${location | getValue:"x" | toFixed:3}

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

${location | getValue:"x":4326}

التتبع الجغرافي والشكل الجغرافي

بالنسبة إلى أسئلة التتبع الجغرافي والشكل الجغرافي، يمكن استخدام تعبير getValue لعرض طول الخط أو محيط المضلع، على التوالي:

${polyline1 | getValue:"length":"meters":"planar"}

بالنسبة إلى أسئلة الشكل الجغرافي، يمكنك استخدام تعبير getValue أيضًا لعرض مساحة المضلع:

${polygon1 | getValue:"area":"hectares":"geodesic"}

الوحدات وطريقة الحساب معلمات اختيارية. يتم قبول الوحدات التالية للطول:

• feet
• kilometers
• meters
• miles
• nautical-miles
• yards

يتم قبول الوحدات التالية للمساحة:

• acres
• hectares
• square-miles
• square-kilometers
• square-meters
• square-feet
• square-yards

بدلاً من ذلك، يمكنك استخدام أي من ثوابت esriSRUnitType أو ثوابت esriSRUnit2Type المدعومة من ArcGIS REST API. في تعبيرك، استخدم الرمز الرقمي للثابت دون علامات اقتباس كما يلي:

${polyline1 | getValue:"length":109002:"geodesic"}

إذا لم يتم تحديد أي وحدات، فإن الافتراضي سيكون kilometers للطول أو square-kilometers للمساحة.

يمكن أن تكون الطريقة إما geodesic أو planar. إذا لم يتم تحديد أي طريقة، فسيتم استخدام geodesic بشكل افتراضي.

التاريخ والوقت والتاريخ-الوقت

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

${datetime | locale:"pt-br"}

ملاحظة:‏

للحصول على معلومات عن الرمز المحلي للغة محددة، راجع List of ISO 639-1 codes (قائمة رموز ISO 639-1) التابعة لويكيبيديا. ومع ذلك، ضع في الاعتبار أنه لا يتم دعم كل هذه اللغات بواسطة Survey123.

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

${datetime | utcOffset:"+01:00"}

تدعم طريقة utcOffset تنسيقات +01:00، و+0100، و+01، وستُرجِع النتيجة نفسها. يمكنك أيضًا استخدام هذه الطريقة لتبديل عرض وقت إرسال الإجابة. يجب معرفة أن utcOffset لا يعمل مع أسئلة الوقت.

بالنسبة إلى أسئلة التاريخ والتاريخ-الوقت، يمكنك استخدام تعبير لتنسيق التاريخ باستخدام العناصر النائبة DD وMM وYYYY لليوم والشهر والسنة على التوالي. يظهر التعبير التالي اليوم والشهر فقط، مع حذف السنة:

${date | format:"DD/MM"}

يمكنك أيضًا تنسيق أسئلة الوقت في أسئلة التاريخ-الوقت، باستخدام HH، وmm، وSS كعناصر نائبة للساعات والدقائق والثواني على التوالي. يظهر التعبير التالي اليوم والشهر والساعات والدقائق:

${datetime | format:"DD/MM HH:mm"}

ملاحظة:‏

يجب عليك وضع طريقة format في نهاية التعبير.

يسرد الجدول التالي العناصر النائبة للتاريخ والوقت الأكثر شيوعًا:

عنصر نائب	الوصف
YY	آخر رقمين من السنة. مثال: سيتم تمثيل 2023 كـ 23.
YYYY	الأربعة أرقام للسنة. مثال: سيتم تمثيل 2023 كـ 2023.
M	رقم الشهر بين 1 و12. مثال: سيتم تمثيل يناير كـ 1.
MM	رقم الشهر مكون من رقمين. مثال: سيتم تمثيل يناير كـ 01.
MMM	شهر في ثلاثة أحرف. مثال: سيتم تمثيل يناير في صورة ينا.
MMMM	اسم الشهر بالكامل مثال: سيتم تمثيل يناير في صورة يناير.
D	رقم اليوم بين 1 و31. مثال: يتم تمثيل اليوم الأول من الشهر في صورة 1.
DD	رقم اليوم مكون من رقمين. مثال: يتم تمثيل اليوم الأول من الشهر في صورة 01.
افعل	رقم اليوم الذي يتضمن لاحقات ترتيبية. مثال: يتم تمثيل اليوم الأول من الشهر على أنه الأول.
H	رقم الساعة بنظام 24 ساعة. مثال: 11 مساءً. سيتم تمثيله على أنه 23.
HH	رقم الساعة بنظام 24 ساعة في رقمين. مثال: سيتم تمثيل الساعة 2 صباحًا على أنها 02.
ساعة	رقم الساعة بتوقيت 12 ساعة. مثال: 11 مساءً. سيتم تمثيله على أنه 11.
hh	رقم الساعة بتوقيت 12 ساعة في رقمين. مثال: سيتم تمثيل الساعة 2 صباحًا على أنها 02.
m	رقم الدقيقة بين 0 و59. مثال: سيتم تمثيل 8 دقائق على أنها 8.
مم	رقم الدقيقة في رقمين. مثال: 8 دقائق سيتم تمثيلها على أنها 08.
Z	إزاحة المنطقة الزمنية بالساعات باستخدام الفاصل. أمثلة: -07:00، +13:00
ZZ	إزاحة المنطقة الزمنية بالساعات بدون فاصل. أمثلة: -0700، +1300
x	طابع زمني ميلي ثانية يونكس. أمثلة: 9 مساءً. في 4 مايو 2023 بتوقيت جرينتش سيتم تمثيله على أنه 1683234000000.
X	طابع زمني يونكس. أمثلة: 9 مساءً. في 4 مايو 2023 بتوقيت جرينتش سيتم تمثيله على أنه 1683234000.
آر	تدوين الصباح أو بعد الظهر بأحرف صغيرة. مثال: سيتم تمثيل صباحًا بصيغة ص ومساءً سوف تُمثل كـ م.
A	تدوين الصباح أو بعد الظهر بأحرف كبيرة. مثال: سيتم تمثيل صباحًا كـ ص ومساءً سوف تُمثل كـ م.

اختيار متعدد

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

${if select_one=="choice1Value"}The user selected the first choice.${/}

لعرض قيمة اختيار عن قصد بدلاً من التسمية، استخدم تعبير getValue:

${select_one | getValue:""}

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

${select_one | checked:"yes"} Yes

حدد تعبيرات دعم أسئلة متعددة لإخراج إجمالي عدد الاختيارات المحددة ولإخراج اختيار محدد:

${select_multiple | countSelected}

${choiceQuestion1 | selectedAt:2}

ملاحظة:‏

يبدأ تعبير selectedAt بحساب الاختيارات المحددة عند صفر. هذا يعني أن ${choiceQuestion1 | selectedAt:2} سيرجع الاختيار الثالث المحدد.

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

${select_multiple | appearance:"bullets"}

ملاحظة:‏

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

${select_one | checked:"Service provided by \"Greg's Plumbing\""} Service provided by "Greg's Plumbing"

تكرار

للوصول إلى الأسئلة في تكرار، أضف قسم تكرار إلى القالب. بالنسبة لعيوب الأسماء المتكررة، يشير عنصر ${#defects} النائب إلى بداية قسم محدد، في حين يشير ${/} إلى النهاية. يجب أن تكون العناصر النائبة التي تشير إلى الأسئلة في التكرار بين بداية قسم التكرار والعناصر النائبة.

ملاحظة:‏

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

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

${#repeat1}
${#repeat2}
${#repeat3}
${field1InRepeat3}, ${repeat2.field1}, ${repeat1.field1}, ${mainLayer.field1} 
${/}
${/}
${/}

لا يمكن لتعبيرات التقرير قراءة الأحرف الخاصة، مثل الواصلات، عند الإشارة إلى أسماء الطبقات باستخدام بناء الجملة ${layername}. عند الإشارة إلى طبقة تحتوي على رمز خاص في اسمها، استخدم شرطة سفلية في مكان الحروف الخاصة. بدلاً من ذلك، يمكنك الرجوع إلى الطبقة من خلال الكلمة الأساسية $layers وإما اسم الطبقة أو معرف الطبقة، على سبيل المثال، ${$layers["my layer name"]} أو ${$layers[0]}. يمكن أن يكون هذا مفيدًا مع أسماء الطبقات المكررة.

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

لعرض فهرس سجل تكرار، استخدم التعبير getValue مع الكلمة الأساسية المحجوزة $feature. سينتج هذا المثال 1 للسجل الأول في تكرار ما، و2 للسجل الثاني، وهكذا:

${#defects}
${$feature | getValue: "position"}
${/}

استعلامات التقرير

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

لتقييد طباعة تقريرك إلى عدد محدد من التكرارات، بدلاً من كل تكرار مرتبط بالإجابة، استخدم طريقة resultRecordCount لتعيين عدد معين من التكرارات للطباعة:

${#defects | resultRecordCount:20}...${/}

يمكنك استخدام طريقة orderByFields لتحديد الترتيب الذي ستتم مراعاته في طباعة التكرارات. قم بتعريف اسم الحقل متبوعًا بـ ASC أو DESC، وستتم طباعة التكرارات وفقًا لإدخال ذلك الحقل إما بترتيب تصاعدي أو تنازلي، على التوالي.

${#defects | orderByFields:"state_name ASC, pop2000 DESC"}...${/}

عناصر التقرير الشرطية

يمكنك إظهار عناصر من التقرير أو إخفاؤها بشروط باستخدام عبارات إذا. يمكنك استخدام عبارة إذا بكتابة تعبير في العنصر النائب ${if expression} في البداية، وإشارة ${/} إلى نهاية المقطع الشرطي. فيما يلي بعض الأمثلة على عبارات إذا التي يمكنك استخدامها لإظهار أجزاء من التقرير أو إخفائها:

• يعرض ${if photo1} القسم فقط إذا تمت الإجابة على سؤال photo1.
• يعرض ${if integer1>0} القسم فقط إذا كانت الإجابة على سؤال integer1 رقمًا موجبًا.
• يعرض ${if ((geopoint1 | getValue:"y")>0)} القسم فقط إذا كانت النقطة الجغرافية في نصف الكرة الشمالي.
• يعرض ${if multiple_choice1 | selected:"A"} القسم فقط إذا كان سؤال الاختيار المتعدد محدد له الاختيار "أ".
• يعرض ${if (repeat1 | getValue:"count")>=3} القسم فقط إذا احتوى تكرار 1 على ثلاثة سجلات أو أكثر.

في المثال التالي، سيظهر النص الموجود في السطر الثاني في التقرير فقط، إذا تم تحديد high للأولوية، فحدد سؤالاً واحدًا:

${if priority | selected:"high"}
High priority issues must be addressed within seven days.
${/}

للتحقق ما إذا كانت الإجابة تتضمن قيمة أو سؤالاً، استخدم فقط البيان الشرطي "إذا" الذي يشير إلى اسم الحقل مباشرةً دون أي مشغلات أخرى، على سبيل المثال ${if photo1}. سيضمن هذا التنسيق أن السلاسل الفارغة والقيم الخالية والقيم غير المعرفة بمثابة قيم فارغة. ينطبق هذا التنسيق على أنواع حقول السلسلة والرقم والتاريخ والمرفق. عند استخدام هذا التنسيق مع التكرارات، سيظهر القسم طالما كان هناك مثيل واحد على الأقل في التكرار.

لاستخدام العبارات الشرطية مع أسئلة التاريخ والوقت، قم بإجراء العمليات الحسابية باستخدام وقت الحقبة (الوقت بالميلي ثانية المنقضي منذ 1 يناير 1970). على سبيل المثال، يعرض ${if (date1|getValue:"") < 1602735375000} القسم فقط إذا كانت القيمة في حقل التاريخ أقدم من 14 أكتوبر 2020. كن على علم بأن بناء جملة التقرير ليس له ما يعادل وظائف XLSForm today() أو now()، لذلك من المستحيل تكوين جملة شرطية للأوقات المتعلقة بوقت طباعة التقرير.

يتم دعم المشغلات المنطقية التالية إذا كانت العبارات:

مُشغل	الوصف
||	صحيح إذا قامت إحدى العبارتين بإرجاع "صحيح"
&&	صحيح إذا قامت كلتا العبارتين بإرجاع "صحيح"
!	صحيح إذا لم تكن العبارة "غير صحيحة"
==	صحيح إذا كانت القيمتين المتوفرتين متساويتين
!=	صحيح إذا كانت القيمتين المتوفرتين غير متساويتين
>	تقييم ما إذا كانت القيمة الأولى أكبر من القيمة الثانية
>=	تقييم ما إذا كانت القيمة الأولى أكبر من أو تساوي القيمة الثانية
<	تقييم ما إذا كانت القيمة الأولى أقل من القيمة الثانية
<=	تقييم ما إذا كانت القيمة الأولى أقل من أو تساوي القيمة الثانية

قيود

توجد القيود التالية عند استخدام قوالب التقرير:

• لن يتم تطبيق عوامل التصفية المطبقة على التكرارات في موقع الويب Survey123 في التقارير. لا يمكن تصفية التكرارات إلا في تقرير باستخدام التعبيرات.
• لن تظهر خريطتك في تقريرك إذا كانت الخريطة تستخدم إصدار خريطة ويب أقدم من 2.0، والذي تم إصداره في يوليو 2014.
• لن تظهر خريطتك في تقريرك إذا كانت بوابة ArcGIS Enterprise لا تتضمن شهادة SSL صالحة.
• لا تعمل الطباعة باستخدام قوالب التقرير مع عمليات نشر ArcGIS Enterprise التي لا تواجه العامة. ستُظهر محاولة القيام بذلك خطأ getaddrinfo ENOTFOUND.
• لا تعمل الطباعة باستخدام قوالب التقارير مع عمليات نشر ArcGIS Enterprise التي تستخدم المصادقة المتكاملة في Windows ‏(IWA).
• يمكن تضمين 2000 سجل كحد أقصى لكل طلب تقرير.
• عند تثبيت موقع ويب Survey123 على البنية الأساسية، لا يمكن استخدام واجهة برمجة التطبيقات API الخاصة بإعداد التقارير. يمكن إنشاء التقارير فقط باستخدام https://survey123.arcgis.com/.