Survey123 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).
Hinweis:
Rangfolgefragen werden derzeit nur in der mobilen App und der Web-App unterstützt.
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":
Der Listenname "yes_no" im Arbeitsblatt "survey" muss mit dem Listennamen im Arbeitsblatt "choices" übereinstimmen. 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.
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.
Weitere Informationen zu Überlegungen beim Ändern von Auswahllisten in vorhandenen Surveys finden Sie unter Aktualisieren eines Survey.
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}')
Aussehen
Wenn Sie die Spalte appearance auf minimal festlegen, wird eine Auswahlfrage in einem Dropdown-Menü dargestellt.
Wenn Sie appearance auf horizontal festlegen, werden die Auswahlmöglichkeiten für eine Einfachauswahlfrage horizontal in Spalten gleicher Breite dargestellt.
Das Aussehen compact ähnelt dem Aussehen horizontal, verwendet jedoch eine andere Methode zum Bestimmen von Spaltenbreiten, die möglicherweise dazu führen, dass Auswahlmöglichkeiten weniger Platz benötigen.
Hinweis:
In Survey123 Connect können Sie eine maximale Anzahl an Spalten für das Aussehen compact angeben, indem Sie eine Zahl bereitstellen, die durch einen Bindestrich getrennt ist. Durch compact-3 wird die Frage beispielsweise für Mehrfachauswahlfragen in Surveys, die mit der mobilen App oder der Web-App verwendet werden, auf maximal drei Spalten begrenzt.
Das Aussehen compact und das Aussehen horizontal-compact sind identisch. In der Survey123-Web-App werden bei diesen Aussehentypen die Auswahlbeschriftungen für eine Einfachauswahlfrage nebeneinander in Zeilen ohne zusätzlichen Zwischenraum dargestellt.
Wenn Sie für eine Einfachauswahlfrage die Spalte appearance auf likert festlegen, werden die Auswahlmöglichkeiten als Likert-Skala dargestellt. Eine Likert-Skala ist eine Bewertungsskala, die es den Teilnehmern ermöglicht, auf einer symmetrischen Skala anzugeben, inwieweit sie einer Aussage zustimmen oder nicht zustimmen.
Wenn Sie appearance auf autocomplete festlegen, wird eine Einfachauswahlfrage mit einem Textfeld und einem Dropdown-Menü dargestellt. Durch Eingabe von Text in das Feld wird das Dropdown-Menü auf Antworten beschränkt, die den eingegebenen Text enthalten. Dies ist bei sehr langen Listen mit Antwortmöglichkeiten nützlich.
Hinweis:
Das Aussehen autocomplete für Mehrfachauswahlfragen wird nur in Survey123 Mobile unterstützt. In der mobilen App oder der Web-App wird es nicht unterstützt.
Wenn Sie appearance auf search festlegen, können Sie die Auswahlliste für eine Auswahlfrage mit Werten aus einer CSV-Tabelle im Ordner media des Survey oder einem vorhandenen Feature-Layer bzw. einer vorhandenen Tabelle füllen. Weitere Informationen finden Sie unter Erstellen einer dynamischen Auswahlliste mithilfe des Aussehens "search".
Wenn Sie appearance auf image-map festlegen, kann eine Auswahlfrage mithilfe einer SVG-Datei in der mobilen App als Bild mit auswählbare Regionen als Auswahloptionen dargestellt werden. Weitere Informationen finden Sie unter Arbeiten mit SVG-Dateien.
Erstellen einer dynamischen Auswahlliste mithilfe des Aussehens "search"
Hinweis:
In diesem Abschnitt werden Funktionen beschrieben, die nur in Survey123 Connect und der mobilen Survey123-App verfügbar sind. Diese Funktionen sind nicht in Survey123 Studio oder Survey123 Mobile verfügbar.
Einfachauswahl- und Mehrfachauswahlfragen unterstützen das Aussehen search, das zum Füllen der Auswahlliste mit Werten aus einer CSV-Tabelle im Ordner media des Survey oder einem vorhandenen Feature-Layer bzw. einer vorhandenen Tabelle verwendet werden kann. Bei Verwendung des Aussehens search müssen Sie noch einen Eintrag im Arbeitsblatt "choices" einfügen. Anstatt aber alle Auswahlmöglichkeiten aufzulisten, müssen Sie im vorhandenen Feature-Layer bzw. der Tabelle den Feldnamen referenzieren.
Im folgenden Beispiel wird im Arbeitsblatt "choices" die Auswahlliste us_states definiert, in der das Feld STATE_NAME als Name und Beschriftung der Auswahlmöglichkeit verwendet wird.
Im folgenden Beispiel wird diese Auswahlliste im Arbeitsblatt "survey" zwar wie jede andere Auswahlliste referenziert, sie enthält aber den Ausdruck für das Aussehen "search", der den vorhandenen Feature-Layer, aus dem die Auswahlmöglichkeiten abgerufen werden sollen, referenziert.
Der Ausdruck für das Aussehen "search" muss wie folgt strukturiert sein, wobei die Variablen durch Komma voneinander getrennt werden müssen:
search(tableName, searchType, searchColumn, searchText, filterColumn, filterText)Der Parameter tableName akzeptiert entweder den Namen der .csv-Datei im Ordner media des Survey, zum Beispiel airports, oder die URL eines Feature-Layers oder Kartenservice-Layers, der ein Name für Survey123 vorangestellt ist, um die Tabelle intern zu referenzieren. Dieser Tabellenname muss nicht mit dem Namen des gehosteten Layers übereinstimmen. Da aber Survey123 auf diese Art Ihre Suche intern referenziert, muss er sich von allen anderen Tabellennamen und .csv-Dateien, die im Survey verwendet werden, unterscheiden. Sie können zusätzlich Abfrageanforderungsparameter an den REST-Endpunkt Ihres Feature-Layers oder Kartenservice-Layers anhängen, um das Verhalten der Suche zu konfigurieren. Im folgenden Beispiel wird eine Feature-Layer-URL mit dem Parameter resultRecordCount angehängt, um die Auswahlliste mit den ersten 10 Abfrageergebnissen zu füllen, wobei die Suche intern unter dem Namen airports gespeichert wird:
"airports?url=https://services1.arcgis.com/e7dVfn25KpfE6dDd/arcgis/rest/services/Airports2/FeatureServer/0&resultRecordCount=10"Die Auswahlliste kann auch mit einem WHERE-Ausdruck gefiltert werden. Bei Verwendung des folgenden Beispiels als "tableName" wird die Auswahlliste so gefiltert, dass nur Staaten angezeigt werden, deren Name nicht Alabama oder Alaska ist:"state?url=https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/USA_States_Generalized_Boundaries/FeatureServer/0&where=STATE_NAME
NOT IN('Alabama', 'Alaska')"
Hinweis:
Suchparameter, die Sonderzeichen enthalten, müssen codiert werden, wenn der Survey in der Survey123-Web-App verwendet wird. Bei der Codierung werden Sonderzeichen (beispielsweise ein Platzhalter im Ausdruck) durch das Prozentzeichen (%) gefolgt vom jeweils zugehörigen hexadezimalen Äquivalent ersetzt.
Die folgenden zusätzlichen Parameter sind optional, können aber zum Eingrenzen der Suchergebnisse verwendet werden:
| Parameter | Beschreibung |
|---|---|
searchType | Steuert, was für eine Suche durchgeführt wird, und akzeptiert unterschiedliche Werte, die davon abhängen, ob die Tabelle, die durchsucht wird, eine räumliche Tabelle in einem Feature-Layer oder eine nichträumliche Tabelle in einer CSV-Datei oder Feature-Tabelle ist. Bei räumlichen Tabellen werden die Suchtypen intersects, contains, crosses, envelope_intersects, index_intercepts, overlaps, touches und within akzeptiert. Weitere Informationen finden Sie unter Räumliche Beziehungen. Bei einer nichträumlichen Tabelle werden die Suchtypen contains, startswith, endswith und matches unterstützt. |
searchColumn | Bestimmt die Spalte, die nach dem Text im Parameter searchText durchsucht werden soll. Diese Spalten stammen aus der Tabelle selbst. Zusätzlich kann eine räumliche Tabelle in einem Feature-Layer die Spalten @geopoint, @geotrace und @geoshape durchsuchen. |
searchText | Enthält den Text, der gesucht und im Parameter searchColumn zurückgegeben werden soll. |
Zusätzlich können die folgenden Filterparameter zum Suchausdruck hinzugefügt werden, um die Werte in der Auswahlliste zu optimieren:
| Parameter | Beschreibung |
|---|---|
filterColumn | Legt eine Spalte fest, die nach Übereinstimmungen mit dem Text im Parameter filterText durchsucht werden soll. Die Suchabfrage gibt dann nur die Ergebnisse zurück, die diesen Text enthalten. Die Parameter filterColumn und filterText müssen zusammen verwendet werden. |
filterText | Der Text, nach dem in der im Parameter filterColumn angegebenen Spalte gesucht werden soll. Die Parameter filterColumn und filterText müssen zusammen verwendet werden. |
Der folgende Beispielsuchausdruck enthält einige der optionalen Parameter für das Aussehen "search". Er füllt eine Auswahlliste mit dem Inhalt einer .csv-Datei und verwendet dabei eine vorherige Frage als Suchtext.
search('csvName', 'matches', 'breed', ${DogQuestion})
Hinweis:
Fragen mit dem Aussehen search werden in der Survey123-Web-App auf dieselbe Weise dargestellt wie Auswahlfragen mit dem Aussehen autocomplete.
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 der integrierten Methode erstellen Survey123 Studio und 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, erstellen Survey123 Studio und Survey123 Connect automatisch ein zusätzliches Feld im Feature-Layer und verwenden dafür den Namen Ihrer Frage mit Mehrfachauswahl, gefolgt von _other, also z. B. favorite_toppings_other. 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 .csv-Datei Microsoft Excel 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 Studio, Survey123 Connect, Survey123 Mobile und der mobilen App angezeigt, nicht jedoch in der 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
Hinweis:
In diesem Abschnitt werden Funktionen beschrieben, die nur in Survey123 Connect und der mobilen Survey123-App verfügbar sind. Diese Funktionen sind nicht in Survey123 Studio oder Survey123 Mobile verfügbar.
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 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
Hinweis:
In diesem Abschnitt werden Funktionen beschrieben, die nur in Survey123 Connect und der mobilen Survey123-App verfügbar sind. Diese Funktionen sind nicht in Survey123 Studio oder Survey123 Mobile verfügbar.
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