Survey123 Web 应用程序可以接受格式与外业应用程序相同的参数。需要注意的一个区别是,调查的项目 ID 是 URL 路径的一部分,而不是像其他用于打开调查的链接那样,使用项目 ID 作为 URL 参数。 将参数添加到此 URL 时,必须使用问号将路径中的调查项目 ID 与第一个参数分隔开,然后使用与号分隔后续参数。 以下示例 URL 将姓氏和坐标参数传递到 Survey123 web 应用程序中的调查。
https://survey123.arcgis.com/share/36ff9e8c13e042a58cfce4ad87f55d19?field:surname=Klauser¢er=37.8199,-122.4783
Survey123 web 应用程序还支持 Survey123 外业应用程序不支持的许多参数。 这些参数与浏览器中的调查演示有关。 要了解 URL 参数和自定义 Web 应用程序打开方式的示例,请参阅下表。
注:
如果参数值包含空格、加号 (+) 或其他特殊字符,应对这些字符应进行百分比编码。 有关详细信息,请参阅 URL 编码。
用于启动 Web 应用程序的 URL 参数
参数 | 描述 | 类型 |
---|---|---|
isOrgSignIn | 使用组织特定登录页面。 默认情况下,Survey123 使用组织特定登录页面,但是当将调查共享到多个组织时,可能首选使用 ArcGIS Online 登录页面。 将此参数设置为 false 可使用 ArcGIS Online 登录页面。 示例:
| 布尔 |
center | 将地图居中到已知纬度、经度和可选高度。 示例:
| 字符串 |
field:fieldname | 使用字段值填充调查问题。 示例:
| 字符串 |
portalUrl | 指定托管调查项目的门户 URL。 示例:
| 字符串 |
open | 指定用于打开调查的应用程序。 有效值为 web(默认值)(将在 Web 应用程序中打开调查);native(如果已安装外业应用程序,则将在外业应用程序中打开调查);以及 menu(将打开 web 页面以确定将打开调查的应用程序)。 示例:
| 字符串 |
hide |
在 web 应用程序中隐藏调查的元素。 此参数可以接受多个以逗号分隔的值。 有效值为 navbar(调查顶部的栏,其中包括登录、登出和更改语言的选项)、header、description、footer、submit、theme 和 leaveDialog(离开或关闭页面时显示的警告消息)。 您还可以使用 field:fieldName 参数,以通过提供代替 fieldName 的名称来隐藏特定问题、群组、页面或重复。 重复中的问题无法单独隐藏。 示例:
| 字符串 |
locale | 切换调查的语言。 仅当调查包含多种语言时才有效。 示例:
| 字符串 |
mode | 设置 web 应用程序的模式。有效值为 edit(将您的调查设置为编辑现有条目,而非创建条目)、view(将以只读模式打开现有条目)和 copy(将创建使用指定条目填充的调查)。 在使用此参数时,还必须提供 globalId 参数。 示例:
| 字符串 |
globalId | 用于指定加载到表单中的调查记录。 有效值是现有调查记录的全局 ID。 此参数的名称区分大小写。 示例:
| 字符串 |
recalculate | 只能与 mode=edit 配合使用。 在加载调查时,将强制重新计算指定的问题,而不使用重新计算按钮。 示例:
| 字符串 |
version | 设置将使用的 web 应用程序的版本。 唯一的有效值为 latest,将使用最新版本的 web 应用程序,即使调查为版本锁定时也是如此。 示例:
| 字符串 |
token | 传递调查的有效令牌。 可用于允许调查对象响应需要 ArcGIS 帐户才能进行访问的调查,而无需进行登录。 示例:
| 字符串 |
autoReload | 提交后重新加载调查。 指定重新加载调查之前的延迟(以秒为单位)。 此参数之前称为 autoRefresh。 考虑到向后兼容性,仍然支持 autoRefresh 参数。 示例:
| 整型 |
encodeUrlParams | 模糊 URL 参数。 生成的 URL 将包含代表所有编码参数的 code 参数;包含在此 code 参数之外的参数将被忽略。 示例:
| 布尔 |
width | 设置调查宽度,以像素为单位。 此设置还会影响调查中的其他控件,例如文本框。 示例:
| 整型 |
注:
在 Web 应用程序中,field:fieldname 参数支持地理点、geotrace 和 geoshape 问题。 对于地理点问题,请指定以空格分隔的纬度、经度和高度(可选)。 对于 geotrace 和 geoshape,请为每个折点指定以空格分隔的纬度和经度,并以分号分隔每对坐标。 此示例适用于 geoshape 问题:
field:geoshape=-37.842156723211474 144.95942945338243;-37.83554486071995 144.9726235713864;-37.85681405373047 144.98240735651922;-37.85954045531896 144.97715349053766