XLSForm 参数

XLSForm 中的某些问题类型具有额外参数,允许您控制调查中问题的样式或行为。 在某些情况下,这些参数补充了问题类型支持的外观。 下表概述了可以在 XLSForm 中使用的参数,以及调查工作表上接受每个参数的列。 并非 ArcGIS Survey123 外业应用程序和 Web 应用程序都支持所有参数。 有关外业应用程序和 Web 应用程序支持的详细信息,请参阅每个参数的文档主题。

您可以通过用空格分隔参数来将问题的多个参数添加到同一列。 例如,geoshape 问题可以在 body::esri:style 列中包含 mapmethodlineColorfillColor 参数,如下所示:

map="Imagery Hybrid" method=vertex lineColor=#DC143C fillColor=LightYellow

常规

下表包含可用于各种问题类型的 XLSForm 参数。 有关支持参数的问题类型列表,请参阅每个参数的描述。 这些参数仅在外业应用程序中受支持。

XLSForm 列参数描述
bind::esri:parameterscalculationMode

控制何时执行问题中的计算。

问题类型:text | decimal | integer | note | date | time | dateTime | select_one | select_multiple | geopoint | calculate | hidden

值:auto | manual | always | whenEmpty

例如:

calculationMode=manual
calculationMode=always
body::esri:styleplaceholderText

指定当问题为空时,将显示在问题输入区域中的文本。

问题类型:text | integer | decimal | select_one(包含自动完成外观)| barcode

值:@[hint] | @[guidance_hint]

例如:

placeholderText=@[hint]
placeholderText=@[guidance_hint]

音频

下表包含可用于 audio 问题类型的 XLSForm 参数。 除非说明中另有说明,否则这些参数仅在外业应用程序中受支持。

XLSForm 列参数描述
bind::esri:parameterscodec

指定音频录制的首选编解码器。 可以提供多个编解码器,以逗号分隔。 将使用与设备兼容的第一个编解码器。

值:<codec name>

示例:

codec=amr-nb,aac
fileName

指定文件名。

值:<expression>

此参数仅在 Web 应用程序中受支持。

例如:

fileName=concat("JobID-", ${job_id})
fileName=concat(${asset_id}, "_", 
  format-date(now(), "%Y%m%d%H%M%S"))
max-duration

指定音频录制的最大持续时间(以秒为单位)。 Web 应用程序中的默认持续时间为 600(10 分钟)。

值:<seconds>

示例:

max-duration=45
max-size

指定音频录制的最大文件大小(以兆字节为单位)。 外业应用程序中的默认大小为 10 MB。

值:<megabytes>

示例:

max-size=5

条形码

下表包含可用于 barcode 问题类型的 XLSForm 参数。 这些参数仅在外业应用程序中受支持。

XLSForm 列参数描述
body::esri:style

barcodeType

指定用户可以扫描的条形码类型。 可以提供多个类型并以逗号分隔。 如果未提供 barcodeType 参数,则可以扫描所有受支持的条形码类型,azteccode39datamatrixmaxicodepdf417 除外。

值:all | 1d | 2d | <barcode types>

  • all - 所有受支持的类型,code39pdf417 除外。
  • 1d - 所有一维类型,code39 除外。
  • 2d - 所有二维类型,pdf417 除外。

一维类型:codabar | code128 | code39 | code93 | ean13 | ean8 | itf | upca | upce | upceanextension

二维类型:aztec | datamatrix | maxicode | pdf417 | qrcode | rss14 | rssexpanded

例如:

barcodeType=qrcode,aztec,code128
barcodeType=ean8,itf
barcodeType=2d
barcodeType=pdf417

文件

下表包含可用于 file 问题类型的 XLSForm 参数。

XLSForm 列参数描述
bind::esri:parametersfileName

指定文件名。

值:<expression>

此参数仅在 Web 应用程序中受支持。

例如:

fileName=concat("JobID-", ${job_id})
fileName=concat(${asset_id}, "_", 
  format-date(now(), "%Y%m%d%H%M%S"))
max-size

指定最大文件大小(以兆字节为单位)。 默认设置为 10 MB。

值:<megabytes>

该参数在外业应用程序和 Web 应用程序中受支持。

示例:

max-size=5

群组

下表包含可用于 begin group 问题类型的 XLSForm 参数。 这些参数仅在外业应用程序中受支持。

XLSForm 列参数描述
body::esri:style

backgroundColor

borderColor

设置组或页面的背景和边框颜色。 有关详细信息,请参阅组、页面和重复颜色

值:<HTML color name> | <hex color code>

例如:

backgroundColor=LightBlue
borderColor=#4682B4
backgroundColor=#C7FFC7 borderColor=#3C6D9E

layout

设置组的格网布局样式。

值:dynamic-grid | fixed-grid

示例:

layout=fixed-grid

图像

下表包含可用于 image 问题类型的 XLSForm 参数。 除非说明中另有说明,否则这些参数仅在外业应用程序中受支持。

XLSForm 列参数描述
bind::esri:parametersallowAdds

编辑现有记录时禁用添加新图像。

值:false

示例:

allowAdds=false
fileName

指定文件名。

值:<expression>

此参数还在 Web 应用程序中受支持。

例如:

fileName=concat("JobID-", ${job_id})
fileName=concat(${asset_id}, "_", 
  format-date(now(), "%Y%m%d%H%M%S"))
max-size

指定最大文件大小(以兆字节为单位)。 默认设置为 10 MB。

值:<megabytes>

此参数还在 Web 应用程序中受支持。

示例:

max-size=5

smartAnnotation

对于具有注记外观的图像问题,自动在检测到的对象周围生成标注的注记图像和边界框。 追加这些属性以定义注记的样式和格式。

必需属性:<model_name>

可选属性:minScore | cameraPreview | label | class | boundingBoxes | outlineWidth | fontSize | font | bold | italic

例如:

smartAnnotation=modelname
  &cameraPreview=true&minScore=0.52
smartAnnotation=modelname&
  cameraPreview=true&minScore=0.52
  &class=classname1,classname2
  &label=false&bold=true

smartAttributes

执行对象检测或图像分类并在调查中使用 EXIF 结果。

必需属性:<model_name>

可选属性:minScore | cameraPreview | label | class

例如:

smartAttributes=modelname
  &cameraPreview=true&minScore=0.45
smartAttributes=modelname
  &cameraPreview=true
  &class=classname1,classname2
  &label=false

redaction

自动生成或手动添加边界框并在目标区域应用涂黑效果。

必需属性:<model_name> | @faces | @manual

可选属性:minScore | cameraPreview | label | class | effect | symbol | fillColor | scale

例如:

redaction=modelname
  &cameraPreview=true&effect=blur
redaction=@manual&effect=blockout
redaction=@faces&cameraPreview=true
  &class=classname1,classname2
  &label=false@effect=symbol&symbol=🐻

watermark

topLeftWatermark

topCenterWatermark

topRightWatermark

leftCenterWatermark

centerWatermark

rightCenterWatermark

bottomLeftWatermark

bottomCenterWatermark

bottomRightWatermark

指定图像水印的位置。 追加属性以定义内容和格式。 有关详细信息,请参阅水印

属性:text | color | outlineColor | outlineWidth | haloColor | size | font | bold | italic | margin | image | imageSize

例如:

watermark="Example Text
  &outlineColor=White"
bottomLeftWatermark="Example Text
  &bold=true"
topRightWatermark="@[latitude longitude]
  &size=20"
body::esri:styleallowRename

指定用户是否可以手动编辑文件名。

值:true | false

示例:

allowRename=false
fileNameVisible

指定文件名是否在调查中可见。

值:true | false

示例:

fileNameVisible=true
footerText

对于带有签名外观的图像问题,指定要在签名弹出窗口底部显示的文本。 如果未指定值,可将问题的指导提示显示在签名下方。 可以使用 footerText=@[hint] 将上述内容更改为问题提示。

值:<none> | @[hint]

例如:

footerText
footerText=@[hint]
method

指定图像问题的捕获方法。 map 值仅支持带有注释外观的图像问题。

此参数还在 Web 应用程序中受支持。

值:browse | camera | map

例如:

method=camera
method=map
method=browse,camera,map
palette

对于具有绘图或注释外观的图像问题,需指定自定义绘图工具面板。

值:<palette name>

示例:

palette=SiteLayout
previewHeight

选择图像后,设置图像预览的高度。 如果您希望图像预览以最大尺寸显示且没有多余空白,请使用 previewHeight=0

值:<lines> | <lines>lines | <percentage of screen height>% | <pixels>pixels

例如:

previewHeight=3lines
previewHeight=120pixels
parametersmax-pixels

对于图像问题,在最长边上设置图像的最大尺寸,保持原始纵横比。

对于带有签名外观的图像问题,指定签名弹出窗口的最大宽度。

对于具有绘图外观的图像问题,将画布设置为正方形 (1:1) 图像。

此参数还在 Web 应用程序中受支持。

值:<pixels>

例如:

max-pixels=1500
max-pixels=400

地图问题

下表包含可用于 geopointgeotracegeoshape 问题类型的 XLSForm 参数。 除非说明中另有说明,否则这些参数仅在外业应用程序中受支持。

XLSForm 列参数描述
body::esri:styleheight

设置图像预览的高度。

值:<lines> | <lines>lines | <percentage of screen height>% | <pixels>pixels

例如:

previewHeight=6lines
previewHeight=250pixels

lineColor²

fillColor³

指定线或面要素的线和填充颜色。 此内容仅适用于 Survey123 中的地图预览。 有关详细信息,请参阅样式选项

值:<HTML color name> | <hex color code>

示例:

lineColor=Black 
fillColor=#9EFFF5
lineWidth²

指定线或面要素的线宽度(以像素为单位)。 此内容仅适用于 Survey123 中的地图预览。

值:<pixels>

例如:

lineWidth=3
map

设置默认底图。

此参数还在 Web 应用程序中受支持。

值:<map name> | <map item ID>

例如:

map="World Topography"
map=de26a3cf4cc9451298ea173c4b324736

mapTools

控制适用于 geopoint、geotrace 和 geoshape 问题的地图工具。

此参数仅适用于外业应用程序。

值:search | mapSwitcher | zoom | home | locate

例如:

mapTools=zoom
mapTools=search,locate

method²

指定捕获方法。 使用折点方法时,可以设置其他参数。

此参数还在 Web 应用程序中受支持。

值:sketch | vertex

仅在外业应用程序中适用的其他折点值:streaming | beep | haptic | edit

例如:

method=vertex
method=vertex,streaming
method=vertex,streaming,haptic
minCaptureZoomLevel

指定可以捕获几何的最低级别。

此参数仅在 Web 应用程序中受支持。

值:<integer>

示例:

minCaptureZoomLevel=17

overlay

在调查中的任何其他 geopoint、geoshape 或 geotrace 问题的重复中显示第一个 geopoint 问题的点位置。 追加属性以定义内容和样式。

值:<repeat name>

属性:view | preview | icon | iconColor | iconOutlineColor | iconSize | label | labelColor | labelOutlineColor | fontSize

例如:

overlay=campsites&preview=true
overlay=hydrants&label=asset_id&icon=hydrant&iconColor=Red

precision

指定将在地图问题中采集的并在调查的单个响应面板中显示的小数位数。 如果未设置此参数,将在地图问题中采集所有可用的小数位数,但是仅在单个响应面板中显示六个小数位。

此参数仅在 Web 应用程序中受支持。

值:<integer>

示例:

precision=4

snapMode

指定捕捉行为。 点可以捕捉到其他要素,而线和面可以捕捉到其他要素或其自身。 仅当 method=vertex 时可用。

此参数仅在 Web 应用程序中受支持。

值:feature | self²

示例:

snapMode=feature
snapMode=self
snapMode=self,feature
symbol¹

指定要用作地图上的点标记的 .png 文件。 追加属性以定义位置和比例。

值:<file name>.png

属性:x | y | scale

示例:

symbol=meter.png?x=0.6&y=0.1&scale=1.5

¹仅受 geopoint 问题类型支持。

²仅受 geoshapegeotrace 问题类型支持。

³仅受 geoshape 问题类型支持。

多项选择问题

下表包含可用于 select_oneselect_multiplerank 问题类型的 XLSForm 参数。 该参数在外业应用程序和 Web 应用程序中受支持。

XLSForm 列参数描述
parametersrandomize

随机化选择列表中的选择顺序。

值:true

示例:

randomize=true

范围

下表包含可用于 range 问题类型的 XLSForm 参数: 这些参数适用于外业应用程序和 Web 应用程序。

XLSForm 列参数描述

body::esri:style

startColor

endColor

color

指定范围起点和终点位置滑块的颜色。 使用 color 参数指定用于填充滑块起点和选定值之间的空间的颜色。 必须使用空格分隔参数。 有关详细信息,请参阅样式选项

值:<HTML color name> | <hex color code>

例如:

startColor=Blue endColor=Red
startColor=Orange endColor=White color=#FF6347
endColor=#262626 color=Yellow

参数

start

end

step

指定范围滑块的起点、终点和步长值。 必须使用空格分隔参数。 有关详细信息,请参阅范围参数

值:<integer> | <decimal>

例如:

start=0 end=50 step=5
start=10.25 end=1 step=0.25

重复

下表包含可用于 begin repeat 问题类型的 XLSForm 参数。 这些参数仅在外业应用程序中受支持。

XLSForm 列参数描述
bind::esri:parametersallowAdds

允许添加新的重复记录。

值:true | false

示例:

allowAdds=true
allowUpdates

允许修改现有的重复记录。

值:true | false

示例:

allowUpdates=false
query

允许在表单中显示现有的重复记录。 指定其他查询参数以过滤可用记录。

值:<none> | "SQL statement"

例如:

query
query="severity='high'"
body::esri:style

backgroundColor

borderColor

设置重复的背景和边框颜色。 有关详细信息,请参阅组、页面和重复颜色

值:<HTML color name> | <hex color code>

例如:

backgroundColor=LightBlue
borderColor=#4682B4
backgroundColor=#C7FFC7 borderColor=#3C6D9E

文本

下表包含可用于 text 问题类型的 XLSForm 参数。 除非说明中另有说明,否则这些参数仅在外业应用程序中受支持。

XLSForm 列参数描述
bind::esri:parametersgeocode

对于具有地理编码外观的 text 问题,将定位器设置为在使用地理编码外观时返回地理编码结果。

此参数还在 Web 应用程序中受支持。

值:<locator item ID>

示例:

geocode=36ff9e8c13e042a58cfce4ad87f55d19

measurement

对于具有测距仪外观的文本问题,设置要在问题中存储的测量值。 如果值包含空格,则将值列表包含在引号内。

值:height | azimuth | horizontalDistance | slopeDistance | inclination | multipleHeights

例如:

measurement=height
measurement=height,azimuth,horizontalDistance
measurement="multipleHeights,Height 1,Height 2"
body::esri:styledefaultHeight

对于具有多行外观的文本问题,请设置文本框的初始高度。 文本框的高度将增加以容纳答案文本。

值:<number of lines>

示例:

defaultHeight=5
indicator

对于具有地理编码外观的文本问题,允许地理编码结果显示相对于当前设备位置的方向和距离。

值:direction | distance | none

例如:

indicator=none
indicator=direction
indicator=direction,distance
maxResults

对于具有地理编码外观的文本问题,指定要返回的最大结果数。 默认值为 6。

值:<number of results>

此参数还在 Web 应用程序中受支持。

示例:

maxResults=10
proximity

对于具有地理编码外观的文本问题,指定地理编码结果是否仅显示设备位置特定半径内的结果。

值:<distance>m | km | ft | mi | yd

例如:

proximity=3km
proximity=1000ft
suggestions

对于具有地理编码外观的文本问题,更改建议的填充方式。 默认设置为是。

值:yes | no

示例:

suggestions=no

测距仪

下表包含可在 textdecimalinteger 问题中用于检索测距仪中的值的 XLSForm 参数。 除非说明中另有说明,否则这些参数仅在外业应用程序中受支持。

XLSForm 列参数描述
bind::esri:parameters

measurement

对于具有测距仪外观的文本问题,设置要在问题中存储的测量值。 如果值包含空格,则将值列表包含在引号内。

值:height | azimuth | horizontalDistance | slopeDistance | inclination | multipleHeights

例如:

measurement=height
measurement=height,azimuth,horizontalDistance
measurement="multipleHeights,Height 1,Height 2"