Starten der mobilen App

Sie können App-Links zum Öffnen der mobilen Survey123-App 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 die mobile App 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 zum Öffnen der mobilen App erstellen 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:// durch https://survey123.arcgis.app als Survey123-Link zur Verwendung unter iOS oder Android ersetzen.

In den folgenden Schritten wird beschrieben, wie ein benutzerdefiniertes URL-Schema erstellt und in einem Desktop-Webbrowser verwendet wird:

1. Geben Sie arcgis-survey123:// in Ihrem Browser ein.

   Die mobile Survey123-App wird geöffnet (oder Sie werden dazu aufgefordert, sie zu öffnen).

   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://?portalUrl=host.domain.com/webadaptor (wobei host, domain und webadaptor durch die Informationen Ihres Portals ersetzt werden).

2. Fügen Sie eine eindeutige Referenz zu einem Survey und zur URL hinzu:
   1. 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.

   2. 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://?itemID=36ff9e8c13e042a58cfce4ad87f55d19

   Wenn Sie die URL testen, sollten nun die mobile Survey123-App und direkt der Survey geöffnet werden.

   Hinweis:

   Wenn der Survey noch nicht auf Ihrem Gerät vorhanden ist, wird er heruntergeladen.

3. 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://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser

   Nun können Sie über die URL die mobile Survey123-App 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.

4. Definieren Sie einen Ort für eine Geopunkt-Frage im Survey, indem Sie Koordinaten zur URL hinzufügen:
   • Geben Sie &center= 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://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser&center=37.8199,-122.4783,20

   Nun erfolgt über die URL das Öffnen der mobilen Survey123-App 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 ü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 mit dem Wert eines Feature-Attributs statt mit einem festgelegten Wert gefüllt werden, indem der Name des Attributs in geschweiften Klammern angegeben wird.

5. Öffnen Sie die Webkarte, und wählen Sie Pop-ups für einen der Layer aus. Wählen Sie Inhalt hinzufügen und dann 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.

   

   Mit dieser URL wird das Feld "surname" mit dem Inhalt des Attributs "Name" des ausgewählten Features statt mit einem festgelegten Wert gefüllt:

   arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname={name}

   Mit dieser URL wird das Feld "hydrantGlobalID" mit der Global-ID des ausgewählten Hydranten gefüllt:

   arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:hydrantGlobalID={globalid}

   Hinweis:

   Standardmäßig können in einem Pop-up in einer Webkarte nur dann Werte für Fragen mit Einfachauswahl oder Mehrfachauswahl übergeben werden, wenn der Name und die Beschriftung der entsprechenden Auswahlmöglichkeit identisch sind. Wenn die Namen und Beschriftungen in Ihrer Auswahlliste unterschiedlich sind, können Sie die Funktionen DomainCode oder UrlEncode in einem ArcGIS Arcade-Ausdruck im Pop-up verwenden, um den gewünschten Wert zu übergeben.

   Fragen innerhalb von Wiederholungen können nicht gefüllt werden.

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

1. Öffnen Sie eine Webkarte, die auf dem Gerät angezeigt werden soll, und wählen Sie Pop-ups für einen der Layer aus.
2. Wählen Sie Inhalt hinzufügen und dann Text aus.
3. Geben Sie Survey123 starten ein, markieren Sie die Texteingabe, und klicken Sie auf die Schaltfläche Link, um die Link-URL einzugeben. Geben Sie https://survey123.arcgis.app ein, und klicken Sie auf OK.
   1. Öffnen Sie die Webkarte über einen Browser oder eine ArcGIS-App auf einem mobilen Gerät.
   2. Wählen Sie ein Feature aus, und klicken Sie im Pop-up zum Starten von Survey123 auf den Link Survey123 starten.
4. 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.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19

   Wenn Sie die URL testen, sollten nun die mobile Survey123-App und direkt der Survey geöffnet werden.

   Hinweis:

   Wenn der Survey noch nicht auf Ihrem Gerät vorhanden ist, wird er heruntergeladen.

5. 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.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser

   Nun können Sie über die URL die mobile Survey123-App 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.

6. Definieren Sie einen Ort für eine Geopunkt-Frage im Survey, indem Sie Koordinaten zur URL hinzufügen:
   • Geben Sie &center= 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.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser&center=37.8199,-122.4783,20

   Nun erfolgt über die vollständige URL das Öffnen der mobilen Survey123-App 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 der mobilen App

Mit den folgenden Parametern kann das Öffnen der mobilen App angepasst werden:

Parameter	Beschreibung	Typ
center	Zentriert die Karte auf einen bekannten Breitengrad, Längengrad und optional eine Höhe. Beispiel: center=37.8199,-122.4783,20	Zeichenfolge
field:fieldname	Füllt Survey-Fragen mit Feldwerten. Beispiel: field:surname=Klauser	Zeichenfolge
portalUrl	Die URL zu dem Portal, in dem das Survey-Element gehostet wird. Beispiel: portalUrl=https://myorg.arcgis.com	Zeichenfolge
itemID	Das zu öffnende Formular. Beispiel: itemID=36ff9e8c13e042a58cfce4ad87f55d19	UUID
download	Lädt den Survey automatisch herunter, wenn das Gerät online ist. Die Standardeinstellung ist true. Beispiel: download=false	Boolesch
action	Gibt an, wie der Survey geöffnet wird. Unterstützte Werte: collect (Standardeinstellung), edit, view und copy. Beispiel: action=edit	Zeichenfolge
folder	Gibt den Ordner an, der beim Öffnen des Survey angezeigt wird. Unterstützte Werte sind inbox, drafts, outbox, sent und * (Ordner "Übersicht"). Fügen Sie der URL den Parameter filter hinzu, um die Surveys im angegebenen Ordner zu filtern. Geben Sie folder=* und den Parameter filter an, um die Surveys in allen Ordnern zu filtern und sie im Ordner "Übersicht" anzuzeigen. Beispiele: folder=inbox folder=*&filter=lake	Zeichenfolge
callback	Die URL, die zurückgegeben werden soll, wenn eine Formularaktion (z. B. Senden, Verschieben nach Entwürfe, Abbrechen oder Beenden) abgeschlossen wird. Beispiel: callback=https://quickcapture.arcgis.app	URL
callback:status	Gibt den Status des Survey bei aktiviertem Rückruf an. Unterstützte Werte für Status: cancel, draft, submit und close. Der Status close kann nur verwendet werden, wenn Folgendes gilt: action=view. Beispiel: callback:draft=https://quickcapture.arcgis.app	Zeichenfolge
filter	Filtert vorhandene Surveys auf dem Gerät, die mit einer Zeichenfolge übereinstimmen, die entweder im Instanznamen oder einem bestimmten Feld gefunden wurde. Filtert standardmäßig den Posteingang. Fügen Sie der URL den Parameter folder hinzu, um die Surveys in einem angegebenen Ordner zu filtern. Wenn ein Instanzname definiert wurde, geben Sie eine Zeichenfolge ein, die dem vollständigen Instanznamen oder einer Unterzeichenfolge des Instanznamen entspricht. In den folgenden Beispielen wird das Filtern nach allen Berichten mit dem vollständigen Instanznamen Klauser bzw. das Filtern nach allen Berichten in Entwürfe mit dem Wort lake im Instanznamen veranschaulicht. Beispiele: filter=Klauser filter=lake&folder=drafts Wenn kein Instanzname definiert ist oder Sie nach einem Feld filtern, das nicht Teil des Instanznamens ist, nehmen Sie sowohl den Feldnamen als auch den Feldwert filter=field:fieldname:fieldvalue auf. Es können nur Werte für ganze Felder mit dem Feld gefiltert werden. In den folgenden Beispielen wird das Filtern nach Berichten mit dem Gewässertyp River bzw. der Stationsnummer 5171 veranschaulicht. Beispiele: filter=field:waterbodytype:River filter=field:ws_stationnumber:5171	Zeichenfolge
update	Aktualisiert den Inhalt von Eingang und versucht, Surveys an den Ordner Ausgang zu übergeben. Wenn eine URL sowohl update als auch filter enthält, werden die Ordnerinhalte aktualisiert, bevor der Filter (auf vorhandene Surveys auf dem Gerät) angewendet wird. Die Standardeinstellung ist false. Beispiel: update=false	Boolesch
q:queryparameter	Fragt den Feature-Layer nach einem vorhandenen Datensatz ab. Der Parameter kann verwendet werden, um auf dem Gerät noch nicht vorhandene Inhalte abzurufen. Beispiele: q:where=ws_stationnumber=5171 q:where=waterbodytype='Lake' q:globalId=1d392670-33e2-456d-8435-7fad3abd8bb9	Zeichenfolge