Sie können Links zum Öffnen von Survey123 Mobile in einer anderen App, in einem Webkarten-Pop-up oder über einen Hyperlink in einer E-Mail oder einer Website erstellen. Verwenden Sie ein benutzerdefiniertes URL-Schema zum Starten der App in einem Webbrowser oder einen Survey123-App-Link zum Starten der App in einer App unter Android oder iOS. Verwenden Sie URL-Parameter, um anzupassen, wie Survey123 Mobile geöffnet wird, zum Beispiel zum Laden eines bestimmten Survey, zum Festlegen der Koordinaten für die Standardkartenposition und zum Füllen von Antworten auf Fragen mit vorher festgelegten Werten oder durch Übergeben von Datenattributen aus einem Webkarten-Pop-up.
Erstellen eines Links in einem Webbrowser unter Windows
Sie können einen Link erstellen, um Survey123 Mobile zu öffnen, und diesen in eine andere App einbetten. Derselbe Link kann auch in einem Webbrowser zu Testzwecken eingegeben werden.
Hinweis:
Beim Erstellen des Links können Sie arcgis-survey123-mobile:// durch https://survey123-mobile.arcgis.app als Survey123-Link zur Verwendung unter iOS oder Android ersetzen.
Führen Sie die folgenden Schritte aus, um ein benutzerdefiniertes URL-Schema zu erstellen und in einem Desktop-Webbrowser zu verwenden:
- Geben Sie arcgis-survey123-mobile:// in den Browser ein.
Survey123 Mobile wird geöffnet (oder Sie werden zum Öffnen aufgefordert).
Hinweis:
Um einen Survey aus einem angegebenen Portal zu starten und herunterzuladen, müssen Sie den Parameter für die Portal-URL angeben, z. B. arcgis-survey123-mobile://?portalUrl=host.domain.com/webadaptor (wobei host, domain und webadaptor durch die Informationen Ihres Portals ersetzt werden).
- Fügen Sie wie folgt eine eindeutige Referenz zu einem Survey und zur URL hinzu:
- Identifizieren Sie die Element-ID des Survey, den Sie öffnen möchten.
Hinweis:
Dies ist die Zeichenfolge, die ArcGIS Online zur eindeutigen Identifizierung des Survey verwendet. Sie befindet sich in der URL des Formularelements in ArcGIS Online. Wenn die Survey-URL beispielsweise https://exampleurl.maps.arcgis.com/home/item.html?id=36ff9e8c13e042a58cfce4ad87f55d19 lautet, ist die Formularelement-ID 36ff9e8c13e042a58cfce4ad87f55d19.
- Fügen Sie den Survey in die URL ein, indem Sie ?itemID= und die Element-ID Ihres Formulars am Ende der URL hinzufügen.
Die URL sollte in etwa wie folgt aussehen:arcgis-survey123-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19Wenn Sie die URL testen, sollten Survey123 Mobile und direkt der Survey geöffnet werden.
Hinweis:
Wenn der Survey noch nicht auf Ihrem Gerät vorhanden ist, wird er heruntergeladen.
- Identifizieren Sie die Element-ID des Survey, den Sie öffnen möchten.
- Fügen Sie vorher festgelegte Antworten auf Fragen ein, indem Sie in der URL eine Referenz zu einem Feld unter Verwendung des in XLSForm zugewiesenen Namens (nicht der Beschriftung) hinzufügen.
Um beispielsweise das Feld Surname zu füllen, geben Sie &field:surname= und den Wert ein.
& dient als Trennzeichen zwischen den Parametern, und field: bezieht sich auf den Namen der Frage, die gefüllt werden muss.
Die URL sollte in etwa wie folgt aussehen:arcgis-survey123-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=KlauserNun können Sie über die URL Survey123 Mobile und den Survey öffnen und die entsprechende Frage mit der definierten Antwort ausfüllen. Sie können mehrere Fragen in einer Survey-URL füllen. Bei Feldnamen wird die Groß-/Kleinschreibung beachtet.
- Definieren Sie einen Ort für eine Geopunkt-Frage im Survey, indem Sie wie folgt Koordinaten zur URL hinzufügen:
- Geben Sie ¢er= und dann die Koordinaten ein.
- Geben Sie die Breitengrad- und Längengradkoordinaten, jeweils durch ein Komma getrennt, in Dezimalgrad ein.
- Fügen Sie optional als dritten Wert die Höhe in Metern als Dezimalzahl, ebenfalls durch ein Komma getrennt, hinzu.
Die fertige URL sollte in etwa wie folgt aussehen:
arcgis-survey123-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser¢er=37.8199,-122.4783,20Nun erfolgt über die URL das Öffnen von Survey123 Mobile und des ausgewählten Survey, das Füllen einer Textfrage und das Bereitstellen einer neuen Standardposition für die Geopunkt-Frage.
Feldattribute können auch über ein Pop-up in einer ArcGIS-Webkarte an Survey123 Mobile übergeben werden, was die Integration in andere Esri Apps, die Pop-ups in einer Webkarte nutzen, ermöglicht. Mit dieser Funktion kann ein Feld in Survey123 Mobile mit dem Wert eines Feature-Attributs statt mit einem festgelegten Wert gefüllt werden, indem der Name des Attributs in geschweiften Klammern angegeben wird.
- Öffnen Sie die Webkarte, wählen Sie Pop-ups für einen der Layer aus, wählen Sie Inhalt hinzufügen aus, wählen Sie Text aus, geben Sie den Text an, der für den Link angezeigt werden soll, und klicken Sie auf die Schaltfläche Link, um den Wert für Link-URL einzugeben.
Erstellen eines Links aus einer anderen App unter iOS oder Android
Sie können einen Link erstellen, der in ArcGIS-Apps zum Öffnen von Survey123 Mobile und Erfassen von Daten in einem Survey verwendet werden kann. In den folgenden Schritten wird beschrieben, wie ein Survey123-App-Link erstellt und in einem Webkarten-Pop-up verwendet wird. Dieser Link wird in das Pop-up einer Webkarte in Ihrer ArcGIS-Organisation eingegeben. Sie können den Link mit einem Webbrowser auf einem iOS- oder Android-Gerät testen (die Schritte dafür ähneln denen im vorhergehenden Abschnitt).
- Öffnen Sie eine Webkarte, die auf dem Gerät angezeigt werden soll, und wählen Sie Pop-ups für einen der Layer aus.
- Wählen Sie Inhalt hinzufügen und dann Text aus.
- Geben Sie Survey123 starten ein, markieren Sie die Texteingabe, klicken Sie auf die Schaltfläche Link, um die Link-URL einzugeben, geben Sie https://survey123-mobile.arcgis.app ein, klicken Sie auf OK, und gehen Sie folgendermaßen vor:
- Öffnen Sie die Webkarte über einen Browser oder eine ArcGIS-App auf einem mobilen Gerät.
- Wählen Sie ein Feature aus, und klicken Sie im Pop-up zum Starten von Survey123 auf den Link Survey123 starten.
- Um den Survey in die URL einzufügen, fügen Sie ?itemID= und die Element-ID Ihres Formulars am Ende der URL hinzu. Die URL sollte in etwa wie folgt aussehen:
https://survey123-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19Wenn Sie die URL testen, sollten nun Survey123 Mobile und direkt der Survey geöffnet werden.
Hinweis:
Wenn der Survey noch nicht auf Ihrem Gerät vorhanden ist, wird er heruntergeladen.
- Fügen Sie vorher festgelegte Antworten auf Fragen ein, indem Sie in der URL eine Referenz zu einem Feld unter Verwendung des in XLSForm zugewiesenen Namens (nicht der Beschriftung) hinzufügen.
Um beispielsweise das Feld Surname zu füllen, geben Sie &field:surname= und den Wert ein.
& dient als Trennzeichen zwischen den Parametern, und field: bezieht sich auf den Namen der Frage, die gefüllt werden muss.
Die URL sollte in etwa wie folgt aussehen:https://survey123-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=KlauserNun können Sie über die URL Survey123 Mobile und den Survey öffnen und die entsprechende Frage mit der definierten Antwort ausfüllen. Sie können mehrere Fragen in einer Survey-URL füllen. Bei Feldnamen wird die Groß-/Kleinschreibung beachtet.
- Definieren Sie einen Ort für eine Geopunkt-Frage im Survey, indem Sie wie folgt Koordinaten zur URL hinzufügen:
- Geben Sie ¢er= und dann die Koordinaten ein.
- Geben Sie die Breitengrad- und Längengradkoordinaten, jeweils durch ein Komma getrennt, in Dezimalgrad ein.
- Fügen Sie optional als dritten Wert die Höhe in Metern als Dezimalzahl, ebenfalls durch ein Komma getrennt, hinzu.
Die fertige URL sollte in etwa wie folgt aussehen:
https://survey123-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser¢er=37.8199,-122.4783,20Nun erfolgt über die vollständige URL das Öffnen von Survey123 Mobile und des ausgewählten Survey, das Füllen einer Textfrage und das Bereitstellen einer neuen Standardposition für die Geopunkt-Frage.
URL-Parameter zum Starten von Survey123 Mobile
Die folgenden Parameter können verwendet werden, um anzupassen, wie Survey123 Mobile geöffnet wird.
| Parameter | Beschreibung | Typ |
|---|---|---|
center | Zentriert die Karte auf bekannte Werte für Breitengrad, Längengrad und optional eine Höhe. Beispiel: | Zeichenfolge |
field:fieldname | Füllt Survey-Fragen mit Feldwerten. Beispiel: | Zeichenfolge |
portalUrl | Die URL zu dem Portal, in dem das Survey-Element gehostet wird. Beispiel: | Zeichenfolge |
itemID | Das zu öffnende Formular. Beispiel: | UUID |
download | Lädt den Survey automatisch herunter, wenn das Gerät online ist. Die Standardeinstellung ist true. Beispiel: | Boolesch |
callback | Die URL, die zurückgegeben werden soll, wenn eine Formularaktion (z. B. Senden, Verschieben nach Entwürfe, Abbrechen oder Beenden) abgeschlossen wird. Beispiel: | URL |
callback:status | Beispiel: | Zeichenfolge |