与其他应用程序相集成—ArcGIS QuickCapture

可使用 QuickCapture 链接或自定义 URL 方案将 ArcGIS QuickCapture 与其他应用程序相集成。两种方法都支持相同的参数，但是方法之间存在与平台相关的差异。

QuickCapture 链接以 https://quickcapture.arcgis.app 开头，并且仅适用于 iOS 和 Android。 QuickCapture 链接遵循由 App Store 和 Google Play 指定的要求，支持链接到更多应用程序，并支持可轻松共享的缩短链接。可以通过 QuickCapture 链接打开的 ArcGIS 应用程序包括 ArcGIS Survey123、ArcGIS Field Maps、ArcGIS Workforce 和 ArcGIS Navigator。

自定义 URL 方案链接以 arcgis-quickcapture:// 开头，并适用于 Windows、Android 以及 iOS 中的选定应用程序组。可以通过 QuickCapture URL 方案打开的 ArcGIS 应用程序包括 Windows 上的 ArcGIS Survey123 和 ArcGIS Collector。自定义 URL 方案链接无法缩短，并且可能在 Android 中打开。假设按超链接格式显示自定义 URL 方案链接，类似于以下内容：

<a href="arcgis-quickcapture://?itemID=36ff9e8c13e042a58cfce4ad87f55d19">Open project</a>

QuickCapture 链接是在应用程序之间进行链接的首选方法，而自定义 URL 方案是共享工程的首选方法。

在使用包含用于在移动应用程序中启动工程的参数的链接之前，建议已在设备上安装该应用程序。

移动应用程序的参数

以下参数可用于自定义打开移动应用程序的方式：


参数	描述	示例	类型
action	指定打开工程的方式。支持的值为 press（按下已识别的按钮）和 field（填充用于按下按钮的字段）。按钮由 GUID 标识，GUID 显示在 QuickCapture 设计器的按钮外观选项卡底部。	要捕获点要素或开始/停止捕获线或面要素：action=press:0c59c9d9-9b51-46b3-bb81-21149e6fddb4 要捕获要素，并将该要素的直径字段填充为 20 的值：action=press:0c59c9d9-9b51-46b3-bb81-21149e6fddb4&field:diameter=20	字符串
callback	指定按下按钮时返回的 URL。	callback=https://survey123.arcgis.app	URL
center	将地图居中到已知纬度、经度和可选高度。	center=37.8199,-122.4783,20	字符串
externalBrowserSignIn	指定使用外部浏览器登录。	externalBrowserSignIn=true	布尔
itemID	指定要打开的工程。	itemID=aabda4a5e36d42c2bcf1c479fe01e5e3	UUID
portalUrl	指定托管 QuickCapture 工程项目的门户 URL。	portalUrl=https://myorg.arcgis.com	字符串
userInput	指定用于填充工程用户输入变量的 ID 和值。	userInput:001=Alice	字符串

从桌面 web 浏览器链接到 QuickCapture

您可以创建链接来打开可嵌入到另一个应用程序中的 QuickCapture 移动应用程序。也可以在 Web 浏览器中输入同一链接进行测试。以下步骤描述了创建自定义 URL 方案并在桌面 web 浏览器中进行使用的方法：

注：

创建链接后，您可以使用 https://quickcapture.arcgis.app 替换 arcgis-quickcapture://，以将其作为 QuickCapture 链接在 iOS 或 Android 上使用。

在您的浏览器中输入 arcgis-quickcapture://。
QuickCapture 移动应用程序随即打开（或提示您打开它）。
注：
要从特定门户启动和下载工程，请包含门户 URL 参数，例如 arcgis-quickcapture://?portalUrl=host.domain.com/webadaptor（其中 host、domain 和 webadaptor 将被替换为您的门户信息）。要使用外部浏览器进行登录，需要包含 externalBrowserSignIn 参数并将其设置为 true，例如 arcgis-quickcapture://?portalUrl=host.domain.com/webadaptor&externalBrowserSignIn=true。

您也可以添加工程的唯一参考，然后将其添加到 URL。首先，您必须确认所要打开的工程的项目 ID。这是 ArcGIS Online 用于唯一标识您的工程的字符串，可以在 ArcGIS Online 中的工程项目 URL 中找到。例如，如果工程 URL 为 https://exampleurl.maps.arcgis.com/home/item.html?id=aabda4a5e36d42c2bcf1c479fe01e5e3，则工程的项目 ID 为 aabda4a5e36d42c2bcf1c479fe01e5e3。

要在您所构建的 URL 中包含您的工程，请将 ?itemID= 和工程的项目 ID 添加到 URL。
您的 URL 应类似于以下内容：
arcgis-quickcapture://?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3
测试 URL 时，它应打开 QuickCapture 移动应用程序并立即打开您的工程。
注：
如果设备中没有该工程，则将下载该工程。

或者，您也可以在其中包含预先确定的工程用户输入变量。

要填充工程用户输入变量，请键入 &userInput: 以及用等号 (=) 分隔的用户输入 ID 和值。

注：
与号 (&) 用作参数分隔符。
每个工程用户输入都有一个唯一 ID。要查看该 ID，请切换到工程的 JSON 视图并搜索 userInputs。每个工程用户输入都被列为一个属性数组；其中的第一个即为 ID。
您的 URL 应类似于以下内容：
arcgis-quickcapture://?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3&userInput:001=Alice
该 URL 将打开 QuickCapture 移动应用程序和您的工程，并且 Alice 的工程用户输入值将用于任何已配置为接收该值的字段中。最多可以将三个工程用户输入值添加到一个工程中。包含多个工程用户输入值的 URL 应类似于以下内容：
arcgis-quickcapture://?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3&userInput:001=Alice&userInput:002=Zone5

还可以将字段的内容从 ArcGIS Web 地图中的弹出窗口传递到 QuickCapture，允许与在 Web 地图中使用弹出窗口的任何 Esri 应用程序相集成。

针对 web 地图中的现有图层，选择配置弹出窗口。在显示下拉菜单中，选择自定义属性显示，然后单击配置并插入指向工程的链接。
要使用从中启动链接的要素的 observer 字段值填充工程用户输入变量，请输入 &userInput:001={observer}；与号 (＆) 用作参数分隔符，大括号 {} 表示字段名称。
您的 URL 应类似于以下内容：
arcgis-quickcapture://?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3&userInput:001={observer}。

从其他应用程序链接到 QuickCapture

您可以创建一个链接，以在其他应用程序中用于启动 QuickCapture 并捕获记录。以下步骤描述了创建 QuickCapture 链接并在 web 地图弹出窗口中使用的方法。此链接将输入到 ArcGIS 组织 web 地图的弹出窗口中。您可以在 iOS 或 Android 设备上使用 web 浏览器（步骤与上述部分类似）来测试此链接。

针对将在设备上查看的 web 地图中的现有图层，选择配置弹出窗口。
在显示下拉菜单中，选择自定义属性显示，然后单击配置并插入指向工程的链接。
对于 URL 参数，输入 https://quickcapture.arcgis.app，对于链接文本，输入启动 QuickCapture，然后单击确定。
1. 通过浏览器或 ArcGIS 应用程序，在移动设备上打开 web 地图。
2. 选择一个要素，然后在弹出窗口中单击启动 QuickCapture 链接以启动 QuickCapture。
要在您所构建的 URL 中包含您的工程，请将 ?itemID= 和工程的项目 ID 添加到 URL。
您的 URL 应类似于以下内容：
```
https://quickcapture.arcgis.app/?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3
```
测试 URL 时，它应打开 QuickCapture 移动应用程序并立即打开您的工程。
注：
如果您的设备尚未安装该工程，则将下载该工程。

或者，您也可以在其中包含预先确定的工程用户输入变量。

要填充工程用户输入变量，请键入 &userInput:id= 以及您要输入的值；与号 (&) 用作参数分隔符。
您的 URL 应类似于以下内容：
https://quickcapture.arcgis.app/?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3&userInput:001=Alice
该 URL 将打开 QuickCapture 移动应用程序和您的工程，并且 Area7 的工程用户输入值将用于任何已配置为接收该值的字段中。

您还可以从 ArcGIS 应用程序将字段的内容传递至工程用户输入变量。

要使用从中启动链接的要素的 workArea 字段值填充工程用户输入变量，请输入 &userInput:001={observer}；与号 (＆) 用作参数分隔符，大括号 {} 表示字段名称。
您的 URL 应类似于以下内容：
https://quickcapture.arcgis.app/?itemID=aabda4a5e36d42c2bcf1c479fe01e5e3&userInput:001={observer}

从 QuickCapture 链接到其他应用程序

通过选择可以打开 URL 的按钮，可以将 QuickCapture 工程配置为打开另一个应用程序，从而为使用 QuickCapture 和其他应用程序的移动工作人员提供灵活顺畅的体验。

要从 QuickCapture 链接到另一个应用程序，您必须通过添加链接按钮并配置链接按钮 URL 来配置工程。在设计器中，您可以配置按钮以打开专用 URL，例如，自定义 URL 或打开另一个 Esri 应用程序的应用程序链接。对于 ArcGIS Survey123 外业应用程序，您还可以浏览并选择调查表，并预定义调查问题的值。

配置链接按钮

要配置启动指向仪表盘的 URL 的按钮，请完成以下步骤：

单击按钮，然后转到链接选项卡。
单击 URL。
输入 https://www.arcgis.com/apps/dashboards/747e7365d1894db4bbadf100f65cf991 作为 URL。

这将创建一个链接按钮，在移动应用程序中选择此按钮时，将启动 QuickCapture BioBlitz 仪表盘。在文本编辑器中，您可以输入任何基于 HTTPS 的 URL，或输入已允许 QuickCapture 的其他应用程序的自定义 URL 方案。

注：

还可以创建链接以启动通信应用程序，例如电子邮件、SMS 和电话。这使用户能够快速访问工程内的帮助。以下是通信应用程序链接的示例：

电子邮件 - mailto:sample@esri.com?subject=Fix%20the%20pipe&body=We%20really%20need%20to%20fix%20the%20pipe
SMS - sms:0291920995（在 Android 上，还可以包含消息正文：sms:0291920995?body=We%20really%20need%20to%20fix%20the%20pipe）
电话 - tel:0291920995

配置 ArcGIS Survey123 按钮

要配置启动 ArcGIS Survey123 外业应用程序的按钮，请完成以下步骤：

单击按钮，然后转到链接选项卡。
单击 Survey123 外业应用程序。
选择要链接到按钮的调查。
此操作定义了 itemID 链接中的 Survey123 参数。
单击添加以添加调查问题并为问题匹配固定值、设备变量或工程用户输入。
此操作定义了 Survey123 链接中指定 field:fieldname 参数的值。重复此步骤以添加所有必需的调查问题。要移除已配置的调查问题，请单击删除按钮。此操作将移除 Survey123 链接中指定的 field:fieldname 参数。
或者，可以启用将位置传递给 Survey123，以在 Survey123 链接中包含带有纬度和经度值的 center 参数。
如果该调查中包含地理点问题，则地图将以从 QuickCapture 传递给它的位置为中心。
可以选择启用返回至 QuickCapture，以在提交调查时将用户重定向到 QuickCapture。
此操作将在 Survey123 链接中添加一个 callback:submit 参数。

设计器将自动构建 Survey123 链接。

您的 URL 应类似于以下内容。此示例包含用于 condition 的固定值，用于 capturetime 的设备变量和用于 username 的工程用户输入。

arcgis-survey123://?itemID=2a41c332e24644ee895bbbd9b929773f&field:condition=damaged&field:capturetime=${captureTime}&field:username=${userInput:001}

或者，您可以通过 URL 选项手动构建 Survey123 链接。在文本编辑器中手动构建 URL，或使用工具栏为 URL 参数添加预定义的值。您可以选择一个固定值、设备变量或工程用户输入变量以添加到 URL。在您构建的 URL 中，变量使用大括号 ({}) 表示，按下按钮时，大括号中的实际值将由移动应用程序自动填充。

当您在 URL 和 Survey123 外业应用程序选项之间切换时，现有 URL 将被丢弃。

有关 Survey123 支持的参数的详细信息，请参阅将 Survey123 与其他应用程序相集成。

注：

为调查问题分配变量时，字段类型必须匹配。

尽管未进行编码的 URL 参数在某些环境中有效，但仍建议您在手动构建 URL 时对 URL 参数进行编码。编码使用百分号 (%) 后跟其等效的十六进制数来替换所有无效的字符。例如，要包括 callback 参数，URL 应类似于以下内容：

arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback:submit=https%3A%2F%2Fquickcapture.arcgis.app%253FitemID%99c18758066b42e1a0f4027603070b34

有关此主题的反馈?