XLSForm unterstützt Fragen vom Typ "select_one" (nur eine Antwort kann ausgewählt werden), vom Typ "select_multiple" (mehrere Antworten können ausgewählt werden) und vom Typ "rank" (eine Liste mit Auswahlmöglichkeiten ordnen). Wenn Sie eine Mehrfachauswahlfrage erstellen möchten, müssen Sie der Excel-Arbeitsmappe das Arbeitsblatt "choices" hinzufügen. Nachfolgend sehen Sie ein Beispiel für eine Frage vom Typ "select_one":
Beachten Sie, dass die Angabe für "yes_no" im Arbeitsblatt "survey" mit der Angabe für "yes_no" in der Spalte "list name" des Arbeitsblattes "choices" übereinstimmen muss. Hierdurch wird sichergestellt, dass im Formular die richtige Liste mit Antwortmöglichkeiten für eine bestimmte Frage angezeigt wird.
Nach Veröffentlichung eines Survey werden die Auswahlmöglichkeiten in Fragen vom Typ "select_one" standardmäßig als Domänen mit codierten Werten zum Feature-Layer des Survey hinzugefügt. Sie können die Erstellung von Domänen während des Veröffentlichungsprozesses deaktivieren. Weitere Informationen finden Sie unter Veröffentlichungsoptionen.
Wenn Sie die Auswahlmöglichkeiten für Fragen vom Typ "select_one" ändern und den Survey erneut veröffentlichen, wird in Survey123 Connect eine Zusammenfassung der Änderungen angezeigt. Zudem können Sie angeben, ob diese Änderungen auf die Domänen im Feature-Layer angewendet werden sollen. Weitere Informationen finden Sie unter Aktualisieren eines Survey.
Vorsicht:
Die folgenden Einschränkungen gelten bei Verwendung einer Auswahlliste mit doppelten Namen von Auswahlelementen:
- Doppelte Namen von Auswahlelementen werden für Fragen vom Typ "select_multiple" nicht unterstützt.
- Doppelte Namen von Auswahlelementen werden für mehrsprachige Surveys nicht unterstützt.
- Die Funktion jr:choice-name() gibt die Beschriftung der ersten doppelten Auswahl in der Liste zurück.
- Wenn Fragen vom Typ "select_one" über die Ordner Eingang, Entwürfe, Ausgang, Gesendet oder Übersicht geöffnet werden, werden sie auf die erste doppelte Auswahl in der Liste zurückgesetzt.
Sie können auch Mehrfachauswahlfragen hinzufügen, für die mehrere Antworten ausgewählt werden können, wie zum Beispiel die folgende:
Diese Auswahloptionen werden standardmäßig in der Reihenfolge angezeigt, die im Arbeitsblatt "choices" angegeben ist. Sie können stattdessen festlegen, dass diese Auswahloptionen in zufälliger Reihenfolge angezeigt werden, indem Sie randomize=true in der Spalte "parameters" eingeben.
Vorsicht:
Alle in einer Frage vom Typ "select_multiple" oder in einer Rangfolgefrage erfassten Werte werden als kommagetrennte Liste gespeichert, daher sollten Sie keine Kommas in der Namensspalte Ihrer Auswahlliste verwenden. Beachten Sie auch, dass bei Fragen vom Typ "select_multiple" oder Rangfolgefragen nur der Name einer Auswahlmöglichkeit an den Feature-Layer übermittelt wird, nicht der Name und die Beschriftung wie bei Fragen vom Typ "select_one".
Der Wert für eine Frage vom Typ "rank" bleibt leer, bis die Reihenfolge der Optionen durch den Benutzer geändert wird. Wenn ein Standardwert festgelegt wurde, wird die Standardreihenfolge verwendet, wenn die Reihenfolge der Optionen durch den Benutzer nicht geändert wird.
Mit der Funktion selected-at kann eine einzelne Antwort für eine Frage vom Typ "select_multiple" zurückgegeben werden. Mit Folgendem wird der Namenswert für die erste Antwort auf eine Frage vom Typ "select_multiple"zurückgegeben:
selected-at(${species}, 0)
Um die Beschriftung für eine Antwort zu senden, können Sie die Funktion jr:choice-name verwenden. Verwenden Sie Folgendes, um den Beschriftungswert für die zweite Antwort auf die gleiche Frage vom Typ "select_multiple" abzurufen:
jr:choice-name(selected-at(${species}, 1), '${species}')
Andere angeben
Für Mehrfachauswahlfragen können Surveys eine Option zur Auswahl von "Andere" enthalten, wenn die gewünschte Auswahlmöglichkeit nicht aufgeführt wird. Anschließend kann der Teilnehmer aufgefordert werden, nähere Angaben zu "Andere" zu machen. Sie können dies in XLSForm entweder mit einer manuellen Methode oder der integrierten Methode tun. Die integrierte Methode ist schneller und leichter zu konfigurieren als die manuelle Methode, aber sie hat einige Einschränkungen.
Manuelle Methode
Die manuelle Methode wird empfohlen, weil sie es Ihnen ermöglicht, den Namen und die Beschriftung der anderen Auswahl und den Namen und die Beschriftung der Textfrage anzugeben, die die andere Antwort erfasst. Sie können Übersetzungen für diese Namen und Beschriftungen zur Verfügung stellen. Sie können auch Einschränkungen und Aussehen für die Textfrage übernehmen und sie als erforderlich festlegen.
Fügen Sie zuerst eine Auswahl Andere zu der Auswahlliste für die Frage auf dem Arbeitsblatt "choices" hinzu. Geben Sie einen Namen und eine Beschriftung für diese Auswahl an, wie Sie es für jede andere Auswahl in der Liste tun würden. Im folgenden Beispiel hat die Auswahlliste Farbe eine Auswahl mit dem Namen Andere.
Fügen Sie auf dem Arbeitsblatt "survey" eine Textfrage hinzu, um die andere Antwort zu erfassen. Fügen Sie einen relevanten Ausdruck hinzu, damit die Textfrage nur relevant ist, wenn die Auswahl "Andere" ausgewählt ist. In dem folgenden Beispiel ist die Frage other_color relevant, wenn die Antwort auf die Frage des Typs "select_one" Andere ist.
Für mehrsprachige Surveys können die Fragen und Auswahlmöglichkeiten übersetzt werden. Im folgenden Beispiel werden auf dem Arbeitsblatt "survey" französische und griechische Übersetzungen für die Frage vom Typ "select_one" und für die Textfrage bereitgestellt.
Auch auf dem Arbeitsblatt "choices" werden Übersetzungen bereitgestellt, unter anderem auch für die Auswahl Andere.
Integrierte Methode
Mit dieser Methode erstellt Survey123 Connect automatisch die Auswahlmöglichkeit "Andere" und die Frage zur Erfassung der entsprechenden Antwort. Um diese Methode zu verwenden, geben Sie or_other nach dem Namen der Auswahlliste in der Spalte type im Arbeitsblatt "survey" ein. Eine Option Andere wird in der Auswahlliste für diese Frage angezeigt. Wird die Auswahlmöglichkeit Andere gewählt, wird die Frage Andere angeben angezeigt, damit Benutzer eine eigene Antwort angeben können. Um diese Antwort zu speichern, erstellt Survey123 Connect automatisch ein zusätzliches Feld im Feature-Layer und verwendet dafür den Namen Ihrer Frage mit Mehrfachauswahl, gefolgt von _other, also z. B. favorite_toppings_other. Hier ein Beispiel:
Vorsicht:
Die Beschriftung für die Frage Andere angeben wird nur in Englisch angezeigt.
Wenn Sie einen Survey aus einem bestehenden Feature-Layer erstellen, wird das Feld für die Frage Andere angeben nicht automatisch erstellt, und der Survey wird nicht veröffentlicht. Sie müssen das Feld für die Frage Andere angeben manuell im Feature-Layer erstellen. Verwenden Sie dazu den Namen der Mehrfachauswahlfrage, gefolgt von _other, also z. B. favorite_toppings_other.
Externe Auswahllisten
Sie können Auswahllisten für Fragen vom Typ "select_one" und "select_multiple" in einer externen .csv-Datei speichern. Ideal ist dies für sehr große Auswahllisten, Surveys mit mehreren Auswahllisten und für Auswahllisten, die außerhalb von Survey123 verwaltet werden. Externe Auswahllisten, die in diesem Fall Listen externer Auswahlmöglichkeiten sind, dürfen nicht mit Externen Auswahllisten, bei denen die Auswahlmöglichkeiten in einem zusätzlichen Arbeitsblatt aufgelistet werden müssen, verwechselt werden.
Die .csv-Datei muss die Spalten "name" und "label" enthalten.
Hinweis:
Wenn in der .csv-Datei eine Spaltenüberschrift fehlt oder am Ende der Zeilen ein nachgestelltes Komma vorhanden ist, wird die Datei nicht in den Survey importiert.
Sie erzielen die besten Ergebnisse, wenn Sie die .csv-Datei mit UTF-8-Zeichencodierung codieren. Wenn Sie zur Erstellung der Microsoft Excel-Datei .csv verwenden, müssen Sie sie als CSV UTF-8 abspeichern.
Übersetzte Beschriftungsspalten können in der .csv-Datei enthalten sein. Übersetzte Auswahlmöglichkeiten dagegen werden nur in Survey123 Connect und der mobilen Survey123-App angezeigt, nicht jedoch in der Survey123-Web-App.
Um eine Frage mit einer externen Auswahlliste einzufügen, müssen Sie den Fragetyp "select_one_from_file" oder "select_multiple_from_file" und dann den Namen der .csv-Datei eingeben, zum Beispiel: select_one_from_file CoverType.csv. Bei Dateinamen wird die Groß-/Kleinschreibung beachtet, und sie dürfen keine Leerzeichen enthalten.
Eine .csv-Datei kann auf zwei Arten eingebunden werden: Sie können die Datei im Ordner media des Survey speichern oder eine in ArcGIS gehostete .csv-Datei verknüpfen.
Tipp:
Führen Sie das Werkzeug Auswahllisten in CSV konvertieren aus, um die Migration von Auswahllisten aus dem Arbeitsblatt "choices" in .csv-Dateien zu automatisieren.
Verknüpfen einer CSV-Datei
Gehen Sie wie folgt vor, um eine .csv-Datei aus den ArcGIS-Inhalten mit einem Survey zu verknüpfen:
- Vergewissern Sie sich, dass die .csv-Datei in ArcGIS Online oder ArcGIS Enterprise gehostet wird und dieselben Freigabeberechtigungen wie der Survey besitzt.
- Stellen Sie sicher, dass der Survey in ArcGIS veröffentlicht wurde, bevor Sie versuchen, den Inhalt zu verknüpfen.
- Öffnen Sie in Survey123 Connect den Survey, und klicken Sie auf die Registerkarte Verknüpfte Inhalte. klicken Sie auf die Schaltfläche Inhalt verknüpfen, und wählen Sie CSV aus. Navigieren Sie zu der zu verknüpfenden .csv-Datei, und wählen Sie sie aus.
Damit in der Formularvorschau die Auswahlmöglichkeiten aus der verknüpften .csv-Datei angezeigt werden, müssen Sie in Survey123 Connect auf der Registerkarte Verknüpfte Inhalte auf die Schaltfläche "Herunterladen" 
klicken. Eine Kopie der .csv-Datei wird im Medienordner des Survey abgelegt. Verknüpfte Dateien werden automatisch mit dem Survey in der mobilen Survey123-App heruntergeladen.
Wenn Sie die .csv-Datei manuell im Medienordner des Survey ablegen und später eine .csv-Datei mit demselben Namen in ArcGIS hochladen und mit dem Survey verknüpfen, wird die .csv-Datei im Survey mit dem verknüpften Inhalt aktualisiert (sofern dieser neueren Datums ist).
Konvertieren von Auswahllisten in CSV
Führen Sie in Survey123 Connect das Werkzeug Auswahllisten in CSV konvertieren aus, um angegebene Auswahllisten automatisch aus dem Arbeitsblatt "choices" in neue .csv-Dateien, die im Medienordner gespeichert werden, zu migrieren. Des Weiteren werden die zugehörigen Fragen im Arbeitsblatt "survey" vom Werkzeug geändert, sodass die Fragetypen "select_one_from_file" und "select_multiple_from_file" verwendet werden.
Gehen Sie wie folgt vor, um das Werkzeug auszuführen:
- Konfigurieren Sie in Python eine Survey123 Connect-Umgebung, um das Ausführen des Werkzeugs zu ermöglichen. Weitere Informationen finden Sie unter Konfigurieren von Python.
- Öffnen Sie das XLSForm des Survey. Fügen Sie im Arbeitsblatt choices eine Spalte namens esri_tool_convert_csv hinzu. Fügen Sie für jede der Auswahllisten, die in externe Auswahllisten konvertiert werden sollen, mindestens einer Zeile den Wert yes hinzu. Speichern und schließen Sie die Datei.
- Öffnen Sie in Survey123 Connect den Survey, klicken Sie auf Werkzeuge, und wählen Sie Auswahllisten in CSV konvertieren aus.
Im Anschluss an die Konvertierung wird für jede migrierte Auswahlliste eine .csv-Datei im Ordner "media" gespeichert. Der Dateiname entspricht dem ursprünglichen Namenswert der Auswahlliste (Spalte "list_name"). Das Arbeitsblatt "choices" wird aktualisiert, sodass es lediglich die verbleibenden, nicht migrierten Listen enthält. Es enthält weiterhin alle benutzerdefinierten Spaltenüberschriften der Originalversion. Im Arbeitsblatt "survey" werden die entsprechenden Fragen vom Typ "select_one" und "select_multiple" in den Typ "select_one_from_file" und "select_multiple_from_file" geändert, sodass die neuen externen Auswahllisten referenziert werden. Die Originalversion des Arbeitsblattes "choices" wird in dem Arbeitsblatt "choices_backup" gespeichert, damit Sie die Ergebnisse überprüfen und ggf. zurücksetzen können. Das Sicherungsarbeitsblatt können Sie beibehalten oder löschen.
Das Werkzeug konvertiert keine Auswahllisten, die in Fragen des Typs "rank", in Gruppen vom Typ "table-list" oder in Fragen mit dem Aussehen "search" verwendet werden. Keine der Fragen, in denen derartige Auswahllisten verwendet werden, werden im Survey geändert.
Wenn vom Werkzeug nicht unterstützte Fragen erkannt werden, wird im Debugging-Ordner eine .xlsx-Datei erstellt, die die Namen der betroffenen Auswahllisten enthält. Diese Datei finden Sie im folgenden Ordner:
C:\Users\<username>\ArcGIS\My Survey Designs\<surveyName>\debug\convertchoicelists