将 Survey123 与 ArcGIS Enterprise 配合使用

可将 Survey123ArcGIS Enterprise 配合使用,该产品允许组织在其自己的基础架构内托管 ArcGIS 功能,包括以下两种方式:

  • 使用 ArcGIS Enterprise 凭据并指定门户 URL 以登录到 https://survey123.arcgis.com 网站。 这不需要系统管理员进行额外的网站设置,并将确保 Survey123 的所有功能都可供使用。
  • 让系统管理员在部署 ArcGIS Enterprise 的同时安装 Survey123 网站。 这是支持断开连接的环境或允许组织留在网站的指定版本上的必需内容。

根据 ArcGIS Enterprise 部署中 Portal for ArcGIS 的配置方式,Survey123 的使用方式和可用功能有所不同。 下表列出了位于防火墙后面和暴露于 Web 的门户安装之间的差异。 要了解有关门户部署选项的详细信息,请参阅规划您的 Portal for ArcGIS 配置

Portal for ArcGIS 位置survey123.arcgis.com 网站安装的网站

防火墙后面

  • 网站不在您的域中
  • 需要 URL 参数才能登录
  • 无法生成 Survey123 报表
  • 始终拥有最新版本的 Survey123 网站
  • 网站在您的域中
  • 不需要 URL 参数即可登录
  • 无法生成 Survey123 报表
  • 可以留在固定版本的 Survey123 网站上

暴露于 Web

  • 网站不在您的域中
  • 需要 URL 参数才能登录
  • 可以生成 Survey123 报表
  • 始终拥有最新版本的 Survey123 网站
  • 网站在您的域中
  • 不需要 URL 参数即可登录
  • 无法生成 Survey123 报表
  • 可以留在固定版本的 Survey123 网站上

在大多数情况下,ArcGIS OnlineArcGIS Enterprise 中的 Survey123 的功能是相同的,但是,也存在例外。 本主题的其余部分介绍了 Survey123ArcGIS Enterprise 配合使用时的要求和行为。

安装

要将 Survey123ArcGIS Enterprise 配合使用,需要基础 ArcGIS Enterprise 部署,且唯一的 ArcGIS Enterprise 门户 URL 必须可用。 有关详细信息,请参阅安装和部署 ArcGIS Enterprise

默认情况下,ArcGIS Server 允许跨域请求,因此 JavaScript 客户端可从任意域调用服务器服务。 但是,如果 ArcGIS Server 已配置为仅信任特定域,则必须确保 https://survey123.arcgis.com/ 为受信任的域。 如果该域不受信任,则 Survey123 网站将无法检索数据,并且您将收到错误消息。 有关详细信息,请参阅限制对 ArcGIS Server 的跨域请求

要在 Survey123 ConnectSurvey123 外业应用程序中登录门户,请选择登录屏幕右上角的设置。 应用程序之前登录的所有门户均列在连接页面上。 如果您之前未登录任何门户,则唯一的预定义选项将为 ArcGIS Online。 要添加门户,请选择添加连接。 键入组织的门户 URL,然后选择添加。或者,启用使用外部浏览器登录以在外部浏览器中启动登录屏幕。 选择左上角的返回按钮,以使用您的组织凭据进行登录。

要在 Survey123 网站中登录门户,请在浏览器中浏览至以下 URL,并将提供的示例门户替换为您自己的门户 URL:

https://survey123.arcgis.com/?portalUrl=https://exampleportal.esri.com/arcgis

Survey123 网站随即打开,顶栏中显示的消息会列出您的门户 URL。 使用您的门户凭据登录到网站。 网站将显示门户中的现有调查,您可以创建新调查。 单击顶部栏中的重置按钮将 Survey123 网站重新连接到 ArcGIS Online

要将 Survey123 Connect 配置为使用本地安装的 API,请单击设置下的服务,然后提供安装的 URL,例如 https://yourMachine.domain.com:5443/api。 通过使用 web 调试代理服务器应用程序(例如,FiddlerCharles),然后观察运行 Survey123 Connect 的计算机发送的请求,可以验证 Survey123 Connect 是否使用本地安装的 API。 您现在应该看到 xls2xform 请求转至您的计算机,而非 https://survey123.arcgis.com

要求

ArcGIS Survey123 可与使用基础部署配置的 ArcGIS Enterprise 10.7.1 或更高版本配合使用。

ArcGIS 组织中有多种用户类型和角色可以访问不同的 ArcGIS Survey123 功能。 您也可以使用 ArcGIS 角色来限制最初包含在用户类型中的权限。 例如,如果为 Creator 用户类型分配用户角色,则会撤消其发布要素图层的权限。 同样,如果为 Mobile Worker 用户类型分配 Viewer 角色,则其权限将与 Viewer 用户类型的权限类似。 有关详细信息,请参阅 ArcGIS Enterprise 用户类型、角色和权限

下表将介绍每种用户类型可以在 ArcGIS Enterprise 中访问的 Survey123 功能:

ArcGIS Enterprise 11.4 及更高版本

用户类型Survey123 web 应用程序中填写调查Survey123 外业应用程序中填写调查Survey123 网站中分析结果Survey123 网站中创建调查Survey123 Connect 中创建调查

Professional Plus

Professional

Creator

Mobile Worker

Contributor

Viewer

1

2

无(匿名)

3

3

4

1 - 仅适用于公共调查。

2 - 查看者可以在 Survey123 网站中生成报告,但报告文件不会存储在其 ArcGIS 账户中。

3 - 仅适用于公共调查。 可以在 web 应用程序和外业应用程序中完成公共调查,并且无需 ArcGIS 账户。

4 - 必须与所有人(公共)共享调查结果。

ArcGIS Enterprise 11.3 及更低版本

用户类型Survey123 web 应用程序中填写调查Survey123 外业应用程序中填写调查Survey123 网站中分析结果Survey123 网站中创建调查Survey123 Connect 中创建调查

GIS Professional(Basic、Standard 和 Advanced)

Creator

Mobile Worker

Editor

1

Viewer

2

3

无(匿名)

4

4

5

1 - 必须分配外业应用程序或 Survey123 附加许可。

2 - 仅适用于公共调查。

3 - 查看者可以在 Survey123 网站中生成报告,但报告文件不会存储在其 ArcGIS 账户中。

4 - 仅适用于公共调查。 可以在 web 应用程序和外业应用程序中完成公共调查,并且无需 ArcGIS 账户。

5 - 必须与所有人(公众)共享调查结果。

注:

需要使用 ArcGIS Enterprise 11.1 或更高版本,才能在您的基础架构上安装最新的 Survey123 网站。

最新版本为 3.20.1。

对于以下版本的 ArcGIS Enterprise,建议安装相应版本的 Survey123 网站:

ArcGIS Enterprise 版本Survey123 网站安装程序版本

11.0

3.19.1

10.9.1

3.18

10.9

3.15

10.8.1

3.13

10.7.1

3.12

通常,较新版本的 Survey123 网站安装程序可以与较早版本的 ArcGIS Enterprise 兼容安装。 然而,当在 Survey123 网站中使用依赖较新版本 ArcGIS Enterprise 的新功能时,您可能会收到错误或警告消息。

如果在独立的 Web 服务器上进行安装,则需要遵守与 WindowsLinux 上的 ArcGIS Enterprise 11.1 相同的操作系统和硬件要求,但 SUSE Linux Enterprise Server 12 和 Ubuntu Server 18.04 LTS 例外,它们不兼容。

局限性

与发布至 ArcGIS Enterprise 的调查不同,发布至 ArcGIS Online 的调查具有以下列出的限制。

要素图层限制

要素图层的限制包括以下内容:

  • 您无法将调查发布至 ArcGIS Enterprise,该产品将某些保留关键字用作字段名称,例如 end(如果字段名称不完全是关键字,则包含这些关键字的字段名称是可以接受的,例如 endSurvey)。 将在 Survey123 XLSForm 模板的 Reserved 工作表中列出保留关键字。
  • 发布到 ArcGIS Enterprise 时,所有字段名称必须为小写。
  • 发布到门户的要素图层可以包含的最大列数取决于企业级地理数据库。 请参阅数据库管理系统的文档以确定大小限制。 如果您调查中的问题数量超过了企业级地理数据库的列数限制,解决办法将是包含重复,并将 repeat_count 设置为 1 以将调查扩展到多个表。
  • 调查工作表中问题名称必须小于 32 个字符。
  • 如未使用 ArcGIS Data Store,则无法将 Survey123 内容上传至 ArcGIS EnterprisePortal for ArcGIS
  • 如果在断开连接的环境中部署 ArcGIS Enterprise,则调查模板、示例和至 ArcGIS Online 要素图层的提交 URL 将无效。
  • 提交 URL 无法直接与非联合的 ArcGIS Server 要素图层配合使用。 解决方法请参阅将服务注册到 ArcGIS OnlineArcGIS Enterprise
  • 如果使用多用户地理数据库,则图层可以使用分支版本化,但不可以使用传统版本化。 Survey123 将在使用分支版本化地理数据库时将默认版本作为目标版本。 有关详细信息,请参阅版本化类型
  • esriFieldTypeDateOnlyesriFieldTypeTimeOnlyesriFieldTypeTimestampOffsetesriFieldBigInteger 仅可用于 ArcGIS Online。 这些字段类型可用于 ArcGIS Enterprise 11.2 及更高版本。

Survey123 网站限制

Survey123 网站的限制包括以下内容:

  • 使用报告模板打印不可与未面向公众部署的 ArcGIS Enterprise 配合使用。 尝试执行此操作将显示 getaddrinfo ENOTFOUND 错误。
  • 使用报告模板进行打印不适用于使用集成 Windows 身份验证 (IWA) 的 ArcGIS Enterprise 部署。
  • 使用借助 IWA 的 ArcGIS Enterprise 部署时,无法通过 Microsoft Edge 上的 Web 应用程序访问公开共享的调查。
  • 使用借助 IWA 的 ArcGIS Enterprise 部署时,无法在 Safari 中访问 Survey123 网站。 解决方法是在您的基础架构上安装 Survey123 网站,然后使其与门户使用的 ArcGIS Web Adaptor 位于同一 Web 服务器上。
  • 已提交至要素图层的图像、音频和文件附件未链接到在 ArcGIS Enterprise 10.8.1 之前版本中将其提交到的问题。
  • 您的调查结果无法导出为 KML 格式。
  • Survey123 网站安装在您的基础架构上时,无法使用报告 API。 仅当使用 https://survey123.arcgis.com/ 时,才可以生成报告。
  • 当已安装的 Survey123 网站所用版本为 3.18 或较早版本时,无法导出和导入翻译。

Mobile Devices 和 ArcGIS Enterprise

有关 ArcGIS 组件可用的安全性功能和当前最佳做法的概述,请参阅 ArcGIS 安全性