ArcGIS Survey123 umfasst in der Regel zwei Komponenten, die installiert werden: Survey123 Studio oder Survey123 Connect zur Erstellung von Surveys auf einem Desktop und Survey123 Mobile oder die mobile Survey123-App auf einem Gerät zur Sammlung der Survey-Daten.
Die Survey123-Website (einschließlich Web Designer und Web-App) kann ohne Installation verwendet werden. Einige Organisation installieren jedoch die Survey123-Website zusätzlich zu einer Bereitstellung von ArcGIS Enterprise, um eine nicht verbundene Umgebung zu unterstützen.
Installieren von Survey123 Studio
Survey123 Studio ist im Microsoft Store verfügbar. Sie können Survey123 Studio über diesen Store direkt auf Ihrem Gerät installieren.
Sie können auch die Survey123 Studio-Installationsdatei für Windows von der Survey123-Downloads-Seite herunterladen.
Um die heruntergeladene Datei nur für den aktuellen Benutzer zu installieren, doppelklicken Sie auf die Datei, und klicken Sie auf Installieren. Wenn bereits eine frühere Version von Survey123 Studio installiert ist, werden Sie aufgefordert, auf Aktualisieren zu klicken. Falls Sie die App für alle Benutzer auf dem Computer installieren möchten, können Sie den Microsoft PowerShell-Befehl Add-ProvisionedAppPackage verwenden.
Unter Windows befinden sich die Anwendungsdateien im folgenden Verzeichnis: C:\Program Files\WindowsApps. In der Regel navigieren Sie nicht zu diesen Dateien. Wenn Sie Survey123 Studio deinstallieren möchten, klicken Sie auf Einstellungen > Apps > Installierte Apps > ArcGIS Survey123 Studio, und wählen Sie Deinstallieren aus.
Unter Windows befinden sich Survey-Datendateien im folgenden Verzeichnis: C:\Users\<username>\Documents\ArcGIS\Survey-Studio.
Hinweis:
Survey123 Studio kann parallel mit Survey123 Connect installiert werden.
Installieren von Survey123 Mobile
Die Survey123 Mobile-App ist in Google Play, im App Store und im Microsoft Store verfügbar. Sie können Survey123 Mobile über diese Stores direkt auf Ihrem Gerät installieren.
Sie können auch die Survey123 Mobile-Installationsdatei für Windows oder Android von der Survey123-Downloads-Seite herunterladen.
Um die heruntergeladene Datei unter Windows nur für den aktuellen Benutzer zu installieren, doppelklicken Sie auf die Datei, und klicken Sie auf Installieren. Wenn bereits eine frühere Version von Survey123 Mobile installiert ist, werden Sie aufgefordert, auf Aktualisieren zu klicken. Falls Sie die App für alle Benutzer auf dem Computer installieren möchten, können Sie den PowerShell-Befehl Add-ProvisionedAppPackage verwenden.
Unter Android müssen Sie zunächst die ausführbare Desktop-Datei unter Windows ausführen, um die APK-Datei abzurufen. Die APK-Datei kann anschließend zur Installation auf ein Android-Gerät kopiert oder über MDM installiert werden.
Unter Windows befinden sich die Anwendungsdateien im folgenden Verzeichnis: C:\Program Files\WindowsApps. In der Regel navigieren Sie nicht zu diesen Dateien. Wenn Sie Survey123 Mobile deinstallieren möchten, klicken Sie auf Einstellungen > Apps > Installierte Apps > ArcGIS Survey123 Mobile, und wählen Sie Deinstallieren aus.
Die Survey-Datendateien befinden sich in den folgenden Verzeichnissen:
- Windows: C:\Users\<username>\Documents\ArcGIS\Survey123-Mobile
- Android: Android/data/com.esri.survey123.mobile/files (Das Gerät muss mit einem Desktop-PC verbunden werden, und zum Suchen dieser Dateien muss ein Dateibrowser auf dem PC verwendet werden.)
Hinweis:
Auf Datendateien kann unter iOS nicht zugegriffen werden, da die App aus Datenschutzgründen keine Berechtigung zum Zugriff auf lokale Dateien anfordert.
Survey123 Mobile kann parallel mit der mobilen Survey123-App installiert werden.
Installieren von Survey123 Connect
Survey123 Connect ist im Microsoft Store verfügbar. Sie können Survey123 Connect über diesen Store direkt auf Ihrem Gerät installieren.
Sie können auch die Survey123 Connect-Installationsdatei für Windows von der Survey123-Downloads-Seite herunterladen.
Doppelklicken Sie zum Installieren von Survey123 Connect auf die zu installierende Datei, und führen Sie die folgenden Schritte aus:
- Klicken Sie auf Weiter.
- Wählen Sie den Installationsordner (vorzugsweise den Standardordner) aus.
- Akzeptieren Sie die Lizenzvereinbarung.
- Geben Sie den Namen des Startmenüs an.
- Klicken Sie auf Installieren.
Unter Windows befinden sich die Anwendungsdateien im folgenden Verzeichnis: C:\Users\<username>\Applications\ArcGIS\ArcGISSurvey123Connect.
Diese Dateien werden in der Regel nicht bearbeitet. Wenn Sie Survey123 Connect deinstallieren möchten, navigieren Sie zu diesem Ordner, und wählen Sie ArcGISSurvey123Connect deinstallieren aus.
Survey-Datendateien befinden sich im folgenden Verzeichnis: C:\Users\<username>\ArcGIS\My Survey Designs.
Hinweis:
Wenn bereits eine frühere Version von Survey123 Connect installiert ist, wird eine Eingabeaufforderung mit der Frage eingeblendet, ob Sie fortfahren möchten.Installieren der mobilen Survey123-App
Die mobile Survey123-App ist in Google Play, im App Store und im Microsoft Store verfügbar. Sie können Survey123 über diese Stores direkt auf Ihrem Gerät installieren.
Sie können auch die Installationsdatei für die mobile Survey123-App für Windows und Android von der Survey123-Downloads-Seite herunterladen und die Installation wie für Survey123 Connect durchführen.
Nach Abschluss der Installation wird eine Desktop-Verknüpfung namens Survey123 erstellt. Das Installationsverzeichnis für alle Dateien der mobilen Survey123-App auf dem Desktop ist mit dem von Survey123 Connect identisch.
Die Survey-Datendateien befinden sich in den folgenden Verzeichnissen:
- Windows: C:\Users\<username>\ArcGIS
- iOS: On My iPad/Survey123/ArcGIS oder On My iPhone/Survey123/ArcGIS
- Android: Android/data/com.esri.survey123/files/ArcGIS (Das Gerät muss mit einem Desktop-PC verbunden werden, und zum Suchen dieser Dateien muss ein Dateibrowser auf dem PC verwendet werden.)
Hinweis:
Wenn unter Windows bereits eine frühere Version von Survey123 installiert ist, wird eine Eingabeaufforderung mit der Frage eingeblendet, ob Sie fortfahren möchten. Unter Android und iOS werden frühere Versionen der mobilen Survey123-App automatisch überschrieben.Automatische Installation und Deinstallation
Survey123 Studio und Survey123 Mobile können mit PowerShell-Befehlen installiert und deinstalliert werden.
Survey123 Connect und die mobile Survey123-App können mithilfe der bereitgestellten Skriptdateien installiert und deinstalliert werden.
Survey123 Studio und Survey123 Mobile
Survey123 Studio und Survey123 Mobile werden als MSIX-Dateien für Windows bereitgestellt, und Sie können zur Installation und Deinstallation die unten aufgeführten PowerShell-Befehle verwenden.
Um die Installation durchzuführen, wenn der Dateiname mit dem Namen der von Ihnen heruntergeladenen Datei übereinstimmt, verwenden Sie Add-AppxPackage -Path "C:\Downloads\Survey123-Mobile_x64_26.1.0.100.msix".
Zum Deinstallieren verwenden Sie Folgendes:
- Survey123 Studio: Get-AppxPackage -Name "Esri.ArcGISSurvey123Studio*" | Remove-AppxPackage
- Survey123 Mobile: Get-AppxPackage -Name "Esri.ArcGISSurvey123Mobile*" | Remove-AppxPackage
Survey123 Connect und die mobile Survey123-App
Wenn Sie Survey123 Connect oder die mobile Survey123-App unter Windows installieren, erhalten Sie auch Skriptdateien, um Sie bei der Durchführung künftiger automatischer Installationen oder Deinstallationen zu unterstützen.
Führen Sie die folgenden Schritte aus, um nach der Erstinstallation der App auf einem Gerät die entsprechenden Aktionen vorzubereiten (am Beispiel von Survey123 Connect):
- Navigieren Sie zu dem Speicherort, an dem die App installiert wurde. Unter Windows ist dies ist standardmäßig C:\Users\<username>\Applications\ArcGIS\ArcGISSurvey123Connect.
- Kopieren Sie die folgenden Dateien an einen anderen Speicherort auf dem Gerät, in einem Netzwerkordner oder auf einem USB-Laufwerk. Erstellen Sie zum Beispiel einen Ordner mit dem Namen "InstallScripts" auf dem Desktop.
- silent-install-controller.qs
- silent-uninstall-controller.qs
- silent-uninstall-install-ArcGISSurvey123Connect
- Wenn eine neue Version von Survey123 Connect installiert werden muss, kopieren Sie die Installationsdatei für die App in den erstellten Ordner "InstallScripts", und benennen Sie die Datei in einen Namen um, der nicht mehr geändert wird, zum Beispiel Survey123ConnectInstallFile.exe.
Nachdem dieser Speicherort festgelegt wurde, ändern sich die .qs- und Skriptdateien nicht mehr. Zur Durchführung automatischer Installationen und Deinstallationen müssen nur die Installationsdateien geändert werden.
Falls Sie mehrere Apps auf Ihrem Computer installiert haben, die auf AppStudio basieren, benötigen Sie lediglich jeweils eine Kopie von silent-install-controller.qs und silent-uninstall-controller.qs. Kopieren Sie nur die unterschiedlichen silent-uninstall-install-appName-Skriptdateien zusammen mit den .qs-Dateien in den erstellten Ordner "InstallScripts".
Standardmäßig wird eine unbeaufsichtigte Installation oder Deinstallation im Hintergrund durchgeführt, sodass keine Bedienoberfläche mit dem Fortschritt angezeigt wird. Um für unbeaufsichtigte Installationen und Deinstallationen eine Bedienoberfläche anzuzeigen, müssen Sie beim Ausführen der Skriptdateien den Befehlszeilenparameter showui=true hinzufügen.
Hinweis:
Wenn Ihre Skripte aus einer Version vor Survey123 3.10 stammen, aktualisieren Sie diese auf die aktuelle Version, um sicherzustellen, dass das Ausblenden der Bedienoberfläche das Standardverhalten darstellt.
Um die App mithilfe dieser Skripte zu deinstallieren, navigieren Sie zu dem erstellten Ordner "InstallScripts", öffnen Sie ein Befehlsfenster, und geben Sie den folgenden Befehl ein:
silent-uninstall-install-ArcGISSurvey123Connect.bat .
Der Punkt am Ende ist wichtig, da hiermit angegeben wird, dass nichts installiert wird.
Um die App zu installieren, navigieren Sie in einem Befehlsfenster zu dem erstellten Ordner "InstallScripts", und geben Sie den folgenden Befehl ein:
silent-uninstall-install-ArcGISSurvey123Connect.bat Survey123ConnectInstallFile.exe
Mit demselben Befehl werden alle vorhandenen Versionen der App deinstalliert, bevor die neue Version installiert wird. So können Sie mit einem einzigen Befehl ein Upgrade der App ausführen.
Installieren der Survey123-Website
Die Survey123-Website kann neben einer ArcGIS Enterprise-Bereitstellung installiert werden, um eine nicht verbundene Umgebung zu unterstützen oder wenn Organisationen die Website in der eigenen Infrastruktur hosten möchten. Die Installation umfasst Folgendes:
- Survey123-Website zum Verwalten von Surveys und Anzeigen von Survey-Ergebnissen
- Survey123-REST-API zum Konvertieren von Survey-Konfigurationen (.xlsx-Dateien) in Formulare, die in der mobilen Survey123-App und in der Web-App verwendet werden können
Die zum Installieren der Survey123-Website erforderliche Datei wird von My Esri heruntergeladen und kann auf demselben Computer wie die Portal for ArcGIS-Instanz oder auf einem eigenständigen Webserver installiert werden. Die folgenden Schritte sollten von einem Systemadministrator ausgeführt werden:
- Installieren Sie die heruntergeladenen Dateien.
- Entpacken Sie unter Windows die heruntergeladene Datei auf dem Computer, auf dem Sie die Survey123-Website installieren möchten, führen Sie setup.exe aus, und führen Sie die Installationsschritte im Assistenten durch.
- Unter Linux entpacken Sie den Inhalt der .tar.gz-Datei auf dem Computer, auf dem Sie die Survey123-Website installieren möchten, mit dem Befehl gunzip [filename].tar.gz, gefolgt von tar xf [filename].tar in Terminal. Nach dem Entpacken führen Sie ./Setup in Terminal und dann die Installationsschritte im Assistenten durch.
- Führen Sie das Postinstallationsdienstprogramm aus, und beantworten Sie die Fragen. Dieser Schritt variiert in Abhängigkeit von der Authentifizierungsmethode der Bereitstellung. Eine umfassende Beschreibung finden Sie im Knowledge Base-Artikel How To: Installieren und Konfigurieren der ArcGIS Survey123-Website.
- ArcGIS Enterprise mit integrierter Authentifizierung: Starten Sie den Assistenten unter https://localhost:5443/share/post-install.html.
- ArcGIS Enterprise mit IWA-Authentifizierung (dieselbe Host-URL): Starten Sie den Assistenten unter https://webadaptorhost.domain.com:5443/share/post-install.html (wobei webadaptorhost und domain durch die entsprechenden Angaben zu Ihrem Server ersetzt werden müssen.)
- ArcGIS Enterprise mit IWA-Authentifizierung (andere Host-URL): Führen Sie die im Knowledge Base-Artikel How To: Installieren und Konfigurieren der ArcGIS Survey123-Website beschriebenen manuellen Postinstallationsschritte aus.
Hinweis:
Falls Sie im Browser eine Sicherheitswarnung erhalten, akzeptieren Sie diese, und öffnen Sie die Webseite, um die Postinstallationsschritte durchzuführen. Die Warnung wird durch die Postinstallationsschritte aufgehoben.
- Klicken Sie auf Senden. Damit werden folgende Schritte ausgeführt:
- Die Datei config.json wird aktualisiert.
- Die Zertifikatdateien werden in den Ordner ~\ArcGIS\Survey123website\server\cert\ importiert.
- Die Enterprise-Host-URL für Survey123 wird als Umleitungs-URI an die survey123hub-AppID angehängt.
Weitere Informationen finden Sie in den folgenden Knowledge Base-Artikeln: