XLSForm 中的某些问题类型具有额外参数,允许您控制调查中问题的样式或行为。 在某些情况下,这些参数补充了问题类型支持的外观。 下表概述了可以在 XLSForm 中使用的参数,以及调查工作表上接受每个参数的列。 并非 ArcGIS Survey123 外业应用程序和 Web 应用程序都支持所有参数。 有关外业应用程序和 Web 应用程序支持的详细信息,请参阅每个参数的文档主题。
您可以通过用空格分隔参数来将问题的多个参数添加到同一列。 例如,geoshape 问题可以在 body::esri:style 列中包含 map、method、lineColor 和 fillColor 参数,如下所示:
map="Imagery Hybrid" method=vertex lineColor=#DC143C fillColor=LightYellow
常规
下表包含可用于各种问题类型的 XLSForm 参数。 有关支持参数的问题类型列表,请参阅每个参数的描述。 这些参数仅在外业应用程序中受支持。
XLSForm 列 | 参数 | 描述 |
---|---|---|
bind::esri:parameters | calculationMode | 控制何时执行问题中的计算。 问题类型:text | decimal | integer | note | date | time | dateTime | select_one | select_multiple | geopoint | calculate | hidden 值:auto | manual | always | whenEmpty 例如:
|
body::esri:style | placeholderText | 指定当问题为空时,将显示在问题输入区域中的文本。 问题类型:text | integer | decimal | select_one(包含自动完成外观)| barcode 值:@[hint] | @[guidance_hint] 例如:
|
音频
下表包含可用于 audio 问题类型的 XLSForm 参数。 除非说明中另有说明,否则这些参数仅在外业应用程序中受支持。
XLSForm 列 | 参数 | 描述 |
---|---|---|
bind::esri:parameters | codec | 指定音频录制的首选编解码器。 可以提供多个编解码器,以逗号分隔。 将使用与设备兼容的第一个编解码器。 值:<codec name> 示例:
|
fileName | 指定文件名。 值:<expression> 此参数仅在 Web 应用程序中受支持。 例如:
| |
max-duration | 指定音频录制的最大持续时间(以秒为单位)。 Web 应用程序中的默认持续时间为 600(10 分钟)。 值:<seconds> 示例:
| |
max-size | 指定音频录制的最大文件大小(以兆字节为单位)。 外业应用程序中的默认大小为 10 MB。 值:<megabytes> 示例:
|
条形码
下表包含可用于 barcode 问题类型的 XLSForm 参数。 这些参数仅在外业应用程序中受支持。
XLSForm 列 | 参数 | 描述 |
---|---|---|
body::esri:style | 指定用户可以扫描的条形码类型。 可以提供多个类型并以逗号分隔。 如果未提供 barcodeType 参数,则可以扫描所有受支持的条形码类型,aztec、code39、datamatrix、maxicode 和 pdf417 除外。 值:all | 1d | 2d | <barcode types>
一维类型:codabar | code128 | code39 | code93 | ean13 | ean8 | itf | upca | upce | upceanextension 二维类型:aztec | datamatrix | maxicode | pdf417 | qrcode | rss14 | rssexpanded 例如:
|
文件
下表包含可用于 file 问题类型的 XLSForm 参数。
群组
下表包含可用于 begin group 问题类型的 XLSForm 参数。 这些参数仅在外业应用程序中受支持。
图像
下表包含可用于 image 问题类型的 XLSForm 参数。 除非说明中另有说明,否则这些参数仅在外业应用程序中受支持。
XLSForm 列 | 参数 | 描述 |
---|---|---|
bind::esri:parameters | allowAdds | 编辑现有记录时禁用添加新图像。 值:false 示例:
|
fileName | 指定文件名。 值:<expression> 此参数还在 Web 应用程序中受支持。 例如:
| |
max-size | 指定最大文件大小(以兆字节为单位)。 默认设置为 10 MB。 值:<megabytes> 此参数还在 Web 应用程序中受支持。 示例:
| |
对于具有注记外观的图像问题,自动在检测到的对象周围生成标注的注记图像和边界框。 追加这些属性以定义注记的样式和格式。 必需属性:<model_name> 可选属性:minScore | cameraPreview | label | class | boundingBoxes | outlineWidth | fontSize | font | bold | italic 例如:
| ||
执行对象检测或图像分类并在调查中使用 EXIF 结果。 必需属性:<model_name> 可选属性:minScore | cameraPreview | label | class 例如:
| ||
自动生成或手动添加边界框并在目标区域应用涂黑效果。 必需属性:<model_name> | @faces | @manual 可选属性:minScore | cameraPreview | label | class | effect | symbol | fillColor | scale 例如:
| ||
watermark topLeftWatermark topCenterWatermark topRightWatermark leftCenterWatermark centerWatermark rightCenterWatermark bottomLeftWatermark bottomCenterWatermark bottomRightWatermark | 指定图像水印的位置。 追加属性以定义内容和格式。 有关详细信息,请参阅水印。 属性:text | color | outlineColor | outlineWidth | haloColor | size | font | bold | italic | margin | image | imageSize 例如:
| |
body::esri:style | allowRename | 指定用户是否可以手动编辑文件名。 值:true | false 示例:
|
fileNameVisible | 指定文件名是否在调查中可见。 值:true | false 示例:
| |
footerText | 对于带有签名外观的图像问题,指定要在签名弹出窗口底部显示的文本。 如果未指定值,可将问题的指导提示显示在签名下方。 可以使用 footerText=@[hint] 将上述内容更改为问题提示。 值:<none> | @[hint] 例如:
| |
method | 指定图像问题的捕获方法。 map 值仅支持带有注释外观的图像问题。 此参数还在 Web 应用程序中受支持。 值:browse | camera | map 例如:
| |
palette | 对于具有绘图或注释外观的图像问题,需指定自定义绘图工具面板。 值:<palette name> 示例:
| |
previewHeight | 选择图像后,设置图像预览的高度。 如果您希望图像预览以最大尺寸显示且没有多余空白,请使用 previewHeight=0。 值:<lines> | <lines>lines | <percentage of screen height>% | <pixels>pixels 例如:
| |
parameters | max-pixels | 对于图像问题,在最长边上设置图像的最大尺寸,保持原始纵横比。 对于带有签名外观的图像问题,指定签名弹出窗口的最大宽度。 对于具有绘图外观的图像问题,将画布设置为正方形 (1:1) 图像。 此参数还在 Web 应用程序中受支持。 值:<pixels> 例如:
|
地图问题
下表包含可用于 geopoint、geotrace 和 geoshape 问题类型的 XLSForm 参数。 除非说明中另有说明,否则这些参数仅在外业应用程序中受支持。
XLSForm 列 | 参数 | 描述 |
---|---|---|
body::esri:style | height | 设置图像预览的高度。 值:<lines> | <lines>lines | <percentage of screen height>% | <pixels>pixels 例如:
|
lineColor² fillColor³ | 指定线或面要素的线和填充颜色。 此内容仅适用于 Survey123 中的地图预览。 有关详细信息,请参阅样式选项。 值:<HTML color name> | <hex color code> 示例:
| |
lineWidth² | 指定线或面要素的线宽度(以像素为单位)。 此内容仅适用于 Survey123 中的地图预览。 值:<pixels> 例如:
| |
map | 设置默认底图。 此参数还在 Web 应用程序中受支持。 值:<map name> | <map item ID> 例如:
| |
mapTools | 控制适用于 geopoint、geotrace 和 geoshape 问题的地图工具。 此参数仅适用于外业应用程序。 值:search | mapSwitcher | zoom | home | locate 例如: | |
method² | 指定捕获方法。 使用折点方法时,可以设置其他参数。 此参数还在 Web 应用程序中受支持。 值:sketch | vertex 仅在外业应用程序中适用的其他折点值:streaming | beep | haptic | edit 例如:
| |
minCaptureZoomLevel | 指定可以捕获几何的最低级别。 此参数仅在 Web 应用程序中受支持。 值:<integer> 示例: | |
overlay | 在调查中的任何其他 geopoint、geoshape 或 geotrace 问题的重复中显示第一个 geopoint 问题的点位置。 追加属性以定义内容和样式。 值:<repeat name> 属性:view | preview | icon | iconColor | iconOutlineColor | iconSize | label | labelColor | labelOutlineColor | fontSize 例如:
| |
precision | 指定将在地图问题中采集的并在调查的单个响应面板中显示的小数位数。 如果未设置此参数,将在地图问题中采集所有可用的小数位数,但是仅在单个响应面板中显示六个小数位。 此参数仅在 Web 应用程序中受支持。 值:<integer> 示例: | |
snapMode | 指定捕捉行为。 点可以捕捉到其他要素,而线和面可以捕捉到其他要素或其自身。 仅当 method=vertex 时可用。 此参数仅在 Web 应用程序中受支持。 值:feature | self² 示例:
| |
symbol¹ | 指定要用作地图上的点标记的 .png 文件。 追加属性以定义位置和比例。 值:<file name>.png 属性:x | y | scale 示例:
|
¹仅受 geopoint 问题类型支持。
²仅受 geoshape 和 geotrace 问题类型支持。
³仅受 geoshape 问题类型支持。
多项选择问题
下表包含可用于 select_one、select_multiple 和 rank 问题类型的 XLSForm 参数。 该参数在外业应用程序和 Web 应用程序中受支持。
XLSForm 列 | 参数 | 描述 |
---|---|---|
parameters | randomize | 随机化选择列表中的选择顺序。 值:true 示例:
|
范围
下表包含可用于 range 问题类型的 XLSForm 参数: 这些参数适用于外业应用程序和 Web 应用程序。
XLSForm 列 | 参数 | 描述 |
---|---|---|
body::esri:style | startColor endColor color | 指定范围起点和终点位置滑块的颜色。 使用 color 参数指定用于填充滑块起点和选定值之间的空间的颜色。 必须使用空格分隔参数。 有关详细信息,请参阅样式选项。 值:<HTML color name> | <hex color code> 例如:
|
参数 | start end step | 指定范围滑块的起点、终点和步长值。 必须使用空格分隔参数。 有关详细信息,请参阅范围参数。 值:<integer> | <decimal> 例如:
|
重复
下表包含可用于 begin repeat 问题类型的 XLSForm 参数。 这些参数仅在外业应用程序中受支持。
XLSForm 列 | 参数 | 描述 |
---|---|---|
bind::esri:parameters | allowAdds | 允许添加新的重复记录。 值:true | false 示例:
|
allowUpdates | 允许修改现有的重复记录。 值:true | false 示例:
| |
query | 允许在表单中显示现有的重复记录。 指定其他查询参数以过滤可用记录。 值:<none> | "SQL statement" 例如:
| |
body::esri:style | backgroundColor borderColor | 设置重复的背景和边框颜色。 有关详细信息,请参阅组、页面和重复颜色。 值:<HTML color name> | <hex color code> 例如:
|
文本
下表包含可用于 text 问题类型的 XLSForm 参数。 除非说明中另有说明,否则这些参数仅在外业应用程序中受支持。
XLSForm 列 | 参数 | 描述 |
---|---|---|
bind::esri:parameters | geocode | 对于具有地理编码外观的 text 问题,将定位器设置为在使用地理编码外观时返回地理编码结果。 此参数还在 Web 应用程序中受支持。 值:<locator item ID> 示例:
|
measurement | 对于具有测距仪外观的文本问题,设置要在问题中存储的测量值。 如果值包含空格,则将值列表包含在引号内。 值:height | azimuth | horizontalDistance | slopeDistance | inclination | multipleHeights 例如:
| |
body::esri:style | defaultHeight | 对于具有多行外观的文本问题,请设置文本框的初始高度。 文本框的高度将增加以容纳答案文本。 值:<number of lines> 示例:
|
indicator | 对于具有地理编码外观的文本问题,允许地理编码结果显示相对于当前设备位置的方向和距离。 值:direction | distance | none 例如:
| |
maxResults | 对于具有地理编码外观的文本问题,指定要返回的最大结果数。 默认值为 6。 值:<number of results> 此参数还在 Web 应用程序中受支持。 示例:
| |
proximity | 对于具有地理编码外观的文本问题,指定地理编码结果是否仅显示设备位置特定半径内的结果。 值:<distance>m | km | ft | mi | yd 例如:
| |
suggestions | 对于具有地理编码外观的文本问题,更改建议的填充方式。 默认设置为是。 值:yes | no 示例:
|
测距仪
下表包含可在 text、decimal 和 integer 问题中用于检索测距仪中的值的 XLSForm 参数。 除非说明中另有说明,否则这些参数仅在外业应用程序中受支持。
XLSForm 列 | 参数 | 描述 |
---|---|---|
bind::esri:parameters | measurement | 对于具有测距仪外观的文本问题,设置要在问题中存储的测量值。 如果值包含空格,则将值列表包含在引号内。 值:height | azimuth | horizontalDistance | slopeDistance | inclination | multipleHeights 例如:
|