일반적으로 두 가지 ArcGIS Survey123 컴포넌트(현장조사 작성을 위해 데스크톱에 설치해야 하는 Survey123 Studio 또는 Survey123 Connect 및 현장조사 데이터 수집을 위해 기기에 설치해야 하는 Survey123 Mobile 또는 Survey123 현장 앱)를 설치해야 합니다.
Survey123 웹사이트(웹 디자이너 및 웹 앱 포함)는 설치하지 않고도 사용할 수 있지만, 일부 기관에서는 오프라인 환경을 지원하기 위해 ArcGIS Enterprise 배포와 함께 Survey123 웹사이트를 설치할 수 있습니다.
Survey123 Studio 설치
Survey123 Studio는 Microsoft Store에서 제공됩니다. 이 스토어에서 내 기기에 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에서는 APK 파일을 가져오려면 먼저 Windows에서 데스크톱 실행 파일을 실행해야 합니다. 그런 다음 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 설치
Survey123 Connect는 Microsoft Store에서 제공됩니다. 이 스토어에서 내 기기에 Survey123 Connect를 바로 설치할 수 있습니다.
Survey123다운로드 페이지에서 Windows용 Survey123 Connect 설치 파일을 다운로드할 수도 있습니다.
Survey123 Connect를 설치하려면 설치할 파일을 더블 클릭한 후 다음을 수행합니다.
- 다음을 클릭합니다.
- 설치 폴더를 선택합니다(기본 설치 폴더 권장).
- 라이선스 동의서에 동의합니다.
- 시작 메뉴 이름을 지정합니다.
- 설치를 클릭합니다.
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
Survey123 Studio 및 Survey123 Mobile은 Windows용 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를 예시로 사용하여 하나의 기기에 앱을 처음 설치한 후 다음 단계를 완료합니다.
- 앱이 설치되어 있는 위치(Windows에서 기본 설정에 따라 C:\Users\<username>\Applications\ArcGIS\ArcGISSurvey123Connect)로 이동합니다.
- 다음 파일을 기기의 다른 위치, 네트워크 폴더 또는 USB 드라이브에 복사합니다. 예를 들어, 데스크톱에 InstallScripts라는 폴더를 생성합니다.
- silent-install-controller.qs
- silent-uninstall-controller.qs
- silent-uninstall-install-ArcGISSurvey123Connect
- 새 버전의 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 웹사이트
- 현장조사 구성(.xlsx 파일)을 Survey123 현장 앱과 웹 앱에서 사용하기 위한 양식으로 변환하는 Survey123 REST API
Survey123 웹사이트를 설치하는 데 필요한 파일은 My Esri에서 다운로드되며 Portal for ArcGIS 인스턴스와 동일한 머신 또는 독립형 웹 서버에 설치할 수 있습니다. 시스템 관리자는 다음 작업을 수행해야 합니다.
- 다운로드한 파일을 설치합니다.
- Windows의 경우 Survey123 웹사이트를 설치할 머신에 다운로드한 파일의 압축을 풀고 setup.exe를 실행한 후 마법사 설치 단계를 완료합니다.
- Linux의 경우 Survey123 웹사이트를 설치할 머신의 터미널에서 gunzip [filename].tar.gz 명령을 실행한 다음 tar xf [filename].tar 명령을 실행하여 .tar.gz 파일의 콘텐츠를 추출합니다. 추출하면 터미널에서 ./Setup을 실행하고 마법사 설치 단계를 완료합니다.
- 설치 후 작업 유틸리티를 실행하고 질문을 완료합니다. 배포에서 사용하는 인증 방법에 따라 이 단계가 달라집니다. 자세한 내용은 방법: ArcGIS Survey123 웹사이트 설치 및 구성 Knowledge Base article에 설명되어 있습니다.
- 빌트인 인증이 포함된 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 웹사이트 설치 및 구성 Knowledge Base article의 수동 설치 후 작업 단계를 따릅니다.
비고:
브라우저에 보안 경고가 표시되면 경고를 수락하고 웹페이지를 계속 사용하여 설치 후 작업 단계를 완료합니다. 설치 후 작업 단계는 경고를 해결합니다.
- 제출을 클릭하여 다음 작업을 완료합니다.
- config.json 파일을 업데이트합니다.
- ~\ArcGIS\Survey123website\server\cert\ 폴더로 인증서 파일을 가져옵니다.
- survey123hub AppID에 대한 리디렉션 URI로 Survey123 엔터프라이즈 호스트 URL을 추가합니다.
자세한 내용은 다음과 같은 관련 기술 자료 문서를 참고하세요.