启动 web 应用程序

Survey123 Web 应用程序可以接受格式与外业应用程序相同的参数。需要注意的一个区别是,调查的项目 ID 是 URL 路径的一部分,而不是像其他用于打开调查的链接那样,使用项目 ID 作为 URL 参数。 将参数添加到此 URL 时,必须使用问号将路径中的调查项目 ID 与第一个参数分隔开,然后使用与号分隔后续参数。 以下示例 URL 将姓氏和坐标参数传递到 Survey123 web 应用程序中的调查。

https://survey123.arcgis.com/share/36ff9e8c13e042a58cfce4ad87f55d19?field:surname=Klauser&center=37.8199,-122.4783

Survey123 web 应用程序还支持 Survey123 外业应用程序不支持的许多参数。 这些参数与浏览器中的调查演示有关。 要了解 URL 参数和自定义 Web 应用程序打开方式的示例,请参阅下表。

注:

如果参数值包含空格、加号 (+) 或其他特殊字符,应对这些字符应进行百分比编码。 有关详细信息,请参阅 URL 编码

用于启动 Web 应用程序的 URL 参数

参数描述类型

signIn

对于公共调查,将显示登录按钮或者要求用户进行登录。 默认情况下,web 应用程序不会为用户提供登录公共调查的方法,但公共调查可以包含仅当用户登录后才能使用的功能。 例如使用计算以提取登录用户的电子邮件地址。 有效值为 show:将在 web 应用程序顶部的导航栏中显示登录按钮;以及 require:要求用户通过重定向至登录页面进行登录。

示例:

signIn=show

字符串

isOrgSignIn

使用组织特定登录页面。 默认情况下,Survey123 使用组织特定登录页面,但是当将调查共享到多个组织时,可能首选使用 ArcGIS Online 登录页面。 将此参数设置为 false 可使用 ArcGIS Online 登录页面。

示例:

isOrgSignIn=false

布尔

center

将地图居中到已知纬度、经度和可选高度。

示例:

center=37.8199,-122.4783,20

字符串

field:fieldname

使用字段值填充调查问题。

示例:

 field:surname=Klauser

字符串

portalUrl

指定托管调查项目的门户 URL。

示例:

portalUrl=https://myorg.arcgis.com

字符串

open

指定用于打开调查的应用程序。 有效值为 web(默认值)(将在 Web 应用程序中打开调查);native(如果已安装外业应用程序,则将在外业应用程序中打开调查);以及 menu(将打开 web 页面以确定将打开调查的应用程序)。

示例:

open=web

字符串

hide

在 web 应用程序中隐藏调查的元素。 此参数可以接受多个以逗号分隔的值。 有效值为 navbar(调查顶部的栏,其中包括登录、登出和更改语言的选项)、headerdescriptionfootersubmitthemeleaveDialog(离开或关闭页面时显示的警告消息)。 您还可以使用 field:fieldName 参数,以通过提供代替 fieldName 的名称来隐藏特定问题、群组、页面或重复。 重复中的问题无法单独隐藏。

示例:

hide=header,description,footer,theme

字符串

locale

切换调查的语言。 仅当调查包含多种语言时才有效。

示例:

locale=zh-cn

字符串

mode

设置 web 应用程序的模式。有效值为 edit(将您的调查设置为编辑现有条目,而非创建条目)、view(将以只读模式打开现有条目)和 copy(将创建使用指定条目填充的调查)。 在使用此参数时,还必须提供 globalId 参数。

示例:

mode=edit&globalId=1d392670-33e2-456d-8435-7fad3abd8bb9

字符串

globalId

用于指定加载到表单中的调查记录。 有效值是现有调查记录的全局 ID。 此参数的名称区分大小写。

示例:

globalId=1d392670-33e2-456d-8435-7fad3abd8bb9

字符串

recalculate

只能与 mode=edit 配合使用。 在加载调查时,将强制重新计算指定的问题,而不使用重新计算按钮。

示例:

recalculate=field:question1,field:question2

字符串

version

设置将使用的 web 应用程序的版本。 唯一的有效值为 latest,将使用最新版本的 web 应用程序,即使调查为版本锁定时也是如此。

示例:

version=latest

字符串

token

传递调查的有效令牌。 可用于允许调查对象响应需要 ArcGIS 账户才能进行访问的调查,而无需进行登录。

示例:

token=E60M4Gsc-h4Q8plqQ...

字符串

autoReload

提交后重新加载调查。 指定重新加载调查之前的延迟(以秒为单位)。 此参数之前称为 autoRefresh。 考虑到向后兼容性,仍然支持 autoRefresh 参数。

示例:

autoReload=3

整型

encodeUrlParams

模糊 URL 参数。 生成的 URL 将包含代表所有编码参数的 code 参数;包含在此 code 参数之外的参数将被忽略。

示例:

encodeUrlParams=true

布尔

width

以像素为单位或者以屏幕宽度的分数形式设置调查的宽度。 大于 1 的值将以像素为单位设置宽度。 如果像素值小于屏幕宽度,则使用屏幕宽度。 介于 0 和 1 之间的值将以屏幕宽度的分数形式设置表单的宽度。 此设置还会影响调查中的其他控件,例如文本框,并且可以帮助改进 web 应用程序显示固定或动态格网的方式。

例如:

width=1000
width=600px
width=0.5

字符串

注:

在 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