ArcGIS Survey123 kann über Links zum Starten der spezifischen Komponente in andere Apps integriert werden. Sie können zum Beispiel App-Links zum Starten und Öffnen von Survey123 Mobile in einer anderen Esri App, in einem Webkarten-Pop-up oder über einen einfachen Hyperlink in einer E-Mail oder einer Website erstellen. Sie können eine URL zum automatischen Herunterladen und Öffnen eines Survey für die Bearbeitung in Survey123 Connect verwenden.
Sie können auch in Survey123 Links zu anderen Apps erstellen, wie zum Beispiel ArcGIS QuickCapture und ArcGIS Field Maps.
Tipp:
Survey123 Mobile öffnet Links für drei Apps: Survey123 Mobile, die mobile Survey123-App und QuickCapture. Wenn einer dieser Links aus Survey123 Mobile aufgerufen wird (über Link verwenden, QR-Code scannen oder einen Link in einem Survey oder QuickCapture-Projekt), wird er in Survey123 Mobile geöffnet. Weitere Informationen finden Sie unter Öffnen von Inhalten.
Verwenden Sie die URL-Muster in der Tabelle, um Links für den Zugriff aus einem Webbrowser oder einer anderen App zu erstellen. In den enthaltenen Beispielen wird veranschaulicht, wie mit diesen URL-Mustern ein bestimmter Survey geöffnet wird.
| Starten von | Erstellen eines Links aus | Zu verwendendes URL-Muster |
|---|---|---|
| Survey123 Mobile | Android iOS | Survey123-App-Link1: Beispiel: |
Windows Android iOS2 | Benutzerdefiniertes URL-Schema3: Beispiel: | |
Web-App | Webbrowser | Survey-Formular über ID: Beispiel: |
Mobile App | Android iOS | Survey123-App-Link1: Beispiel: |
Windows Android iOS2 | Benutzerdefiniertes URL-Schema3: Beispiel: | |
| Survey123 Studio | Windows | Benutzerdefiniertes URL-Schema3: Beispiel: |
Survey123 Connect | Windows | Benutzerdefiniertes URL-Schema3: Beispiel: |
Eine andere App | Survey-Formular | Links aus Survey123: Variiert je nach App |
1: Survey123-App-Links entsprechen den Anforderungen, die vom App Store und von Google Play festgelegt werden. Sie ermöglichen die Verknüpfung mit weiteren Apps und unterstützen verkürzte Links, die einfacher freigegeben werden können.
2: Auf iOS-Geräten sind benutzerdefinierte URL-Schemas nur für eine eine Gruppe ausgewählter Apps zugelassen.
3: Diese Links können nicht verkürzt werden und sind unter Android nur schwierig zu öffnen. Sie sollten in Erwägung ziehen, Links mit einem benutzerdefinierten URL-Schema in Form von Hyperlinks darzustellen. Hier ein Beispiel:<a href="arcgis-survey123-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19">Open survey</a>
URL-Parameter
Sie können am Ende der Links weitere URL-Parameter hinzufügen, um weiter anzupassen, wie die App geöffnet wird. Sie können zum Beispiel die Standardposition für eine Geopunkt-Frage festlegen oder eine Textfrage füllen.
URL-Parameter beginnen mit dem Zeichen "?" und werden mit dem Zeichen "&" getrennt. Nachstehend finden Sie ein Beispiel für ein benutzerdefiniertes URL-Schema, bei dem der erste Parameter (itemID) mit dem Zeichen "?" beginnt und alle nachfolgenden Feldparameter (color_1 und color_2) durch das Zeichen "&" getrennt sind.
arcgis-survey123-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:color_1=red&field:color_2=blueWeitere Beispiel-URLs und unterstützte URL-Parameter finden Sie unter Starten von Survey123 Mobile, Feature functions | ArcGIS Arcade | Esri Developer, Starten der Web-App, Starten der mobilen App, Starten von Survey123 Connect und Starten einer anderen App in Survey123.
Hinweis:
Damit Sie einen Link verwenden können, der Parameter zum Starten eines Survey in Survey123 Mobile oder der mobilen App enthält, sollte die App bereits auf dem Gerät installiert sein. Weitere Informationen finden Sie unter Installieren von ArcGIS Survey123.
URL-Codierung
Auch wenn nicht codierte URL-Parameter in einigen Umgebungen verwendet werden können, wird das Codieren der URL-Parameter empfohlen. Die Codierung ersetzt ungültige Zeichen durch das Prozentzeichen (%) gefolgt vom jeweils zugehörigen hexadezimalen Äquivalent.
Der folgende Link ist beispielsweise ein Survey123-Link mit Rückruffunktion für ein bestimmtes Projekt in QuickCapture mit nicht codierten Parametern:
https://survey123-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https://quickcapture.arcgis.app?itemID=867895a71a1840399476fc717e76bb43Dieselbe URL mit codierten Parametern lautet wie folgt:
https://survey123-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https%3A%2F%2Fquickcapture.arcgis.app%3FitemID=867895a71a1840399476fc717e76bb43Ein Gleichheitszeichen, das eine Unterbrechung zwischen einem Schlüssel und dessen Wert angibt, sollte nicht codiert werden.
Tipp:
Eine Möglichkeit zum Erstellen codierter Parameter ist die Verwendung von ArcGIS Arcade. Mit der Funktion UrlEncode können Sie eine Sammlung von Schlüssel-Wert-Paaren definieren und eine URL mit entsprechender Codierung erzeugen.
Der Autor eines Survey könnte damit auch URL-Parameter verschleiern, damit sensible Daten in der URL nicht sichtbar sind. Fügen Sie in diesem Fall beim Erstellen einer URL zur Verwendung in der Web-App encodeUrlParams=true ein. Weitere Informationen finden Sie unter URL-Parameter zum Öffnen der Web-App.