ArcGIS Survey123 可以与其他应用程序集成,可以使用链接打开 Survey123 Web 应用程序或外业应用程序、Survey123 Connect 或其他应用程序。 例如,您可以创建应用程序链接并从其他 Survey123 应用程序、Web 地图弹出窗口或电子邮件或网站中的快捷超链接启动并打开 Esri 外业应用程序。 您可以使用 URL 自动下载并打开调查,以在 Survey123 Connect 中执行编辑。 您也可以从 Survey123 链接到其他应用程序,例如 ArcGIS QuickCapture 和 ArcGIS Field Maps。
使用表中的 URL 模式创建链接,以从 Web 浏览器或其他应用程序进行访问。
要启动什么 | 从何处链接 | 要使用的 URL 模式 |
---|---|---|
Web 应用程序 | Web 浏览器 | 按 ID 确定的调查表单:
|
外业应用程序 | Android 和 iOS | Survey123 应用程序链接
|
Windows、Android、iOS 上的一组选定的应用程序 | 自定义 URL 方案:
| |
Survey123 Connect | Windows | 自定义 URL 方案:
|
其他应用程序 | 调查表单 | Survey123 的链接:因应用程序而异 |
以下示例显示了如何使用这些 URL 模式打开特定调查:
- https://survey123.arcgis.com/share/36ff9e8c13e042a58cfce4ad87f55d19
- https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19
- arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19
- arcgis-survey123connect://?portalUrl=https://www.arcgis.com&itemID=36ff9e8c13e042a58cfce4ad87f55d19
Survey123 应用程序链接遵循由 App Store 和 Google Play 设置的要求,支持链接到更多应用程序,且支持可轻松共享的短链接。
自定义 URL 方案链接无法缩短,并且可能在 Android 中打开。 假设按超链接格式显示自定义 URL 方案链接,类似于以下内容:
<a href="arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19">Open survey</a>
URL 参数
您可以将 URL 参数添加到链接的末尾,从而进一步自定义应用程序的打开方式。 例如,您可以设置 geopoint 问题的默认位置,或填充文本问题。
URL 参数以字符 ? 开头,并使用字符 & 分隔。 以下示例显示了一个自定义 URL 方案,其中第一个参数 (itemID) 以字符 ? 开头,后续字段参数(color_1 和 color_2)则使用字符 & 分隔。
arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:color_1=red&field:color_2=blue
有关更多示例 URL 和支持的 URL 参数,请参阅启动 Web 应用程序、启动外业应用程序、启动 Survey123 Connect和通过 Survey123 启动其他应用程序。
注:
在使用包含用于在外业应用程序中启动调查的参数的链接之前,建议已在设备上安装该应用程序。 有关详细信息,请参阅安装 Survey123 外业应用程序。
URL 编码
尽管未进行编码的 URL 参数在某些环境中有效,但仍建议您对 URL 参数进行编码。 编码使用百分号 (%) 后跟其等效的十六进制数来替换所有无效的字符。
例如,以下 Survey123 链接使用回调以返回到 QuickCapture 中的特定工程,其中参数未被编码:
https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https://quickcapture.arcgis.app?itemID=867895a71a1840399476fc717e76bb43
以下是具有编码参数的相同 URL:
https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https%3A%2F%2Fquickcapture.arcgis.app%3FitemID=867895a71a1840399476fc717e76bb43
不应对等号进行编码,等号用于指定键与其值之间的中断。
提示:
创建编码参数的一种方法是使用 ArcGIS Arcade。 UrlEncode 函数用于定义键值对的集合,这些键值对可表示每个参数,并使用相应编码生成 URL。
调查作者可能还希望遮盖 URL 参数,以使敏感数据在 URL 中不可见。 在这种情况下,当您创建要在 web 应用程序中使用的 URL 时,请包含 encodeUrlParams=true。 有关详细信息,请参阅用于打开 Web 应用程序的 URL 参数。