Grundlegendes zu XLSForm

XLSForm ist ein offener Standard, der die Erstellung von Formularen vereinfacht. Die Erstellung erfolgt in einem leicht lesbaren Format in einer Tabelle. Weitere Informationen zu XLSForm finden Sie unter https://xlsform.org/. Survey123 unterstützt die meisten (jedoch nicht alle) Funktionen des XLSForm-Standards.

Für die Erstellung XLSForm-konformer Arbeitsblätter stehen zahlreiche Optionen zur Verfügung. Microsoft Excel wird am häufigsten verwendet, es gibt jedoch auch andere Optionen, wie beispielsweise Kingsoft Spreadsheets, Google Sheets oder OpenOffice Calc. Außerdem gibt es Online-Lösungen zur XForm-Erstellung, deren exportierte XLSForm-Arbeitsblätter mit ArcGIS Survey123 verwendet werden können.

Um Sie bei der Erstellung von Formularen zu unterstützen, steht in ArcGIS Survey123 ein Desktop-Werkzeug namens Survey123 Connect zur Verfügung, mit dem in Kombination mit dem XLSForm-Editor XLS-Dateien erstellt werden. Mit Survey123 Connect können Sie XLSForm-Dateien während der Erstellung oder Bearbeitung in der Vorschau anzeigen. Außerdem können mit diesem Werkzeug Formulare in ArcGIS Online und ArcGIS Enterprise veröffentlicht sowie Feature-Layers auf Basis der Formularspezifikation für die Datenerfassung erstellt werden. ArcGIS Survey123 Connect ist für Windows verfügbar.

Sobald Ihre Formulare in ArcGIS veröffentlicht wurden, können Sie sie auf der Survey123-Website für Mitglieder Ihrer ArcGIS-Organisationen freigeben. Außerdem können Sie Karten und Tabellen im Hinblick auf alle mit der mobilen Survey123-App erfassten Daten analysieren und die Survey-Ergebnisse exportieren.

In diesem Thema wird davon ausgegangen, dass Sie ArcGIS Survey123 Connect und Microsoft Excel zum Erstellen von Formularen verwenden.

Jede Excel-Arbeitsmappe enthält in der Regel zwei Arbeitsblätter: "survey" und "choices". Ein drittes Arbeitsblatt namens "settings" wird ebenfalls weiter unten beschrieben. Die Arbeitsblätter enthalten verschiedene obligatorische Spalten, die vorhanden sein müssen, damit das Formular funktioniert. Außerdem enthält jedes Arbeitsblatt eine Reihe von optionalen Spalten, mit denen das Verhalten der einzelnen Einträge im Formular noch präziser gesteuert werden kann. Für jeden Eintrag muss ein Wert in jeder der obligatorischen Spalten vorhanden sein, die optionalen Spalten können jedoch leer bleiben. Die Spalten, die Sie Ihrer Excel-Arbeitsmappe hinzufügen (egal ob obligatorisch oder optional), können in beliebiger Reihenfolge angeordnet werden. Sie können optionale Spalten weglassen und beliebig viele Zeilen leer lassen. Sämtliche .xls-Dateiformatierungen werden ignoriert, daher können Sie Trennlinien, Schattierung und andere Schriftartformatierungen einsetzen, um die Formulare übersichtlicher zu gestalten.

Arbeitsblatt "survey"

Dieses Arbeitsblatt verleiht Ihrem Formular seine grundlegende Struktur. Es enthält die vollständige Liste von Fragen sowie Informationen darüber, wie die Fragen im Formular dargestellt werden. In der Regel stellt jede Zeile eine Frage dar; es gibt jedoch weitere Features, die Sie dem Formular hinzufügen können, um die Benutzerfreundlichkeit zu verbessern; diese Features werden weiter unten beschrieben.

Das Arbeitsblatt "survey" umfasst drei obligatorische Spalten: "type", "name" und wahlweise "label" oder "hint".

  • In der Spalte "type" wird der Typ der XLSForm-Frage angegeben, die Sie hinzufügen. Für diese Spalte steht eine definierte Liste möglicher Fragetypen zur Verfügung.
  • Die Spalte "name" bestimmt den Namen des Feldes im Feature-Layer, in dem die Antworten auf die Frage gespeichert werden. In dieser Spalte sind keine Leerzeichen und Sonderzeichen zulässig. Namen müssen für alle Fragen in allen Layern eindeutig sein.
  • Die Spalten "label" und "hint" enthalten den Text für Ihre Fragen. Dies ist der Text, der im Formular angezeigt wird. Für eine Frage ist mindestens eine Beschriftung bzw. ein Hinweis erforderlich. Es empfiehlt sich, eine Beschriftung anzugeben, um Warnmeldungen zu vermeiden. In diesen Spalten sind Leerzeichen und Sonderzeichen zulässig. Alternativ können Sie Spalten mit Übersetzungen verwenden. Beschriftungen und Hinweise unterstützen auch eingeschränkten HTML-Code und Variablen, die im Survey durch die Antwort einer anderen Frage ersetzt werden. Weitere Informationen finden Sie unter Hinweise.

Einen Überblick über die Spalten im Survey-Arbeitsblatt finden Sie unter Spalten im Survey-Arbeitsblatt.

Arbeitsblatt "choices"

Auf diesem Arbeitsblatt werden die Antwortmöglichkeiten für Mehrfachauswahlfragen angegeben. Jede Zeile stellt eine Antwortmöglichkeit dar. Antwortmöglichkeiten mit dem gleichen Listennamen gelten als Teil eines verknüpften Satzes von Auswahlmöglichkeiten und werden zusammen für eine Frage angezeigt. Dies ermöglicht auch die Wiederverwendung eines Satzes von Wahlmöglichkeiten für mehrere Fragen (beispielsweise Ja/Nein-Fragen).

Das Arbeitsblatt "choices" hat drei obligatorische Spalten: "list name", "name" und "label".

  • Mithilfe der Spalte "list name" können Sie einen Satz verwandter Antwortmöglichkeiten gruppieren. Antwortmöglichkeiten mit dem gleichen Listennamen werden als Gruppe von Antworten für eine Frage dargestellt.
  • In der Spalte "name" wird der Wert angegeben, der in ArcGIS gespeichert wird. Für Werte in der Spalte "name" sind keine Sonderzeichen zulässig. Verwenden Sie in Auswahllisten für Elemente keine doppelten Namen. Weitere Informationen zu doppelten Namen von Auswahlelementen finden Sie unter Mehrfachauswahl.
  • In der Spalte "label" wird die Antwortmöglichkeit genauso angezeigt, wie sie im Formular dargestellt werden soll. Alternativ können Sie Spalten mit Beschriftungsübersetzungen verwenden.

Bei der Erstellung von Formularen in Excel muss eine präzise Syntax verwendet werden. Wenn Sie beispielsweise "Choices" oder "choice" anstelle von "choices" eingeben, funktioniert das Formular nicht.

Arbeitsblatt "settings"

Das Arbeitsblatt "settings" ist optional und ermöglicht Ihnen die weitere Anpassung von Formularen. Im Rahmen dieser Anpassung können Sie zum Beispiel einen Titel, der während der Bearbeitung des Formulars angezeigt wird, einen Instanznamen zum eindeutigen Identifizieren abgeschlossener Formulare, eine eindeutige Versionskennung für den Survey sowie weitere Funktionen festlegen. Weitere Informationen finden Sie unter Einstellungen.

Zusätzliche Arbeitsblätter

Die Survey123-Vorlagen umfassen Arbeitsblätter mit Eigenschaften, Operatoren und Funktionen, die Sie in Ihrem Formular verwenden können. Mithilfe dieser Arbeitsblätter können Sie außerdem die Dropdown-Listen und andere Datenvalidierungsregeln in den Arbeitsblättern "survey" und "settings" befüllen. Damit die Datenvalidierung erwartungsgemäß funktioniert, sollten Sie die Inhalte der zusätzlichen Arbeitsblätter nicht abändern.

Fragetypen

XLSForm unterstützt eine Reihe von Fragetypen. Wenn Sie zum Beispiel den Namen und die Position eines Geschäfts erfassen möchten, geben Sie Folgendes ein:

Text- und Geopunkt-Fragen in einem Formular

In der folgenden Tabelle ist aufgelistet, welche Fragen Sie in der Spalte "type" Ihres XLSForm eingeben können, welche Eingabe für die Frage akzeptiert wird und welcher Feldtyp im zugehörigen ArcGIS-Feature-Layer für diese Frage erstellt wird, wenn das Formular veröffentlicht wird. Der Survey-Autor kann den Feldtyp für viele dieser Fragetypen ändern. Weitere Informationen zu Feldtypen finden Sie unter Benutzerdefinierte Spalten von Esri.

FragetypAntworteingabeStandard-Feldtyp
integer

Eingabe einer ganzen Zahl.

esriFieldTypeInteger

decimal

Eingabe einer Dezimalzahl.

esriFieldTypeDouble

range

Eingabe für einen bestimmten Zahlenbereich.

esriFieldTypeInteger

text

Freitextantwort.

esriFieldTypeString

select_one list_name

Mehrfachauswahlfrage, für die der Benutzer nur eine Antwort auswählen kann. Ersetzen Sie list_name durch den Namen Ihrer Auswahlliste. Den Feldtyp können Sie ändern. Der Name der Auswahlmöglichkeit wird jedoch in der mobilen App immer als Zeichenfolge behandelt, wenn er in Ausdrücken verwendet wird.

esriFieldTypeString

select_multiple list_name

Mehrfachauswahlfrage, für die der Benutzer mehrere Antworten auswählen kann. Ersetzen Sie list_name durch den Namen Ihrer Auswahlliste. Den Feldtyp können Sie nicht ändern. Der Name der Auswahlmöglichkeit wird zudem in der mobilen App immer als Zeichenfolge behandelt, wenn er in Ausdrücken verwendet wird.

esriFieldTypeString

rank list_name

Rangfolgefrage; ordnet eine Liste mit Auswahlmöglichkeiten nach Rang. Ersetzen Sie list_name durch den Namen Ihrer Auswahlliste. Den Feldtyp können Sie nicht ändern. Der Name der Auswahlmöglichkeit wird zudem in der mobilen App immer als Zeichenfolge behandelt, wenn er in Ausdrücken verwendet wird.

esriFieldTypeString

note

Zeigt einen Hinweis auf dem Bildschirm an; unterstützt keine Eingaben. Es können auch ausgeblendete Berechnungen angezeigt werden.

esriFieldTypeString

geopoint

Erfasst einzelne GPS-Koordinaten. Den Feldtyp können Sie nicht ändern.

esriFieldTypeGeometry

geotrace

Erfasst eine Linie auf einer Karte. Den Feldtyp können Sie nicht ändern.

esriFieldTypeGeometry

geoshape

Erfasst ein Polygon auf einer Karte. Den Feldtyp können Sie nicht ändern.

esriFieldTypeGeometry

date

Datumseingabe.

esriFieldTypeDate

time

Zeiteingabe.

esriFieldTypeString

dateTime

Akzeptiert eine Datums- und Zeiteingabe.

esriFieldTypeDate

image

Foto aufnehmen.

Anlage

begin group

Beginnt eine Gruppe mit Fragen.

Nicht anwendbar

end group

Beendet eine Gruppe mit Fragen.

Nicht anwendbar

begin repeat

Beginnt einen Satz sich wiederholender Fragen.

Nicht anwendbar

end repeat

Beendet einen Satz sich wiederholender Fragen.

Nicht anwendbar

calculate

Führt eine Berechnung mit Werten aus dem Formular durch. Dieser Fragentyp ist ausgeblendet und wird im Formular nicht angezeigt.

esriFieldTypeString

username¹

Wenn Sie bei ArcGIS Online oder ArcGIS Enterprise angemeldet sind, wird dieses Feld automatisch mit dem Benutzernamen des Kontos ausgefüllt. Dieser Fragentyp ist ausgeblendet und wird im Formular nicht angezeigt.

esriFieldTypeString

email¹

Wenn Sie bei ArcGIS Online oder ArcGIS Enterprise angemeldet sind, wird dieses Feld automatisch mit der E-Mail-Adresse des Kontos ausgefüllt. Dieser Fragentyp ist ausgeblendet und wird im Formular nicht angezeigt.

esriFieldTypeString

hidden

Ein Feld, das nicht im Formular angezeigt wird. Verwenden Sie zur Angabe des Datenschemas die Spalten "bind::esri:fieldType" und "bind::esri:fieldLength".

esriFieldTypeString

barcode

Scannt einen Barcode.

esriFieldTypeString

start

Startdatum und -zeit des Survey.

esriFieldTypeDate

end

Enddatum und -zeit des Survey.

esriFieldTypeDate

deviceid

Von Survey123 generierte UUID zur Beschreibung des Geräts, mit dem der Survey ausgefüllt wurde. Diese ist nicht mit der IMEI (International Mobile Equipment Identity) zu verwechseln, da Survey123 auf Geräten ausgeführt wird, die möglicherweise keine IMEI haben.

esriFieldTypeString

audio

Zeichnet Audio auf.

Anlage

file

Es kann eine Datei auf das Gerät hochgeladen werden.

Anlage

¹Eine flexiblere Möglichkeit besteht darin, zum Abrufen von Werten die Funktion pulldata("@property") zu verwenden. Informationen hierzu finden Sie unter Geräte- und Benutzereigenschaften.

Das Beispielformular "Question Types" enthält alle von ArcGIS Survey123 unterstützten Fragetypen. Zusätzlich finden Sie in der Kurzübersicht Informationen zur Darstellung dieser Fragetypen im Survey123 Web Designer und der Web-App.

Metadaten

In XLSForm stehen die folgenden Datentypoptionen für die Erfassung von Metadaten zur Verfügung:

MetadatentypBeschreibung
start

Startdatum und -zeit des Survey.

end

Enddatum und -zeit des Survey.

username

Es wird der Benutzername des Benutzers aufgezeichnet, der aktuell bei ArcGIS Online oder ArcGIS Enterprise angemeldet ist. Dieser Datentyp unterstützt keine Eingaben.

email

Es wird die E-Mail-Adresse des Benutzers aufgezeichnet, der aktuell bei ArcGIS Online oder ArcGIS Enterprise angemeldet ist. Dieser Datentyp unterstützt keine Eingaben.

deviceid

Von Survey123 generierte UUID zur Beschreibung des Geräts, mit dem der Survey ausgefüllt wurde. Diese ist nicht mit der IMEI eines mobilen Geräts zu verwechseln, da Survey123 auf Geräten ausgeführt wird, die möglicherweise keine IMEI haben.

Hinweis:

Diese XLSForm-Metadatenelemente werden nicht unterstützt: "subscriberid", "simserial" und "phonenumber".

Um diese Metadaten zu erfassen, geben Sie Folgendes am Anfang Ihres Survey ein:

Metadatenfragen in einem Formular auswählen

Die oben beschriebenen Metadateneinträge werden automatisch von ArcGIS Survey123 erfasst. Sie werden nicht als Fragen im Formular dargestellt; die Werte werden angezeigt, sobald der Survey übermittelt wurde.

Wenn Sie den Typ "start" oder "end" hinzufügen, wird von ArcGIS Survey123 automatisch die Zeitfunktion des Feature-Layers für den Survey aktiviert. Auf diese Weise können Sie den Inhalt des Survey basierend auf dem Datum filtern, an dem die Daten gesendet wurden. Das Hinzufügen der Einträge "start" und "end" ist ebenfalls nützlich, wenn Sie wissen möchten, wie viel Zeit genau zwischen dem Öffnen des Formulars und der Markierung als abgeschlossen verstrichen ist.

Hinweise

Manchmal möchten Sie einer Frage in einem Formular einen Hinweis hinzufügen, in dem Sie den Benutzer darauf hinweisen, wie er die Frage beantworten soll, ohne diesen Hinweis jedoch zu einem Teil der eigentlichen Frage zu machen. Sie können Hinweise zu Fragen in XLSForm hinzufügen. Fügen Sie die Spalte "hint" hinzu, und geben Sie die Hinweisnachricht ein. Hier ein Beispiel:

Hinweise zu Fragen in einem Formular

Mithilfe der Spalte guidance_hint können Sie zudem Hinweise zur Anleitung hinzufügen. Hinweise zur Anleitung geben dem Benutzer weitere Anweisungen zur Beantwortung einer Frage, werden aber ausgeblendet, bis der Benutzer auf die Schaltfläche für den Hinweis zur Anleitung klickt, die neben dem Hinweis angezeigt wird. Hinweise zur Anleitung können nur verwendet werden, wenn bereits ein Hinweis für die Frage existiert.

Frage mit einem Hinweis und einem Hinweis zur Anleitung

Platzhaltertext

Für Fragen, die eine typisierte Eingabe akzeptieren (wie zum Beispiel Fragen des Typs "text", "integer" und "decimal" und des Typs "select_one" mit automatischer Vervollständigung des Aussehens) können Sie mit dem Parameter placeholderText in der Spalte body::esri:style auch einen Platzhaltertext angeben. Bei Verwendung von placeholderText=@[hint] oder placeholderText=@[guidance_hint] wird der Hinweis oder Hinweis zur Anleitung ausgeblendet, und der Hinweistext wird stattdessen im Eingabebereich der Frage platziert. Wenn die Frage leer ist, wird Platzhaltertext im Eingabebereich angezeigt.

Hinweis:

Hinweise werden für Fragen des Typs "begin repeat" und "begin group" nicht unterstützt.

Platzhaltertexte werden in der Survey123-Web-App nicht unterstützt.

Aktualisieren der Vorlage

Die Vorlage "Advanced" enthält alle XLSForm-Features, die in Survey123 unterstützt werden, und ist im Dialogfeld Neuer Survey in Survey123 Connect verfügbar. Diese Vorlage wird regelmäßig aktualisiert: Neue Funktionen werden hinzugefügt, und die Erstellungsfunktionen des Survey werden erweitert. Sie können vorherige Vorlagenversionen weiterverwenden. Es empfiehlt sich jedoch, vorhandene Surveys auf die neueste XLSForm-Vorlage zu aktualisieren, um von den neuesten Änderungen zu profitieren.

Das Werkzeug XLSForm-Vorlage aktualisieren aktualisiert das vorhandene XLSForm für einen Survey auf die neueste Version der Vorlage "Advanced". Hierzu wird der Inhalt der Arbeitsblätter survey, choices und settings in die entsprechenden Zeilen und Spalten in der neuen Vorlage kopiert. Alle von Ihnen hinzugefügten Spalten werden ebenfalls in die neue Vorlage kopiert, ebenso wie das Arbeitsblatt external_choices, sofern Sie externe Auswahllisten verwenden.

Zum Ausführen des Werkzeugs müssen Sie eine Python-Umgebung in Survey123 Connect konfigurieren. Weitere Informationen finden Sie unter Konfigurieren von Python.

Öffnen Sie den Survey, den Sie aktualisieren möchten, in Survey123 Connect. Klicken Sie auf Werkzeuge und dann auf XLSForm-Vorlage aktualisieren. In einem Dialogfeld werden Meldungen angezeigt, während das Werkzeug ausgeführt wird. Nach Abschluss des Prozesses wird die .xlsx-Datei im Survey-Ordner auf die neuste Vorlage aktualisiert, und die Formularvorschau in Survey123 Connect wird erneut geladen. Tritt während der Werkzeugausführung ein Fehler auf, wird das vorhandene XLSForm beibehalten.

Hinweis:

Das XLSForm des Survey muss in einer .xlsx-Datei enthalten sein. Das Werkzeug XLSForm-Vorlage aktualisieren kann nicht für .xls-Dateien ausgeführt werden.

Sie sollten unbedingt überprüfen, ob die Spalten, die Datenvalidierung, die Zellenformatierung und die Schriftschnitte aus dem ursprünglichen XLSForm im aktualisierten XLSForm enthalten sind. Das Werkzeug erstellt eine Sicherung des vorhandenen XLSForm sowie eine Protokolldatei im Verzeichnis C:\Users\<username>\ArcGIS\My Survey Designs\<surveyName>\debug\template_updater. Wenn Sie einen Survey aus einer Sicherung wiederherstellen möchten, kopieren Sie die .xlsx-Datei aus dem Ordner template_updater in den Stammordner des Survey. Löschen Sie das vorhandene XLSForm, und ändern Sie den Namen der Sicherung in den des Originals.

Hinweis:

Die Füllfarbe der Zelle in der ersten Spalte jeder Zeile wird auf die gesamte Zeile in der aktualisierten Vorlage angewendet.

Bei mehrsprachigen Surveys werden Spalten von Standardsprachen, z. B. label::language (xx) und hint::language (xx), aus der aktualisierten Vorlage ausgeschlossen.