与其他应用程序相集成

ArcGIS Survey123 可通过使用链接启动特定组件应用程序来与其他应用程序集成。 例如,您可以创建应用程序链接并从其他 Esri 应用程序、Web 地图弹出窗口或电子邮件或网站中的简单超链接启动并打开 Survey123 Mobile。 您可以使用 URL 自动下载并打开调查,以在 Survey123 Connect 中执行编辑。

您也可以从 Survey123 链接到其他应用程序,例如 ArcGIS QuickCaptureArcGIS Field Maps

提示:

Survey123 Mobile 为三个应用程序打开链接:Survey123 MobileSurvey123 外业应用程序和 QuickCapture。 当这些链接中的任何一个从 Survey123 Mobile 内启动时(通过使用链接扫描二维码,或从调查或 QuickCapture 工程中的链接启动),它们将在 Survey123 Mobile 内打开。 有关详细信息,请参阅打开内容

使用表中的 URL 模式创建链接,以从 Web 浏览器或其他应用程序进行访问。 所含示例显示了如何使用这些 URL 模式打开特定调查。

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

Android

iOS

Survey123 应用程序链接1

https://survey123-mobile.arcgis.app

示例:

https://survey123-mobile.arcgis.app?itemID=e1c38715587b4e4faf1e419090c25270

Windows

Android

iOS2

自定义 URL 方案3

arcgis-survey123-mobile://

示例:

arcgis-survey123-mobile://?itemID=e1c38715587b4e4faf1e419090c25270

Web 应用程序

Web 浏览器

按 ID 确定的调查表单:

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

示例:

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

外业应用程序

Android

iOS

Survey123 应用程序链接1

https://survey123.arcgis.app

示例:

https://survey123.arcgis.app?itemID=e1c38715587b4e4faf1e419090c25270

Windows

Android

iOS2

自定义 URL 方案3

arcgis-survey123://

示例:

arcgis-survey123://?itemID=e1c38715587b4e4faf1e419090c25270
Survey123 Studio

Windows

自定义 URL 方案3

arcgis-survey123-studio://

示例:

arcgis-survey123-studio://?portalUrl=https://www.arcgis.com%26itemID=e1c38715587b4e4faf1e419090c25270

Survey123 Connect

Windows

自定义 URL 方案3

arcgis-survey123connect://

示例:

arcgis-survey123connect://?portalUrl=https://www.arcgis.com%26itemID=e1c38715587b4e4faf1e419090c25270

其他应用程序

调查表单

Survey123 的链接:因应用程序而异

1 - Survey123 应用程序链接遵循由 App StoreGoogle Play 设置的要求,支持链接到更多应用程序,且支持可轻松共享的短链接。

2 - 在 iOS 设备上,自定义 URL 方案仅被批准用于特定的应用程序组

3 - 自定义 URL 方案链接无法缩短,并且可能难以在 Android 中打开。 假设按超链接格式显示自定义 URL 方案链接,类似于以下内容:

<a href="arcgis-survey123-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19">Open survey</a>

URL 参数

您可以将 URL 参数添加到链接的末尾,从而进一步自定义应用程序的打开方式。 例如,您可以设置 geopoint 问题的默认位置,或填充文本问题。

URL 参数以字符 ? 开头,并使用字符 & 分隔。 以下示例显示了一个自定义 URL 方案,其中第一个参数 (itemID) 以字符 ? 开头,后续字段参数(color_1 和 color_2)则使用字符 & 分隔。

arcgis-survey123-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:color_1=red&field:color_2=blue

有关更多示例 URL 和支持的 URL 参数,请参阅启动 Survey123 Mobile要素函数 | ArcGIS Arcade | Esri 开发者启动 Web 应用程序启动外业应用程序启动 Survey123 Connect通过 Survey123 启动其他应用程序

注:

在使用包含用于在 Survey123 Mobile 或外业应用程序中启动调查的参数的链接之前,建议已在设备上安装该应用程序。 有关详细信息,请参阅安装 ArcGIS Survey123

URL 编码

尽管未进行编码的 URL 参数在某些环境中有效,但仍建议您对 URL 参数进行编码。 编码使用百分号 (%) 后跟其等效的十六进制数来替换所有无效的字符。

例如,以下 Survey123 链接使用回调以返回到 QuickCapture 中的特定工程,其中参数未被编码:

https://survey123-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https://quickcapture.arcgis.app?itemID=867895a71a1840399476fc717e76bb43

以下是具有编码参数的相同 URL:

https://survey123-mobile.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 编码