ArcGIS Survey123 unterstützt einen Großteil der XLSForm-Spezifikation. Diese Kurzanleitung enthält eine Zusammenfassung der XLSForm-Features, die Sie in Survey123 verwenden können. Sie können Surveys entweder in Survey123 Connect oder auf der Survey123-Website erstellen; einige Funktionen sind jeweils nur in einer der Varianten, einige sind in beiden verfügbar.
Fragetypen
In der folgenden Tabelle werden die Fragetypen beschrieben, die in Survey123 Connect, in der mobilen Survey123-App, im Survey123 Web Designer und in der Survey123-Web-App verfügbar sind. Bei einigen Fragen gibt es Unterschiede hinsichtlich Verhalten und Implementierung auf den verschiedenen Plattformen. Informationen zu den Unterschieden sind den Hinweisen unter der Tabelle zu entnehmen.
| Survey123 Connect-Fragetyp | Survey123 Web Designer-Fragetyp | Beschreibung | In der mobilen Survey123-App unterstützt | In der Survey123-Web-App unterstützt |
|---|---|---|---|---|
| audio⁴ | Audio⁴ ⁶ | Zeichnet eine Audiodatei in der mobilen App auf. Zeichnet in der Web-App eine Audiodatei auf oder akzeptiert eine hochgeladene Audiodatei. | Ja | Ja |
| barcode | Scannt einen Barcode oder QR-Code. | Ja | Ja | |
| begin group | Beginnt eine Gruppe mit Fragen. | Ja | Ja | |
| begin repeat | N. z. | Beginnt einen Satz sich wiederholender Fragen. | Ja | Ja |
| Berechnen | N. z. | Führt eine Berechnung mit Werten aus dem Formular durch. Das Feld "calculate" enthält das Ergebnis der Berechnung. | Ja | Ja |
| decimal¹ | Eingabe einer Dezimalzahl. | Ja | Ja | |
| date | Datumseingabe. | Ja | Ja | |
| dateTime | Datums- und Zeiteingabe. | Ja | Ja | |
| deviceid | N. z. | UUID zur Beschreibung des Geräts, mit dem der Survey aufgenommen wurde. | Ja | Nein |
| email² | N. z. | Wenn Sie mit einem Organisationskonto angemeldet sind, wird diese Frage automatisch mit der E-Mail-Adresse des Kontos ausgefüllt. | Ja | Ja |
| Ende | N. z. | Enddatum und -zeit des Survey. | Ja | Ja |
| end group | Beendet eine Gruppe mit Fragen. | Ja | Ja | |
| end repeat | N. z. | Beendet einen Satz sich wiederholender Fragen. | Ja | Ja |
| Datei | Akzeptiert eine Datei auf dem Gerät. | Ja | Ja | |
| geopoint³ | Erfasst eine angegebene GPS-Koordinate. Standardmäßig wird die aktuelle Position verwendet. | Ja | Ja | |
| geoshape³ | Erfasst ein Polygon auf einer Karte. | Ja | Ja | |
| geotrace³ | Erfasst eine Linie auf einer Karte. | Ja | Ja | |
| hidden | N. z. | Erstellt ein Feld in Ihrem Feature-Layer, das nicht im Formular angezeigt wird. Verwenden Sie zum Festlegen des Datenschemas für das Feld die Spalten bind::esri:fieldType und bind::esri:fieldLength. | Ja | Ja |
| integer¹ | Eingabe einer ganzen Zahl. | Ja | Ja | |
| image | Es kann entweder ein auf dem Gerät gespeichertes Bild oder ein direkt aufgenommenes Foto verwendet werden. | Ja | Ja | |
| note | Zeigt Text auf dem Bildschirm an. In Hinweisen können auch ausgeblendete Berechnungen verarbeitet werden. | Ja | Ja | |
| range | Schieberegler⁶ | Eingabe für einen bestimmten Zahlenbereich. | Ja | Ja |
| rank list_name | Rangfolgefrage; ordnet eine Liste mit Auswahlmöglichkeiten. Ersetzen Sie list_name durch den Namen der Auswahlliste. | Ja | Ja | |
| select_one list_name | Dropdown⁵ ⁶, Likert-Skala⁵ ⁶, Bewertung⁶, Einzelauswahl⁶, Einfachauswahltabelle⁶ | Mehrfachauswahlfrage; es kann nur eine Antwort ausgewählt werden. Ersetzen Sie list_name durch den Namen der Auswahlliste. | Ja | Ja |
| select_one_from_file file_name.csv | N. z. | Mehrfachauswahlfrage; es kann nur eine Antwort ausgewählt werden. Ersetzen Sie file_name.csv durch den Namen der Datei im Medienordner des Survey, in der die Liste der Auswahlmöglichkeiten enthalten ist. | Ja | Ja |
| select_multiple list_name | Mehrfachauswahlfrage; es können mehrere Antworten ausgewählt werden. Ersetzen Sie list_name durch den Namen der Auswahlliste. | Ja | Ja | |
| select_multiple_from_file file_name.csv | N. z. | Mehrfachauswahlfrage; es können mehrere Antworten ausgewählt werden. Ersetzen Sie file_name.csv durch den Namen der Datei im Medienordner des Survey, in der die Liste der Auswahlmöglichkeiten enthalten ist. | Ja | Ja |
| Start | N. z. | Startdatum und -zeit des Survey. | Ja | Ja |
| Text | Adresse⁶, E-Mail⁶, Mehrzeiliger Text⁵ ⁶, Einzeiliger Text⁶, Website⁶ | Freitextantwort. Ein regulärer Ausdruck wird auf E-Mail und Website angewendet. Das Aussehen "Geocode" wird auf Adresse angewendet. | Ja | Ja |
| Zeit | Zeiteingabe. | Ja | Ja | |
| username | N. z. | Wenn Sie mit einem Organisationskonto angemeldet sind, wird diese Frage automatisch mit dem Kontobenutzernamen ausgefüllt. | Ja | Ja |
¹Der Web Designer kombiniert Integer- und Dezimalfragen zu einem einzigen Fragetyp namens "Zahl". Über ein Kontrollkästchen in den Frageeigenschaften kann im Survey-Designer festgelegt werden, welche Eingaben erforderlich sind.
²Die in Survey123 Connect und im Survey123 Web Designer verfügbaren E-Mail-Fragetypen werden unterschiedlich implementiert. In Survey123 Connect wird die Frage automatisch mit der E-Mail-Adresse des Organisationskontos gefüllt, bei dem der Benutzer angemeldet ist. Dieser Fragetyp ist im Survey123 Web Designer hingegen ein Textfeld, das nur eine Formatierung in Form einer E-Mail-Adresse akzeptiert.
³Geopunkt-, Geotrace- und Geoshape-Fragen wurden zu einem einzigen Fragetyp namens "Karte" kombiniert. Über ein Kontrollkästchen in den Frageeigenschaften kann im Survey-Designer festgelegt werden, welche Eingaben erforderlich sind. Ein zusätzlicher Fragetyp namens "Adresse" ermöglicht das Übermitteln geokodierter Punkte.
⁴Audiofragen können in der mobilen Survey123-App nicht wie in der Web-App hochgeladen werden. Wenn Sie das Hochladen von Audios in der mobilen App ermöglichen möchten, verwenden Sie eine Dateifrage.
⁵Mehrere in Survey123 Connect verfügbare Aussehen stehen im Survey123 Web Designer als separate Fragetypen zur Verfügung. Dazu zählen mehrzeiliger Text, Dropdown und Likert-Skala.
⁶Für jede Frage stellt der Web Designer eine Option zum Cachen der Antwort bereit. In der Web-App wird die Antwort auf die Frage nach Übermittlung eines Survey-Datensatzes im Browser gecacht und vorab in die nächste Übermittlung geladen, die für diesen Survey auf dem Gerät durchgeführt wird. Das Cachen einer Antwort kann für alle Fragetypen festgelegt werden, Audio-, Bild-, Dateiupload- und Unterschriftsfragen ausgenommen.
Standardwerte
Bei den meisten Fragetypen können Sie eine Standardantwort definieren, die beim Laden des Survey automatisch verwendet wird. Diese erfüllt denselben Zweck wie die Spalte default im XLSForm.
Datenvalidierung
Durch die Aktivierung von Dies ist eine erforderliche Frage auf der Registerkarte Bearbeiten muss die Survey-Frage einen Wert enthalten, bevor das Formular ausgefüllt werden kann.
Die meisten Fragen verfügen außerdem über Funktionen zum Festlegen einer minimalen und maximalen Länge. Dadurch können Surveys nicht gesendet werden, wenn die Antwort auf die Frage sich nicht innerhalb der festgelegten Grenzwerte befindet. Diese Funktion übernimmt dieselbe Rolle wie die Spalten constraint oder bind::esri:fieldLength in der XLSForm-Spezifikation von Survey123.
Sonderzeichen
Namen von Fragen und Auswahlelementen dürfen keine Sonderzeichen wie Leerzeichen, Kommas, Bindestriche, runde und eckige Klammern oder andere Sonderzeichen wie $, % und # enthalten. Wichtig ist, dass Namen von Auswahlelementen für Fragen mit Mehrfachauswahl keine Leerzeichen oder Kommas enthalten.