Integrieren in andere Apps

ArcGIS Survey123 kann über Links zum Öffnen der mobilen oder der Survey123-Web-App, von Survey123 Connect oder einer anderen App in andere Apps integriert werden. Sie können zum Beispiel App-Links zum Starten und Öffnen der mobilen Survey123-App 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.

Verwenden Sie die URL-Muster in der Tabelle, um Links für den Zugriff aus einem Webbrowser oder einer anderen App zu erstellen.

Starten vonErstellen eines Links ausZu verwendendes URL-Muster

Web-App

Webbrowser

Survey-Formular über ID:

https://survey123.arcgis.com/share/ID

Mobile App

Android und iOS

Survey123-App-Link:

https://survey123.arcgis.app

Windows, Android, eine Gruppe ausgewählter Apps unter iOS

Benutzerdefiniertes URL-Schema:

arcgis-survey123://

Survey123 Connect

Windows

Benutzerdefiniertes URL-Schema:

arcgis-survey123connect://

Eine andere App

Survey-Formular

Links aus Survey123: Variiert je nach App

In den folgenden Beispielen wird veranschaulicht, wie mit diesen URL-Mustern ein bestimmter Survey geöffnet wird:

  • https://survey123.arcgis.com/share/36ff9e8c13e042a58cfce4ad87f55d19
  • https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19
  • arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19
  • arcgis-survey123connect://?portalUrl=https://www.arcgis.com&itemID=36ff9e8c13e042a58cfce4ad87f55d19

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.

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://?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://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:color_1=red&field:color_2=blue

Weitere Beispiel-URLs und unterstützte URL-Parameter finden Sie unter Web-App starten, 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 der mobilen App enthält, sollte die App bereits auf dem Gerät installiert sein. Weitere Informationen finden Sie unter Installieren der mobilen Survey123-App.

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.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https://quickcapture.arcgis.app?itemID=867895a71a1840399476fc717e76bb43

Dieselbe URL mit codierten Parametern lautet wie folgt:

https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https%3A%2F%2Fquickcapture.arcgis.app%3FitemID=867895a71a1840399476fc717e76bb43

Ein 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.


In diesem Thema
  1. URL-Parameter
  2. URL-Codierung