安装 ArcGIS Survey123

通常,您需要安装两个 ArcGIS Survey123 组件:在桌面上安装 Survey123 Studio 或 Survey123 Connect 以创建调查,以及在设备上安装 Survey123 Mobile 或 Survey123 外业应用程序以采集调查数据。

Survey123 网站(包含 Web 设计器和 Web 应用程序)无需安装即可使用;但某些组织可能会选择将 Survey123 网站与 ArcGIS Enterprise 部署一同安装,以支持断开连接的环境。

安装 Survey123 Studio

可以从 Microsoft 商店中获取 Survey123 Studio。 可通过该商店直接在设备上安装 Survey123 Studio。

您也可以从 Survey123 下载页面下载 Windows 的 Survey123 Studio 安装文件。

要仅为当前用户安装下载文件,请双击该文件,然后单击安装。 如果已安装先前版本的 Survey123 Studio,系统会提示您单击更新。 如果您需要为计算机上的所有用户安装该应用程序,可以使用 Microsoft PowerShell 的 Add-ProvisionedAppPackage 命令。

在 Windows 上,应用程序文件位于以下位置:C:\Program Files\WindowsApps。 通常,您不需要浏览这些文件。 如果要卸载 Survey123 Studio,请单击设置 > 应用程序 > 已安装的应用程序 > ArcGIS Survey123 Studio,然后选择卸载。

调查数据文件位于 Windows 上的以下位置:C:\Users\<username>\Documents\ArcGIS\Survey-Studio。

注:

Survey123 Studio 可与 Survey123 Connect 并行安装。

安装 Survey123 Mobile

Survey123 Mobile 应用程序可在 Google Play、App Store 以及 Microsoft Store 中获取。 可通过这些商店直接在设备上安装 Survey123 Mobile。

您也可以从 Survey123 下载页面下载 Windows 或 Android 的 Survey123 Mobile 安装文件。

在 Windows 上,要仅为当前用户安装下载文件,请双击该文件,然后单击安装。 如果已安装先前版本的 Survey123 Mobile,系统会提示您单击更新。 如果您需要为计算机上的所有用户安装该应用程序,可以使用 PowerShell 的 Add-ProvisionedAppPackage 命令。

在 Android 上,您必须首先在 Windows 上运行桌面可执行文件以获取 APK 文件。 然后可以将 APK 文件复制到 Android 设备进行安装,或使用 MDM 进行安装。

在 Windows 上,应用程序文件位于以下位置:C:\Program Files\WindowsApps。 通常,您不需要浏览这些文件。 如果要卸载 Survey123 Mobile,请单击设置 > 应用程序 > 已安装的应用程序 > ArcGIS Survey123 Mobile,然后选择卸载。

调查数据文件位于以下位置:

  • Windows - C:\Users\<username>\Documents\ArcGIS\Survey123-Mobile
  • Android - Android/data/com.esri.survey123.mobile/files(设备必须连接到台式 PC,并且必须使用 PC 文件浏览器才能找到这些文件。)
注:

在 iOS 上无法访问数据文件,因为该应用程序出于隐私考虑未请求访问本地文件的权限。

Survey123 Mobile 可与 Survey123 外业应用程序并行安装。

安装 Survey123 Connect

可以从 Microsoft 商店中获取 Survey123 Connect。 可通过该商店直接在设备上安装 Survey123 Connect。

您也可以从 Survey123 下载页面下载 Windows 的 Survey123 Connect 安装文件。

要安装 Survey123 Connect,请双击文件进行安装,然后执行以下操作:

  1. 单击下一步。
  2. 选择安装文件夹(默认为首选项)。
  3. 接受许可协议。
  4. 命名在开始菜单中显示的名称。
  5. 单击安装。

在 Windows 上,应用程序文件位于以下位置:C:\Users\<username>\Applications\ArcGIS\ArcGISSurvey123Connect。

通常,您不需要编辑这些文件。 如果想要卸载 Survey123 Connect,可浏览至上述文件夹并选择卸载 ArcGISSurvey123Connect。

调查数据文件位于以下位置:C:\Users\<username>\ArcGIS\My Survey Designs。

注:
如果已安装先前版本的 Survey123 Connect,系统会提示您是否要继续。

安装 Survey123 外业应用程序

Survey123 外业应用程序可在 Google Play、App Store 以及 Microsoft Store 中获取。 可通过这些商店直接在设备上安装 Survey123。

您也可以从 Survey123 下载页面下载适用于 Windows 和 Android 的 Survey123 外业应用程序安装文件,并以与 Survey123 Connect 相同的方式进行安装。

安装完成后,将创建名为 Survey123 的桌面快捷方式。 台式机上所有 Survey123 外业应用程序文件的安装位置均与 Survey123 Connect 相同。

调查数据文件位于以下位置:

  • Windows - C:\Users\<username>\ArcGIS
  • iOS - On My iPad/Survey123/ArcGIS 或 On My iPhone/Survey123/ArcGIS
  • Android - Android/data/com.esri.survey123/files/ArcGIS(设备必须连接到台式 PC,并且必须使用 PC 文件浏览器才能找到这些文件。)
注:
在 Windows 上,如果已安装先前版本的 Survey123 外业应用程序,系统会提示您是否要继续。 在 Android 和 iOS 上,先前版本的 Survey123 外业应用程序将被自动覆盖。

无人值守的安装和卸载

Survey123 Studio 和 Survey123 Mobile 可以使用 PowerShell 命令进行安装和卸载。

Survey123 Connect 和 Survey123 外业应用程序可以使用提供的脚本文件进行安装和卸载。

Survey123 Studio 和 Survey123 Mobile

对于 Windows 系统,Survey123 Studio 和 Survey123 Mobile 将以 MSIX 文件的形式提供,您可以使用以下 PowerShell 命令进行安装和卸载。

如需进行安装(假设文件名是您下载的文件),请使用 Add-AppxPackage -Path "C:\Downloads\Survey123-Mobile_x64_26.1.0.100.msix"。

如需卸载,请使用以下命令:

  • Survey123 Studio - Get-AppxPackage -Name "Esri.ArcGISSurvey123Studio*" | Remove-AppxPackage
  • Survey123 Mobile - Get-AppxPackage -Name "Esri.ArcGISSurvey123Mobile*" | Remove-AppxPackage

Survey123 Connect 和 Survey123 外业应用程序

当您在 Windows 上安装 Survey123 Connect 或 Survey123 外业应用程序时,还会为您提供脚本文件来帮助执行未来的无人值守安装或卸载。

为准备这些操作,请在一台设备上首次安装应用程序,然后完成以下步骤(以 Survey123 Connect 为例):

  1. 浏览到应用程序的安装位置,在 Windows 上默认位于 C:\Users\<username>\Applications\ArcGIS\ArcGISSurvey123Connect。
  2. 将以下文件复制到您设备上的其他位置、网络文件夹或 USB 驱动器中。 例如,在桌面上创建一个名为 InstallScripts 的文件夹。
    • silent-install-controller.qs
    • silent-uninstall-controller.qs
    • silent-uninstall-install-ArcGISSurvey123Connect
  3. 当要安装新版本的 Survey123 Connect 时,将应用程序安装文件复制到创建的 InstallScripts 文件夹,并将该文件重命名为保持不变的名称,例如,Survey123ConnectInstallFile.exe。

一旦此位置创建完成,.qs 和脚本文件便不会更改。 要执行无人值守的安装和卸载,只需更改安装文件即可。

如果您的计算机上有多个基于 AppStudio 的应用程序,您只需要一份 silent-install-controller.qs 和 silent-uninstall-controller.qs 副本。 只需将不同的 silent-uninstall-install-appName 脚本文件复制到您创建的 InstallScripts 文件夹中,与 .qs 文件放在一起。

默认情况下,无人值守的安装和卸载将在后台执行,没有显示进度的用户界面。 要针对这些无人值守的安装和卸载显示用户界面,请在运行脚本文件时添加命令行参数 showui=true。

注:

如果您的脚本来自早于 Survey123 3.10 的版本,请将您的脚本更新为最新版本,以确保隐藏界面为默认行为。

要使用这些脚本卸载应用程序,请在命令窗口中浏览到您创建的 InstallScripts 文件夹,然后输入以下命令:

silent-uninstall-install-ArcGISSurvey123Connect.bat .

末尾的句点很重要,因为这表明不会安装任何文件。

要安装应用程序,请在命令窗口中浏览到您创建的 InstallScripts 文件夹,然后输入以下命令:

silent-uninstall-install-ArcGISSurvey123Connect.bat Survey123ConnectInstallFile.exe

相同的命令可在安装新版本之前卸载所有现有版本的应用程序,并允许您使用一个命令升级应用程序。

安装 Survey123 网站

Survey123 网站可以与 ArcGIS Enterprise 部署一起安装,以支持断开连接的环境,或允许组织在自己的基础架构上托管网站。 安装中包括以下内容:

  • Survey123 网站,用于管理调查和查看调查结果
  • Survey123 REST API,用于将调查配置(.xlsx 文件)转换为表单以在 Survey123 字段和 web 应用程序中使用

通过 My Esri 下载安装 Survey123 网站所需的文件,此文件可以与您的 Portal for ArcGIS 实例安装在同一台计算机上,也可以安装在独立 web 服务器上。 系统管理员应执行以下操作:

  • 安装已下载的文件。
    • 在 Windows 上,将已下载的文件解压缩到要安装 Survey123 网站的计算机上,运行 setup.exe,并完成向导安装步骤。
    • 在 Linux 上,使用命令 gunzip [filename].tar.gz 后跟 tar xf [filename].tar 在终端中将 .tar.gz 文件解压缩到要安装 Survey123 网站的计算机上。 提取后,在终端中运行 ./Setup,然后完成向导安装步骤。
  • 运行安装后配置实用程序并完成问题。 根据您的部署所使用的身份验证方法,此步骤有所不同。 有关详细信息,请参阅操作方法:安装和配置 ArcGIS Survey123 网站知识库文章。
    • 具有内置身份验证的 ArcGIS Enterprise - 启动 https://localhost:5443/share/post-install.html 向导。
    • 具有 IWA 身份验证的 ArcGIS Enterprise(在同一主机 URL 上)- 启动 https://webadaptorhost.domain.com:5443/share/post-install.html 向导(其中 webadaptorhost 和 domain 将被替换为有关您服务器的信息)。
    • 具有 IWA 身份验证的 ArcGIS Enterprise(在同一主机 URL 上)- 请按照操作方法:安装和配置 ArcGIS Survey123 网站知识库文章,执行安装后的手动步骤。
    注:

    如果您在浏览器中收到安全警告,请接受警告并继续浏览网页以完成安装后步骤。 安装后步骤可解决该警告。

  • 单击提交以完成以下内容:
    • 更新 config.json 文件。
    • 将您的证书文件导入 ~\ArcGIS\Survey123website\server\cert\ 文件夹。
    • 追加您的 Survey123 企业主机 URL 作为到 survey123hub AppID 的重定向 URI。

有关详细信息,请参阅以下相关的知识库文章: