Sie können die Art und Weise des Aussehens von Fragen ändern, indem Sie das Aussehen für jeden Fragetyp festlegen. Fügen Sie Ihrem Arbeitsblatt eine Spalte appearance hinzu, um das Aussehen und die Funktionalität Ihrer Survey-Fragen zu ändern.
Nicht alle Aussehentypen werden sowohl in der mobilen Survey123-App als auch in der Survey123-Web-App unterstützt. In der Kurzübersicht finden Sie eine Tabelle der Aussehentypen mit der Angabe, in welcher Umgebung sie erwartungsgemäß funktionieren. Diese Tabelle ist ebenfalls im Arbeitsblatt Appearances der Survey123-XLSForm-Vorlage "Advanced" aufgeführt.
Tipp:
Wie die Fragen in einem Survey angezeigt werden, sehen Sie am Beispiel "Appearances" in Survey123 Connect. Wenn Sie das Beispiel über Ihr ArcGIS-Konto veröffentlichen, können Sie auch sehen, wie die Fragen in der Survey123 Web-App dargestellt werden.
Mehrere Aussehentypen
Sie können mehrere Aussehentypen zur Spalte appearance für eine Frage hinzufügen, indem Sie die einzelnen Aussehentypen durch Leerzeichen voneinander trennen. Die Reihenfolge der Aussehentypen kann beliebig sein. Zum Beispiel können für eine Bildfrage in der Spalte appearance die folgenden drei Aussehentypen angegeben werden:
annotate new-front multilineFür Fragen in einem Survey, die ein Gitter-Layout verwenden, können Sie Aussehen des Typs "Breite" angeben. Breiten können mit jeder Kombination verschiedener Aussehentypen, die für den Fragetyp unterstützt wird, angegeben werden. Zum Beispiel können für eine Einzelauswahlfrage in einem Gitter-Layout in der Spalte appearance die folgenden Aussehentypen angegeben werden:
w3 likertAusblenden von Fragen
Durch Festlegen des Aussehens auf hidden können Fragen aller Typen, einschließlich Gruppen und Wiederholungen, beim Ausfüllen des Survey ausgeblendet werden, während Standardwerte und Berechnungen übernommen und übermittelt werden. Dies ist eine vielseitigere Variante als die Verwendung des Fragetyps "hidden", da sie auf jeden Fragetyp angewendet werden kann.
Text
Wenn Sie das Aussehen auf multiline festlegen, wird eine Textfrage als mehrzeiliges Textfeld dargestellt. Sie können die Standardhöhe für dieses Textfeld angeben, indem Sie einen Wert für den Parameter defaultHeight in der Spalte body::esri:style festlegen. Bei Eingabe von defaultHeight=5 in der Spalte body::esri:style etwa werden beim Öffnen des Survey fünf Zeilen in einem mehrzeiligen Textfeld angezeigt. Ist kein Wert angegeben, werden beim Öffnen des Survey drei Zeilen in einem mehrzeiligen Textfeld angezeigt.
Wenn Sie das Aussehen auf predictivetext oder nopredictivetext festlegen, wird durch eine Textfrage erzwungen, dass Vorhersagetext auf mobilen Geräten aktiviert bzw. deaktiviert wird. Standardmäßig ist Vorhersagetext unter Android für Textfragen deaktiviert, während er unter iOS standardmäßig aktiviert ist.
Hinweis:
Die Einstellung der Höhe von Fragen wird in der Survey123-Web-App nicht unterstützt.
Die Aussehen predictivetext und nopredictivetext werden in der Survey123-Web-App nicht unterstützt.
Vorhersagetext ist unter Android für Textfragen standardmäßig deaktiviert. Dies kann dazu führen, dass die Spracherkennungsfunktion auf einigen Tastaturen deaktiviert ist. Wenden Sie auf eine Textfrage das Aussehen predictivetext an, um für diese Frage die Spracherkennung zu aktivieren.
InfraMarker-Text
Verwenden Sie zum Lesen aus oder Schreiben in ein InfraMarker-RFID-Tag die folgenden Aussehentypen.
Wenn Sie das Aussehen einer Textfrage auf inframarker festlegen, können Sie die Informationen definieren, die in ein Tag geschrieben werden sollen. Diese Informationen können "assetOwner", "assetName", "latitude" und "longitude" sein, und die Werte können aus anderen Fragen im Survey abgeleitet werden. Zum Beispiel werden mit dem folgenden Ausdruck in der Spalte calculation die Antworten der Fragen zu asset_name, asset_owner, lat und long in das Tag geschrieben:
concat("assetName=", ${asset_name}, "&assetOwner=", ${asset_owner}, "&latitude=", ${lat}, "&longitude=", ${long})
Wenn Sie das Aussehen einer anderen Textfrage in demselben Survey auf getinframarkerid festlegen, wird die aus 24-Zeichen bestehende eindeutige InfraMarker-Tag-ID abgerufen und im Survey gespeichert.
Weitere Informationen finden Sie in der InfraMarker-Dokumentation.
Geokodierung
Wenn Sie das Aussehen auf geocode festlegen, wird eine Textfrage zum Suchen und Übermitteln einer geokodierten Adresse verwendet. Wenn Sie mit der Eingabe einer Adresse beginnen, wird eine Reihe von Optionen zur automatischen Vervollständigung angezeigt, die auf den für Ihre Organisation verfügbaren Standard-Locators basierende Positionen vorschlagen. Wenn der Benutzer nicht angemeldet ist, wird der ArcGIS World Geocoder verwendet. Die letztendlich ausgewählte Adresse wird dann als Zeichenfolge an den Feature-Layer gesendet. Da die vollständig geokodierten Daten jedoch vor dem Senden vorübergehend als JSON-Objekt gespeichert werden, können einzelne Eigenschaften in andere Felder extrahiert werden.
Um bestimmte Eigenschaften aus dem JSON-Objekt zu extrahieren, sollten Sie die Funktion pulldata("@json") in der Spalte calculation einer anderen Frage verwenden.
pulldata("@json", ${address}, "location.x")
pulldata("@json", ${address}, "searchCandidate")
Das gesamte JSON-Objekt kann in einem einzelnen Textfeld zurückgegeben werden, indem keine individuelle Eigenschaft definiert wird.
pulldata("@json", ${address})
Weitere Informationen zur Funktion pulldata("@json") finden Sie unter Abrufen eines Wertes aus JSON-Code.
Hinweis:
Für die Geokodierung mit dem ArcGIS World Geocoding Service werden Credits verbraucht. Weitere Informationen finden Sie unter Informationen zu Credits.Um einen bestimmten Locator, aus dem Ergebnisse zurückgegeben werden sollen, festzulegen, geben Sie die Element-ID dieses Locators in der Spalte bind::esri:parameters an, zum Beispiel geocode=36ff9e8c13e042a58cfce4ad87f55d19. Ein Locator, der in einem ArcGIS Online-Survey verwendet wird, muss ein Element in ArcGIS Online sein. Ein Locator, der in einem ArcGIS Enterprise-Survey verwendet wird, muss ein Element in demselben Portal wie der Survey sein.
Die verfügbaren Eigenschaften sind je nach verwendetem Locator unterschiedlich. Die Ausnahme dabei bildet die Eigenschaft searchText, die ungeachtet des verwendeten Locators verfügbar ist und entweder die zum Suchen nach der Adresse verwendete exakte Zeichenfolge oder die in einer Ergebnisliste ausgewählte Option zurückgibt.
Sie können die Darstellung einer Frage mit dem Aussehen geocode noch genauer steuern, indem Sie in der Spalte body::esri:style einen der folgenden Parameter festlegen:
- indicator: Ermöglicht die Anzeige der Richtung und Entfernung von der aktuellen Geräteposition in den geokodierten Ergebnissen. Dieser Parameter kann entweder auf distance, auf direction, auf beide Werte, die durch ein Komma voneinander getrennt werden müssen, oder auf none festgelegt werden. In der Standardeinstellung dieses Parameters wird nur die Entfernung angezeigt.
- proximity: Steuert, ob in den geokodierten Ergebnissen nur Ergebnisse innerhalb eines bestimmten Radius um die Position des Gerätes angezeigt werden. Dieser Parameter akzeptiert eine Zahl mit einer der folgenden Standardeinheiten: m (Meter), km (Kilometer), ft (Fuß), mi (Meilen) oder yd (Yards). Wenn keine Einheit angegeben wurde, wird standardmäßig "Meter" verwendet. Falls auf 0 gesetzt, wird die räumliche Nähe nicht berücksichtigt. Dieser Parameter ist standardmäßig auf on festgelegt. Dabei werden die Vorschläge nach Nähe sortiert, ohne dass Positionen wegen der Entfernung herausgefiltert werden.
- maxResults: Steuert die maximale Anzahl der zurückgegebenen Ergebnisse. Beispielsweise werden bei maxResults=10 maximal 10 mögliche Ergebnisse zurückgegeben. In der Standardeinstellung dieses Parameters werden maximal 6 Ergebnisse angezeigt.
- suggestions: Dieser Parameter fungiert als Schnittstelle für die Operation suggest in der ArcGIS REST API. Wird dieser Parameter auf yes festgelegt, wird die Dropdown-Liste der potenziellen Positionen durch die Operation suggest gefüllt. Wenn dieser Parameter auf no festgelegt wird oder der Geokodierungsservice die Operation suggest nicht unterstützt, wird die Dropdown-Liste der potenziellen Positionen durch die Operation findAddressCandidates gefüllt. Dieser Parameter ist standardmäßig auf yes festgelegt.
Das Aussehen geocode erfordert eine Internetverbindung und funktioniert deshalb in einer Offline-Umgebung nicht.
Hinweis:
Die Parameter "indicator", "proximity", "maxResults" und "suggestions" werden in der Survey123-Web-App nicht unterstützt.
Entfernungsmesser
Wenn das Aussehen auf rangefinder festgelegt wird, kann eine Textfrage entweder das vollständige JSON-Objekt oder einen bestimmten Wert, der von einem Entfernungsmesser zurückgegeben wurde, akzeptieren. Wenn diese Frage das vollständige JSON-Objekt akzeptieren soll, dann sollte für sie der Parameter bind::esri:fieldLength auf 1000 festgelegt sein, damit der vollständige Wert verwendet werden kann.
Wenn das Aussehen auf rangefinder festgelegt wird, kann eine Frage des Typs "integer" und "decimal" einen bestimmten Wert, der von einem Entfernungsmesser zurückgegeben wurde, akzeptieren. Geben Sie mit einem der folgenden Werte in der Spalte bind::esri:parameters an, welcher Messwert gespeichert werden soll: height, azimuth, horizontalDistance, slopeDistance, inclination. Zum Beispiel wird mit measurement=height nur der Höhenwert, der vom Entfernungsmesser zurückgegeben wurde, gespeichert.
Datum
Wenn Sie das Aussehen auf year festlegen, wird eine Datumsfrage als Schaltfläche zur Jahresangabe dargestellt, die Pfeile zum Erhöhen oder Verringern des Jahreswertes aufweist.
Wenn Sie das Aussehen auf month-year festlegen, wird eine Datumsfrage als Schaltflächenpaar dargestellt – eine Schaltfläche für den Monat und eine für das Jahr. Jede Schaltfläche hat Pfeile zum Erhöhen oder Verringern des Wertes.
Hinweis:
Die Aussehentypen year und month-year werden angezeigt, wenn der Survey mit Werten für den aktuellen Monat und das aktuelle Jahr geladen wird. Sie enthalten diese Werte jedoch nicht bereits automatisch; es werden leere Werte übergeben, sofern keine manuelle Bearbeitung erfolgt oder ein Standardwert oder eine Berechnung angewendet wurde.
Wenn Sie das Aussehen auf week-number festlegen, wird eine Datumsfrage zwar mit einer Kalenderauswahl zum Wählen des Datums dargestellt, aber nach Auswahl des Datums wird das Ergebnis als entsprechende Wochennummer des Jahres angezeigt. Wenn Sie beispielsweise das Datum 27. April 2016 auswählen, wird "Week 17" als Ergebnis angezeigt.
Hinweis:
Das Aussehen week-number wird in der Survey123-Web-App nicht unterstützt.
Einfachauswahl
Wenn Sie das Aussehen auf minimal festlegen, wird eine Einfachauswahlfrage in einem Dropdown-Menü dargestellt.
Wenn Sie das Aussehen 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.
Sie können 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 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 das Aussehen auf likert festlegen, wird eine Einfachauswahlfrage 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 das Aussehen 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.
Wenn Sie das Aussehen auf image-map festlegen, wird eine Einfachauswahlfrage als Bild dargestellt, auf das in der Spalte media::image verwiesen wird. Sie enthält auswählbare Regionen des Bildes als Auswahloptionen. Damit dieses Aussehen ordnungsgemäß verwendet werden kann, muss eine SVG-Datei im Medienordner des Survey bereitgestellt werden und die Namenswerte der Auswahlliste müssen mit den Pfad-IDs für die Regionen der SVG-Datei übereinstimmen. Weitere Informationen finden Sie unter Arbeiten mit SVG-Dateien.
Hinweis:
Das Aussehen image-map wird in der Survey123-Web-App nicht unterstützt.
Mehrfachauswahl
Wenn Sie das Aussehen auf minimal festlegen, wird eine Mehrfachauswahlfrage in einem Dropdown-Menü dargestellt.
Wenn Sie das Aussehen auf horizontal festlegen, werden die Auswahlmöglichkeiten für eine Mehrfachauswahlfrage 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.
Sie können 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 auf maximal drei Spalten begrenzt.
Das Aussehen compact und das Aussehen horizontal-compact sind identisch. In der Survey123-Web-App werden bei diesen Aussehentypen keine Spalten verwendet, sondern die Auswahlbeschriftungen für eine Mehrfachauswahlfrage werden nebeneinander in Zeilen ohne zusätzlichen Zwischenraum dargestellt.
Wenn Sie das Aussehen auf image-map festlegen, wird eine Mehrfachauswahlfrage als Bild dargestellt, auf das in der Spalte media::image verwiesen wird. Sie enthält auswählbare Regionen des Bildes als Auswahloptionen. Damit dieses Aussehen ordnungsgemäß verwendet werden kann, muss eine SVG-Datei im Medienordner des Survey bereitgestellt werden und die Namenswerte der Auswahlliste müssen mit den Pfad-IDs für die Regionen der SVG-Datei übereinstimmen. Weitere Informationen finden Sie unter Arbeiten mit SVG-Dateien.
Hinweis:
Das Aussehen image-map wird in der Survey123-Web-App nicht unterstützt.
Suchen
Einfachauswahl- und Mehrfachauswahlfragen unterstützen auch 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 oder 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"Zusätzliche 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 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. |
Das folgende Beispiel zeigt einen Suchausdruck, der einige der optionalen Parameter für das Aussehen "search" enthält. 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 select_one-Fragen mit dem Aussehen autocomplete.
Kartenfragen
Wenn Sie das Aussehen auf press-to-locate festlegen, akzeptiert eine Geopunkt-Frage erst dann einen Positionswert, wenn der Benutzer mit der Frage interagiert. Dies steht im Gegensatz zum Standardverhalten, bei dem die Position unmittelbar nach dem Laden des Formulars erfasst wird. Geotrace- und Geoshape-Fragen zentrieren die Ansicht auf die Position des Benutzers, erfassen jedoch bei der ersten Interaktion mit der Karte keinen Punkt.
Hinweis:
Das Aussehen press-to-locate wird für Fragen des Typs "Geotrace" und "Geoshape" in der mobilen Survey123-App nicht unterstützt.
Geopunkt
Wenn Sie das Aussehen auf hide-input festlegen, wird für eine in der Survey123-Web-App angezeigte Geopunkt-Frage im Gegensatz zum standardmäßigen Koordinaten-Eingabefeld ein schreibgeschützter Koordinatenwert angezeigt.
Hinweis:
Das Aussehen hide-input wird in der mobilen Survey123-App nicht unterstützt.
Bild
Wenn Sie das Aussehen auf signature festlegen, wird in einer Bildfrage ein Pop-up angezeigt, in dem eine Unterschrift erfasst werden kann.
Eine Unterschrift wird als .jpg-Bildanlage gespeichert, wobei die Abmessungen denen des Pop-up entsprechen. Das Pop-up ist standardmäßig so breit wie der Gerätebildschirm und hat eine feste Höhe von 200 Pixeln. Sie können die maximale Breite des Pop-up festlegen, indem Sie in der Spalte parameters einen Wert für max-pixels definieren, z. B. max-pixels=400.
Sie können auch ein Bild in der Spalte default hinterlegen, um es als benutzerdefinierten Hintergrund für die Unterschrift zu verwenden. Das Bildseitenverhältnis des Pop-ups richtet sich nach den Maßen des Standardbilds.
Die Breite des Pop-ups ist der kleinste der folgenden Werte:
- Der Wert max-pixels
- Die Breite des Standardbilds
- Die Breite des Gerätebildschirms
Die Höhe beträgt 200 Pixel, sofern kein Standardbild bereitgestellt wird.
Wenn Sie einen Survey mit dem Aussehen vom Typ "signature" entwerfen, berücksichtigen Sie die Bildschirmgröße sämtlicher Zielgeräte.
Mit dem Parameter footerText in der Spalte body::esri:style lässt sich Fußzeilentext für das Pop-up einer Unterschriftenfrage angeben. Wenn nur der Parameter footerText ohne Wertangabe verwendet wird, wird für die Frage der Hinweis zur Anleitung unterhalb der Unterschrift angezeigt. Mithilfe von footerText=@[hint] kann der Hinweis zur Anleitung in den Hinweis der Frage geändert werden. Wird für den Fußzeilentext der Hinweis oder der Hinweis zur Anleitung verwendet, wird er nicht an der Standardposition unter dem Fragenamen angezeigt. Weitere Informationen zu Hinweisen finden Sie unter Hinweise.
Wenn Sie das Aussehen auf multiline festlegen, kann eine Bildfrage auch mehrere Bilder enthalten. Dieser Aussehentyp kann mit anderen für Bilder geeigneten Aussehentypen kombiniert werden, indem die Typen durch Leerzeichen getrennt angegeben werden, wie zum Beispiel multiline annotate.
Mit der Funktion count-selected in der Spalte constraint können Sie die Anzahl der Bilder, die übermittelt werden können, steuern. Zum Beispiel wird mit count-selected(${image_question}) <= 5 die Anzahl der Bilder, die übermittelt werden können, auf maximal fünf begrenzt.
Wenn Sie das Aussehen auf new-front oder new-rear festlegen, wird bei einer Bildfrage nur die nach vorn bzw. die nach hinten gerichtete Kamera des Geräts verwendet. Diese Aussehentypen können mit annotate kombiniert werden, indem beide Typen durch Leerzeichen getrennt angegeben werden, wie zum Beispiel new-front annotate.
Hinweis:
In der Survey123-Web-App werden weder mehrzeiliger Text noch der Parameter max-pixels noch Standardwerte unterstützt, wenn das Aussehen signature angewendet wird.
Die Aussehen new-front und new-rear werden in der Survey123-Web-App nicht unterstützt.
Die Funktion pulldata("@exif") kann für Bildfragen des Typs "multiline" nicht verwendet werden. Wenn Sie EXIF-Daten (Exchangeable Image File Format) aus mehreren Bildern extrahieren müssen, die auf dieselbe Frage übermittelt wurden, sollten Sie dafür eine Wiederholung verwenden.
"draw" und "annotate"
Wenn Sie das Aussehen auf draw festlegen, zeigt eine Bildfrage eine Schaltfläche zum Laden einer Zeichenfläche an, auf der skizziert werden kann. In der Palette der Zeichenwerkzeuge können Sie zwischen den Zeichenwerkzeugen wechseln und die Einstellungen für jedes Werkzeug steuern, wie zum Beispiel Textgröße, Linienbreite und Farbe. Informationen über die Bedienoberfläche der Zeichenfläche finden Sie unter "Draw" und "annotate". Sie können benutzerdefinierte Paletten erstellen, mit denen Sie Zeichen- und Annotationswerkzeuge Ihren Anforderungen entsprechend konfigurieren können. Weitere Informationen finden Sie unter Paletten für "draw" und "annotate".
Wenn Sie das Aussehen auf annotate festlegen, zeigt eine Bildfrage eine Schaltfläche zum Öffnen der Gerätekamera an. So kann ein Foto aufgenommen werden, dem Sie dann Grafiken und Text hinzufügen können. In der Palette der Zeichenwerkzeuge können Sie zwischen den Zeichenwerkzeugen wechseln und die Einstellungen für jedes Werkzeug steuern, wie zum Beispiel Textgröße, Linienbreite und Farbe. Informationen über die Bedienoberfläche der Zeichenfläche finden Sie unter "Draw" und "annotate". Sie können benutzerdefinierte Paletten erstellen, mit denen Sie Zeichen- und Annotationswerkzeuge Ihren Anforderungen entsprechend konfigurieren können. Weitere Informationen finden Sie unter Paletten für "draw" und "annotate".
Tipp:
Ab Survey123 3.13 werden EXIF-Daten aus dem Quellbild in das mit Annotationen versehene Bild kopiert.
Alternativ können Sie zulassen, dass Benutzer ein Bild im Speicher des Geräts oder einen Snapshot einer Karte mit Annotationen versehen. Legen Sie dazu die Spalte body::esri:style der Frage auf method=browse, method=camera oder method=map fest. Das Standardverhalten des Aussehentyps annotate entspricht der Angabe von method=camera. Sie können für die Frage festlegen, dass mehrere Optionen für das Quellbild verfügbar sind. Dazu werden die verschiedenen Optionen durch Kommas getrennt angegeben, z. B. method=camera,browse.
Vorsicht:
Unabhängig von der festgelegten Methode wird in der Survey123-Web-App nur die Option "Datei suchen" angezeigt.
Standardwerte und Berechnungen verhalten sich bei Bildfragen, die draw und annotate verwenden, unterschiedlich. Wenn der Dateiname eines Bildes im Medienordner des Survey als Standardwert oder Ergebnis einer Berechnung verwendet wird, dient das Bild als anfänglicher Hintergrund für die Zeichenfläche. Bei annotate wird dieses Bild durch ein vom Benutzer bereitgestelltes Bild ersetzt. Es wird nur dann angezeigt, wenn der Benutzer kein Bild bereitstellt oder das bereitgestellte Bild zurücksetzt.
Hinweis:
Sie können die Auflösung für ein Bild festlegen, indem Sie einen Wert für max-pixels in der Spalte parameters definieren. Wenn für eine Frage mit dem Aussehentyp draw der Wert max-pixels=1000 festgelegt wird, wird als Zeichenfläche ein quadratisches Bild mit 1000 x 1000 Pixeln festgelegt. Wenn für eine Frage mit dem Aussehentyp annotate der Wert max-pixels=1000 festgelegt wird, wird die längste Seite des Bildes auf 1000 Pixel festgelegt, während das Seitenverhältnis des Bildes beibehalten wird. Wenn max-pixels nicht festgelegt wurde, wird die Bildgröße stattdessen durch die Bildgrößeneinstellung in den Optionen für Ihren Survey in Survey123 Connect definiert.
Diese beiden Formen der Festlegung der Bildauflösung werden überschrieben, wenn ein Standardbild für die Frage angegeben wurde. In diesem Fall wird die Auflösung des Standardbildes verwendet. Damit kann eine Standardauflösung für alle übermittelten Bilder sichergestellt werden. Wenn ein Snapshot einer Karte für die Annotation bereitgestellt wurde, werden ebenfalls alle anderen Festlegungen der Bildauflösung überschrieben und das Bild auf die Größe des sichtbaren Bereichs der Zeichenfläche festgelegt.
Spike Images
Bildfragen unterstützen Aussehentypen für die Verwendung von Survey123 mit Spike, einer von ikeGPS entwickelten Laser-Messlösung, mit der Sie die Abmessungen und Position eines Objekts über ein Foto erfassen können. Wenn Sie das Aussehen auf spike, spike-full-measure oder spike-point-to-point festlegen, zeigt eine Bildfrage eine Schaltfläche zum Öffnen der mobilen Spike-App auf iOS- und Android-Geräten an.
Mit einem Foto, das mit der Spike-App und dem Laser-Gerät aufgenommen wurde, können Sie die Koordinaten und die Entfernung des Objekts erfassen und die Abmessungen von Objekten im Foto ermitteln, indem Sie Flächen und Linien zeichnen. Das Foto mit Messmarkierungen wird anschließend Ihrem Survey hinzugefügt und die Metadaten aus dem Foto, z. B. Koordinaten und Abmessungen, können erfasst werden. Zugehörige Metadaten zum Spike-Gerät und zur Messung werden mithilfe von EXIF-Standard-Tags (Exchangeable Image File) in der Bilddatei aufgezeichnet. Die EXIF-Informationen können anschließend extrahiert und zum Füllen anderer Felder herangezogen werden.
Der Unterschied zwischen den Spike-Aussehentypen ist die Menge an Werten, die im Bild gespeichert werden. Mit dem Aussehen spike werden lediglich die Entfernung und Position, mit dem Aussehen spike-full-measure hingegen die Entfernung, Position, Fläche und Länge gemessen. Mit dem Aussehen spike-point-to-point wird eine Reihe von exklusiven Werten erfasst; das wird durch Eigenschaftennamen gekennzeichnet, die mit P2P beginnen.
Weitere Informationen zu diesen EXIF-Tags finden Sie unter Spike-Integration. Weitere Informationen über SpikeSpike-Website.
Hinweis:
Die Integration von Spike wird in der Survey123-Web-App nicht unterstützt.
Integer
Wenn Sie das Aussehen auf distress festlegen, wird eine Integer-Frage als Stress-Skala dargestellt. Eine Stress-Skala ist eine 10-Punkte-Skala, mit der Gefühle wie Stress, Schmerzen und Glück gemessen werden.
Wenn Sie das Aussehen auf spinner festlegen, wird eine Integer-Frage mit Schaltflächen angezeigt, mit denen der Wert um jeweils eins erhöht oder verringert werden kann. Durch Auswählen der Schaltfläche wird die Wertänderung fortgesetzt, bis die Schaltfläche losgelassen wird.
Wenn Sie das Aussehen auf numbers festlegen, wird für eine markierte Integer-Frage eine benutzerdefinierte numerische Tastatur angezeigt, über die ein Wert eingegeben werden kann. Die Tastatur enthält auch eine Schaltfläche, mit der der Wert als positiver oder negativer Wert definiert werden kann.
Wenn Sie das Aussehen auf calculator festlegen, wird für eine markierte Integer-Frage eine benutzerdefinierte Taschenrechnertastatur angezeigt, über die ein Wert eingegeben oder geändert werden kann.
Hinweis:
Die Aussehen distress, spinner, numbers und calculator werden in der Survey123-Web-App nicht unterstützt.
Dezimalzahl
Wenn Sie das Aussehen auf spinner festlegen, wird eine Dezimalfrage mit Schaltflächen angezeigt, mit denen die letzte Ziffer des Wertes um jeweils eins erhöht oder verringert werden kann. Durch Auswählen einer Schaltfläche wird die Wertänderung fortgesetzt, bis die Schaltfläche losgelassen wird.
Wenn Sie einen Standard zum Definieren der Anzahl von Dezimalstellen für eine Frage verwenden, wird dieser vom Drehfeld (Spinner) berücksichtigt. Nachfolgend finden Sie einige Beispiele, wie verschiedene Dezimalwerte vom Drehfeld behandelt werden:
- 1,0 wird auf 1,1, 1,2, 1,3, 1,4 erhöht
- 3,07 wird auf 3,08, 3,09, 3,10, 3,11 erhöht
- 2.000000 wird auf 2,000001, 2,000002, 2,000003 erhöht
Wenn Sie das Aussehen auf numbers festlegen, wird für eine Dezimalfrage eine benutzerdefinierte numerische Tastatur angezeigt, über die ein Wert eingegeben werden kann. Die Tastatur enthält auch eine Schaltfläche, mit der der Wert als positiver oder negativer Wert definiert werden kann.
Wenn Sie das Aussehen auf calculator festlegen, wird für eine markierte Dezimalfrage eine benutzerdefinierte Taschenrechnertastatur angezeigt, über die ein Wert eingegeben oder geändert werden kann.
Wenn Sie das Aussehen auf thousands-sep festlegen, wird die Antwort auf eine Dezimalfrage mit Tausendertrennzeichen ausgegeben. Der als Antwort auf den Survey gesendete Wert bleibt davon unberührt, nur seine Darstellung in der App ist betroffen. Die Trennzeichen werden vom Gebietsschema des Geräts bestimmt und werden nur angewendet, wenn ein Survey über den Ordner Entwürfe, Ausgang, Eingang oder Gesendet geöffnet oder wenn die Antwort durch einen Standardwert oder eine Berechnung befüllt wird. Bei manueller Eingabe eines Werts werden keine Tausendertrennzeichen angezeigt.
Hinweis:
Die Aussehen spinner, numbers, calculator und thousands-sep werden in der Survey123-Web-App nicht unterstützt.
Bereich
Wenn Sie das Aussehen auf no-ticks wird eine Frage des Typs "Bereich" angezeigt, sie enthält jedoch keine Linien für die Positionen im Schieberegler oder den minimalen und maximalen Wert. Dadurch ändert sich das Verhalten der Frage nicht, nur die Anzeige. Weitere Informationen zum Fragetyp range finden Sie unter Bereich.
Barcode
Wenn Sie das Aussehen auf minimal festlegen, wird eine Barcodefrage mit einer einzelnen Schaltfläche zum Starten des Scanners angezeigt. Das Textfeld mit dem Wert der Barcodefrage ist nicht sichtbar. Weitere Informationen zum Fragetyp barcode finden Sie unter Barcodes.
Gruppieren
Wenn Sie das Aussehen einer Frage des Typs "begin group" auf compact festlegen, wird eine Gruppe von Fragen nach dem Starten im ausgeblendeten Zustand angezeigt und kann vom Benutzer eingeblendet werden. Dies ist hilfreich bei langen Surveys, die der Benutzer nicht gut lesen und durch die er nur schwer navigieren kann. Dieses Aussehen wird in der Frage des Typs "begin group" definiert.
Das Aussehen minimal hat keine Auswirkungen auf Gruppenfragen.
Bei Festlegen des Aussehens auf table-list für eine Frage des Typs "begin group" werden die Fragen des Typs "select_one" innerhalb der Gruppe mit einer gemeinsamen Auswahlliste im Tabellenformat angezeigt. Dabei werden in der ersten Zeile die Beschriftungen der Auswahlliste angegeben und in der Spalte links die Fragebeschriftungen.
Wenn Sie den Wert der Spalte style im Arbeitsblatt settings auf pages und das Aussehen für jede Frage des Typs "begin group" auf field-list setzen, wird jede Gruppe auf einer separaten Seite des Survey angezeigt. Mit den Schaltflächen "Zurück" und "Vorwärts" unten in der App können Sie durch die Seiten navigieren. Wenn Sie diese Schaltflächen lange genug drücken, gelangen Sie zum Beginn bzw. zum Ende des Survey. Sie können auch die Seitennummer auswählen und damit zu einem beschreibbaren Feld machen und dann eine neue Seitenzahl eingeben. Dies eignet sich ideal, um die Survey-Darstellung übersichtlich zu unterteilen, zu organisieren und die Ladezeiten zu verringern.
Vorsicht:
Bei Verwendung des Styles pages muss sich jede Frage im Survey in einer Gruppe befinden, die das Aussehen field-list verwendet.
Wenn Sie den Wert der Spalte style im Arbeitsblatt settings auf fixed-grid oder dynamic-grid setzen, können die Gruppen im Survey so festgelegt werden, dass die enthaltenen Fragen in einem Gitter angezeigt werden.
Der Style "fixed grid" erstellt einen Platzhalter für jede Frage, auch für Fragen mit dem Aussehen "hidden". Wenn die entsprechenden Voraussetzungen erfüllt sind, wird eine Frage angezeigt. Anderenfalls bleibt diese Stelle im Formular leer.
Der dynamische Gitternetz-Stil ermöglicht es, Fragen und Gruppen je nach den jeweiligen Bedingungen auf dem Formular zu verschieben, um den Platz auf dem Gerätebildschirm optimal zu nutzen.
Der Gitternetz-Layout-Style auf dem Arbeitsblatt settings ist eine globale Einstellung, die auf den gesamten Survey angewendet wird. Sie können den Gitternetz-Layout-Style auch auf einzelne Gruppen oder Wiederholungen anwenden, sodass für verschiedene Teile Ihres Surveys unterschiedliche Styles verwendet werden. Die globale Einstellung kann außer Kraft gesetzt werden, indem eine der folgenden Angaben in die Spalte body::esri:style der Gruppen- oder Wiederholungsfrage eingegeben wird:
- layout=dynamic-grid
- layout=fixed-grid
Legen Sie das Aussehen der Breite einer Gruppe auf w fest, gefolgt von der Anzahl der Spalten, in die das Gitternetz unterteilt wird. So unterteilt beispielsweise "w4" jede Zeile des Gitternetzes in vier Spalten. Der Parameter "width" kann auch auf eine Frage innerhalb einer Gruppe oder Wiederholung angewendet werden, um festzulegen, wie viele Spalten der übergeordneten Gruppe oder Wiederholung die Frage umfassen soll. Wenn die angegebene Breite der Fragen die für die Gruppe festgelegte Anzahl von Spalten erreicht, erscheinen die nächsten Fragen in einer neuen Zeile. Diese Breiten können zusammen mit den meisten anderen Aussehentypen festgelegt werden.
Im folgenden Beispiel ist das Aussehen "width" für Wassertemperatur, gelösten Sauerstoff, pH-Wert und Leitfähigkeit jeweils "w1", und das Aussehen "width" für den Ort der Wasserprobe ist "w2".
Im folgenden Beispiel beträgt die Breite der Gruppe drei Spalten (w3). In der ersten Wiederholung sind zwei Spalten definiert; diese beiden Spalten erstrecken sich über zwei übergeordnete Spalten (w2:2). In der zweiten Wiederholung sind zwei Spalten definiert; diese beiden Spalten erstrecken sich über eine übergeordnete Spalte (w2:1).
Die folgende Abbildung zeigt, wie diese geschachtelten Wiederholungen in der Gruppe auf dem Formular dargestellt werden.
Wenn das Formular in der Web-App angezeigt werden soll, fügen Sie den URL-Parameter "width" zum Starten der Webanwendung hinzu, um sicherzustellen, dass die gesamte Bildschirmbreite verwendet wird. In der folgenden Abbildung hat die Gruppe eine Breite von acht Spalten (w8), die Fragen innerhalb der Gruppe haben eine Breite von w2, w3 oder w5, um die Seite entsprechend auszufüllen, und an die Umfrage-URL wurde ?width=1 angehängt, um die gesamte Breite des Browsers zu verwenden.
Hinweis:
Das Aussehen von table-list unterstützt keine Fragen des Typs "select_multiple" und keine Medien in Auswahllisten.
Das Aussehen "table-list" funktioniert nicht ordnungsgemäß, wenn es innerhalb einer Gruppe des Typs "theme-grid" platziert wird.
Bisher wurde der dynamische Gitternetzstil als "theme-grid" bezeichnet. Der Style "theme-grid" wird aus Gründen der Abwärtskompatibilität weiterhin unterstützt; für neue Surveys wird jedoch empfohlen, entweder den Style "dynamic-grid" oder "fixed-grid" zu verwenden.
Gruppen im Gitternetz-Layout-Style unterstützen borderColor nicht.
Datei
Wenn Sie das Aussehen auf multiline festlegen, kann eine Dateifrage auch mehrere Dateien enthalten. Mit der Funktion count-selected in der Spalte constraint können Sie die Anzahl der Dateien, die übermittelt werden können, steuern. Zum Beispiel wird mit count-selected(${file_question}) <= 5 die Anzahl der Dateien, die übermittelt werden können, auf maximal fünf begrenzt.
Wiederholen
Wenn Sie das Aussehen einer Frage des Typs "begin repeat" auf minimal setzen, ist eine wiederholbare Sammlung von Fragen beim Starten nicht sichtbar. Der Benutzer muss auf die Schaltfläche zum Hinzufügen klicken, um die Fragen in der Wiederholung anzuzeigen. Dies ist hilfreich, wenn wiederholte Fragen in einem Survey nicht ausgefüllt werden müssen. Dieses Aussehen wird in der Frage des Typs "begin repeat" definiert.
Weist eine Wiederholung den Aussehentyp minimal und die Wiederholungsanzahl Null auf, sind die Wiederholungssteuerelemente und deren Beschriftung unsichtbar.
Wenn Sie das Aussehen einer Frage des Typs "begin repeat" auf compact festlegen, wird eine wiederholbare Sammlung von Fragen nach dem Starten im ausgeblendeten Zustand angezeigt und kann vom Benutzer eingeblendet werden. Dies ist hilfreich bei großen Surveys, die der Benutzer nicht gut lesen und durch die er nur schwer navigieren kann. Dieses Aussehen wird in der Frage des Typs "begin repeat" definiert.
Im Gegensatz zu anderen Aussehentypen können für eine Wiederholung "minimal" und "compact" gleichzeitig verwendet werden, indem das Aussehen auf minimal compact festgelegt wird. Dann werden die Fragen in einer Wiederholung sowohl eingeklappt (compact) als auch ausgeblendet (minimal) angezeigt.
Wenn Sie den Wert der Spalte style im Arbeitsblatt settings auf pages und das Aussehen für jede Frage des Typs "begin repeat" auf field-list setzen, wird jede wiederholbare Sammlung von Fragen auf einer separaten Seite des Survey angezeigt. Dieses Verhalten entspricht dem für eine Gruppe.
Wenn Sie den Wert der Spalte style im Arbeitsblatt settings auf fixed-grid oder dynamic-grid setzen, können Wiederholungen im Survey so festgelegt werden, dass die enthaltenen Fragen in einem Gitternetz-Layout angezeigt werden. Dieses Verhalten entspricht dem für eine Gruppe.