Sie können Text-, Ganzzahl- und Dezimalfragen in Surveys einfügen, damit die Benutzer Antworten mittels Text und Zahlen eingeben können.
Bei Textfragen ist die Freitexteingabe im Survey möglich. Standardmäßig wird im Formular ein Textfeld für eine einzeilige Eingabe angezeigt. Wenn der Text die Größe des Textfeldes überschreitet, bleibt die Größe bestehen und das Scrollen erfolgt horizontal ohne die Zeilenumbrüche. Dies ist ideal für kurze Antworten. Um die Texteingabe an ein bestimmtes Format anzupassen, können Sie eine Eingabemaske anwenden Sie können außerdem einen regulären Ausdruck anwenden, um das Textfeld so einzuschränken, dass Antworten, die nicht einem bestimmten Format entsprechen – wie beispielsweise eine E-Mail-Adresse oder eine Website-URL –, automatisch abgelehnt werden.
Bei den Fragetypen "integer" und "decimal" darf der Benutzer nur zulässige Zahlenwerte eingeben. In der Spalte constraint für diese Fragetypen können Sie die Mindest- und Maximalwerte angeben, um sicherzustellen, dass der Benutzer den Survey nur dann übermitteln kann, wenn sich die Antwort im festgelegten Bereich befindet.
Sie können das Verhalten dieser Fragetypen und deren Darstellung ändern, indem Sie das Aussehen anpassen. Informationen dazu, welche Apps für die Übermittlung ein bestimmtes Aussehen unterstützen, finden Sie unter Aussehen.
Aussehen des Textes
Hinweis:
In Survey123 Mobile wird für Textfragen nur das Aussehen vom Typ multiline unterstützt.
In der Survey123-Web-App werden die Aussehentypen predictivetext und nopredictivetext nicht unterstützt.
Wenn Sie den Wert der Spalte appearance auf multiline festlegen, wird eine Textfrage als mehrzeiliges Textfeld dargestellt. Dieses größere Textfeld eignet sich ideal für ausführliche Antworten. Bereits während der Texteingabe fließt der Text in die nächste Zeile, und es werden Zeilenumbrüche akzeptiert.
Hinweis:
Für Formulare, die in der mobilen Survey123-App verwendet werden, können Sie die Standardhöhe für dieses mehrzeilige 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. 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. Unter iOS ist Vorhersagetext standardmäßig aktiviert.
Wenn Sie das Aussehen auf geocode festlegen, wird eine Textfrage zum Suchen und Übermitteln einer geokodierten Adresse verwendet.
Es stehen außerdem Aussehentypen zur Verfügung, mit denen Sie eine InfraMarker-Tag-ID abrufen und einen Wert von einem Entfernungsmesser abrufen können.
Suchen und Übermitteln einer geokodierten Adresse
Hinweis:
In diesem Abschnitt werden Funktionen beschrieben, die nur in der mobilen Survey123-App verfügbar sind. Diese Funktionen sind nicht in Survey123 Mobile verfügbar.
Wenn Sie die Spalte appearance auf geocode festlegen, wird eine Textfrage zum Suchen und Übermitteln einer geokodierten Adresse verwendet. Wenn Benutzer 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. Das Aussehen geocode erfordert eine Internetverbindung und funktioniert deshalb in einer Offline-Umgebung nicht.
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:
Hinweis:
Die Parameter indicator, proximity, maxResults und suggestions werden in der Wep-App Survey123 nicht unterstützt.
- 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.
Abrufen einer InfraMarker-Tag-ID
Hinweis:
In diesem Abschnitt werden Funktionen beschrieben, die nur in der mobilen Survey123-App verfügbar sind. Diese Funktionen sind nicht in Survey123 Mobile verfügbar.
Verwenden Sie zum Lesen aus oder Schreiben in ein InfraMarker-RFID-Tag die nachfolgend beschriebenen Aussehentypen.
Wenn Sie die Spalte 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 umfassen, 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.
Abrufen eines Wertes von einem Entfernungsmesser
Hinweis:
In diesem Abschnitt werden Funktionen beschrieben, die nur in der mobilen Survey123-App verfügbar sind. Diese Funktionen sind nicht in Survey123 Mobile verfügbar.
Wenn die Spalte 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 vom Typ "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 oder inclination. Zum Beispiel wird mit measurement=height nur der Höhenwert, der vom Entfernungsmesser zurückgegeben wurde, gespeichert.
Aussehen "integer"
Hinweis:
In Survey123 Mobile wird nur das Aussehen spinner für Fragen vom Typ "integer" unterstützt.
In der Survey123-Web-App werden keine dieser Aussehentypen für "integer" unterstützt.
Wenn Sie die Spalte appearance auf spinner festlegen, wird eine Frage vom Typ "integer" mit Schaltflächen angezeigt, mit denen der Wert um jeweils 1 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 Aussehen auf numbers festlegen, wird für eine markierte Frage vom Typ "integer" 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 Frage vom Typ "Integer" eine benutzerdefinierte Taschenrechnertastatur angezeigt, über die ein Wert eingegeben oder geändert werden kann.
Wenn Sie das Aussehen auf distress festlegen, wird eine Frage vom Typ "integer" als Stress-Skala dargestellt. Eine Stress-Skala ist eine 10-Punkte-Skala, mit der Gefühle wie Stress, Schmerzen und Glück gemessen werden.
Aussehen "decimal"
Hinweis:
In Survey123 Mobile wird nur das Aussehen spinner für Fragen vom Typ "decimal" unterstützt.
In der Survey123-Web-App werden keine dieser Aussehentypen für "decimal" unterstützt.
Wenn Sie die Spalte appearance auf spinner festlegen, wird eine Frage vom Typ "decimal" mit Schaltflächen angezeigt, mit denen die letzte Ziffer des Wertes um jeweils 1 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 Standardwert 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 Frage vom Typ "decimal" 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 Frage vom Typ "decimal" 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 Frage vom Typ "decimal" 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.
