يدعم ArcGIS Survey123 إعداد instance_name في XLSForm. باستخدام إعداد instance_name، يمكن لمؤلف الاستطلاع التحكم في المعلومات المستخدمة لتعريف كل إجابة بشكل فريد في مسودات تطبيق Survey123 الميداني ومجلدات الصادر والوارد والمُرسَل.
اسم المثيل يكون مفيدًا عند النظر إلى محفوظات الاستطلاعات المرسلة في مجلد المُرسَل لتطبيق Survey123 الميداني أو لتعريف الاستطلاعات الفردية في مجلد الوارد الخاص بالتطبيق الميداني.
في هذا المثال، تم تطبيق التعبير التالي على اسم المثيل إلى الإجابات عن سؤالين نصيين مفصول بينهما بمسافة كمعرِف لكل سجل استطلاع (في هذه الحالة، الاسم الكامل للشخص):
concat(${first_name}, ' ', ${last_name})
تم تعريف اسم المثيل في ورقة عمل الإعدادات الخاصة بـ XLSForm. عندما يكون عمود instance_name فارغًا، سيتم تطبيق اسم مثيل افتراضي يسرد جميع الإجابات عن الأسئلة الواردة في الاستطلاع. اكتب تعبيرًا في عمود instance_name لتخصيص اسم المثيل. على سبيل المثال:
${site_name}
format-date(${date_time}, '%Y-%m-%d')
concat(${category}, ' Remarks: ', ${remarks})
concat(${street_number}, ' ', ${street_name}, ' ', ${suburb})
يمكنك استخدام العمليات الحسابية لإنشاء اسم المثيل، مثل:
${first_number} + ${second_number}
يمكنك أيضًا تطبيق تنسيق HTML على اسم المثيل. يجب عليك تسلسل بناء جملة HTML كجزء من اسم المثيل باستخدام وظيفة concat(). في المثال التالي، تم تنسيق اسم المثيل بنص أزرق مائل، مع كتابة الاسم الأخير بخط عريض:
concat('<font color="blue"><i><b>', ${last_name}, '</b>, ', ${first_name}, '</i></font>')
تلميح:
إذا كان بناء جملة HTML يتضمن علامات اقتباس، يجب عليك استخدام علامات اقتباس فردية لإحاطة سلسلة نصية تحتوي على علامات اقتباس مزدوجة، أو العكس. على سبيل المثال: '<font color="yellow">'.
ستعرض أسماء المثيلات ثلاثة أسطر من النص بحد أقصى.
يستخدم المثال التالي عبارة if() لتطبيق التنسيق الشرطي على اسم المثيل. إذا كانت الإجابة عن سؤال approved هي yes، يكون اسم المثيل ملونًا باللون الأخضر؛ وإلا فباللون الأحمر:
if(${approved}='yes', concat('<font color="green"><b>', ${last_name}, '</b>, ', ${first_name}, '</font>'), concat('<font color="red"><b>', ${last_name}, '</b>, ', ${first_name}, '</font>'))