快速参考

ArcGIS Survey123 支持大量的 XLSForm 规范。 本参考指南提供了有关可用于 Survey123 的 XLSForm 功能的汇总信息。 可以在 Survey123 Connect 或 Survey123 网站中创建调查 - 某些功能只能使用其中一种方法创建，而某些功能两种方法均可。

问题类型

下表描述了在 Survey123 Connect、Survey123 外业应用程序、Survey123 Web 设计器和 Survey123 Web 应用程序中可用的问题类型。 在某些问题中，在不同平台上的行为和实施存在差异；有关这些差异，请参考表格后的注释。

Survey123 Connect 问题类型	Survey123 web 设计器问题类型	描述	在 Survey123 外业应用程序中受支持	在 Survey123 web 应用程序中受支持
audio⁴	音频⁴ ⁶	在外业应用程序中录制音频剪辑。录制音频剪辑或接受在 Web 应用程序中上传的音频文件。	是	是
barcode	条形码	扫描条形码或二维码。	是	是
begin group	组、页面	开始一组问题。	是	是
begin repeat	N/A	开始一组重复问题。	是	是
计算	N/A	针对表单中的值执行计算。 计算字段包含计算的结果。	是	是
decimal¹	数字¹ ⁶	小数输入。	是	是
date	日期⁶	日期输入。	是	是
dateTime	日期和时间⁶	日期和时间输入。	是	是
deviceid	N/A	表示采集调查的特定设备的 UUID。	是	否
email²	N/A	使用组织账户登录时，此字段自动使用账户电子邮件地址进行填充。	是	是
end	N/A	调查的结束日期和时间。	是	是
end group	组、页面	结束一组问题。	是	是
end repeat	N/A	结束一组重复问题。	是	是
file	文件上传	接受设备上的文件。	是	是
geopoint³	地图³ ⁶	采集指定 GPS 坐标。 默认为当前位置。	是	是
geoshape³		在地图上采集面。	是	是
geotrace³		在地图上采集线。	是	是
hidden	N/A	在要素图层中创建不显示在表单中的字段。 使用 bind::esri:fieldType 和 bind::esri:fieldLength 列指定此字段的数据方案。	是	是
integer¹	数字¹ ⁶	整数数值输入。	是	是
图像	图像、签名	接受来自设备文件的图像或直接拍摄的照片。	是	是
note	注释⁶	在屏幕上显示文本。 备注也可以处理隐藏的计算。	是	是
range	滑块⁶	输入给定范围的数值。	是	是
rank list_name	分级⁶	评级问题；对选项列表进行排序。 将 list_name 替换为选项列表的名称。	是	是
select_one list_name	下拉列表⁵ ⁶、李克特量表⁵ ⁶、评分⁶、单选⁶、单选表格⁶	单项选择问题；只能选择一个答案。 将 list_name 替换为选项列表的名称。	是	是
select_one_from_file file_name.csv	N/A	单项选择问题；只能选择一个答案。 将 file_name.csv 替换为包含选择列表的调查媒体文件夹中的文件名。	是	是
select_multiple list_name	多选⁶	多项选择问题；可以选择多个答案。 将 list_name 替换为选项列表的名称。	是	是
select_multiple_from_file file_name.csv	N/A	多项选择问题；可以选择多个答案。 将 file_name.csv 替换为包含选择列表的调查媒体文件夹中的文件名。	是	是
start	N/A	调查的开始日期和时间。	是	是
text	地址⁶、电子邮件⁶、多行文本⁵ ⁶、单行文本⁶、网站⁶	自由文本答案。 正则表达式适用于电子邮件和网站。 地理编码外观应用于地址。	是	是
时间	时间⁶	时间输入。	是	是
username	N/A	使用组织账户登录时，此字段自动使用账户用户名进行填充。	是	是

¹Web 设计器将整数和小数问题组合成一个名为“数值”的单一问题类型。 调查设计人员可以使用问题属性中的复选框定义需要的输入。

²Survey123 Connect 和 Survey123 web 设计器提供的电子邮件问题类型的实施方式不同。 Survey123 Connect 中的实施将自动填充用户登录的组织账户的电子邮件地址。 Survey123 web 设计器中的实施则是一个文本字段，只接受匹配电子邮件地址的格式。

³地理点、geotrace 和 geoshape 问题已合并为一个名为 Map 的问题类型。 调查设计人员可以使用问题属性中的复选框定义需要的输入。 名为 Address 的附加问题类型允许提交地理编码点。

⁴音频问题不允许在 Survey123 外业应用程序中上传，这与在 Web 应用程序中一样。要允许在外业应用程序中上传音频，使用文件问题。

⁵在 Survey123 Connect 中可用的几种外观在 Survey123 web 设计器中则变成了单独的问题类型。 包括多行文本、下拉列表和李克特量表。

⁶对于每个问题，web 设计器都提供了一个缓存答案的选项。 在 Web 应用程序中，提交调查记录后，问题的答案将被缓存在浏览器中，并预加载到该设备上为此调查所进行的下一次提交中。 可以为除音频、图像、文件上传和签名之外的所有问题类型设置缓存答案。

默认值

大多数类型的问题允许定义默认答案，以便在加载调查时自动使用。 这与 XLSForm 中 default 列的作用相同。

数据验证

检查编辑选项卡上的这是必填问题将导致调查问题必须包含一个值，然后才能完成表单。

大多数问题还具有设置最小和最大长度的功能。 除非问题响应介于所限定的范围内，否则此功能将会阻止系统提交调查。 此功能与 Survey123 XLSForm 规格中的 constraint 或 bind::esri:fieldLength 列的作用相同。

特殊字符

问题名称和选项名称不应包含特殊字符，如空格、逗号、连字符、圆括号、方括号或诸如 $、% 和 # 等字符。 多选 问题的选项名称不得包含空格或逗号。