与其他应用程序相集成

ArcGIS Survey123 可以与其他应用程序集成,可以使用链接打开 Survey123 Web 应用程序或外业应用程序、Survey123 Connect 或其他应用程序。 例如,您可以创建应用程序链接并从其他 Survey123 应用程序、Web 地图弹出窗口或电子邮件或网站中的快捷超链接启动并打开 Esri 外业应用程序。 您可以使用 URL 自动下载并打开调查,以在 Survey123 Connect 中执行编辑。 您也可以从 Survey123 链接到其他应用程序,例如 ArcGIS QuickCaptureArcGIS Field Maps

使用表中的 URL 模式创建链接,以从 Web 浏览器或其他应用程序进行访问。

要启动什么从何处链接要使用的 URL 模式

Web 应用程序

Web 浏览器

按 ID 确定的调查表单:

https://survey123.arcgis.com/share/ID

外业应用程序

AndroidiOS

Survey123 应用程序链接

https://survey123.arcgis.app

WindowsAndroidiOS 上的一组选定的应用程序

自定义 URL 方案:

arcgis-survey123://

Survey123 Connect

Windows

自定义 URL 方案:

arcgis-survey123connect://

其他应用程序

调查表单

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 StoreGoogle 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 ArcadeUrlEncode 函数用于定义键值对的集合,这些键值对可表示每个参数,并使用相应编码生成 URL。

调查作者可能还希望遮盖 URL 参数,以使敏感数据在 URL 中不可见。 在这种情况下,当您创建要在 web 应用程序中使用的 URL 时,请包含 encodeUrlParams=true。 有关详细信息,请参阅用于打开 Web 应用程序的 URL 参数


在本主题中
  1. URL 参数
  2. URL 编码