Einige Fragetypen in XLSForm weisen zusätzliche Parameter auf, mit denen Sie den Style oder das Verhalten von Fragen in einem Survey steuern können. In einigen Fällen ergänzen diese Parameter das von einem Fragetyp unterstützte Aussehen. Nicht alle Parameter werden in allen Apps für die Übermittlung (Survey123 Mobile, die mobile Survey123-App und die Survey123-Web-App) unterstützt. Weitere Informationen zur App-Unterstützung finden Sie in den nachstehenden Parametertabellen, die nach Fragetyp und der Spalte "XLSForm" im Survey-Arbeitsblatt gegliedert sind, in der die jeweiligen Parameter eingegeben werden können.
Sie können zu einer Spalte mehrere Parameter für eine Frage hinzufügen, indem Sie die einzelnen Parameter durch Leerzeichen voneinander trennen. Beispiel: Eine Frage vom Typ range kann wie folgt die Parameter startColor, endColor und color in der Spalte body::esri:style aufweisen:startColor=Orange endColor=White color=#FF6347
Allgemein
In diesem Abschnitt werden die Parameter beschrieben, die Sie in den XLSForm-Spaltenbind::esri:parameters und body::esri:style für verschiedene Fragetypen verwenden können.
In der folgenden Tabelle werden die Parameter beschrieben, die Sie in der XLSForm-Spalte bind::esri:parameters für die Fragetypen text, integer, decimal, note, date, time, dateTime, select_one, select_multiple, geopoint, calculate und hidden verwenden können.
bind::esri:parameters
| Parameter | Beschreibung | App für die Übermittlung |
|---|---|---|
| calculationMode | Legen Sie fest, wann die Berechnung in einer Frage erfolgen soll. Werte: auto | manual | always | whenEmpty Beispiele: | Web-App Mobile App |
In der folgenden Tabelle werden die Parameter beschrieben, die Sie in der XLSForm-Spalte body::esri:style für die Fragetypen text, integer, decimal, select_one (mit automatischer Vervollständigung des Aussehens), select_multiple (mit automatischer Vervollständigung des Aussehens)* und barcode verwenden können.
body::esri:style
| Parameter | Beschreibung | App für die Übermittlung |
|---|---|---|
| placeholderText | Geben Sie den Text an, der im Eingabebereich der Frage angezeigt werden soll, wenn die Frage leer ist. Werte: @[hint] | @[guidance_hint] Beispiele: | Survey123 Mobile Mobile App |
*Nur von Survey123 Mobile unterstützt.
Audio
In der folgenden Tabelle werden die Parameter beschrieben, die Sie in der XLSForm-Spalte bind::esri:parameters für den Fragetyp audio verwenden können.
bind::esri:parameters
| Parameter | Beschreibung | App für die Übermittlung |
|---|---|---|
| codec | Geben Sie den bevorzugten Codec für eine Audioaufzeichnung an. Es können mehrere durch Kommas getrennte Codecs angegeben werden. Es wird der erste mit dem Gerät kompatible Codec verwendet. Wert: <codec name> Beispiel: | Survey123 Mobile Mobile App |
| fileName | Geben Sie den Dateinamen an. Werte: <expression> Beispiele: | Web-App |
| max-duration | Geben Sie die maximale Dauer in Sekunden für eine Audioaufzeichnung an. Die Standarddauer in der Web-App ist 600 (10 Minuten). Wert: <seconds> Beispiel: | Survey123 Mobile Web-App Mobile App |
| max-size | Geben Sie die maximale Dateigröße in Megabyte für eine Audioaufzeichnung an. Die Standardgröße in der mobilen App beträgt 10 MB. Wert: <megabytes> Beispiel: | Survey123 Mobile Mobile App |
Barcode
In der folgenden Tabelle werden die Parameter beschrieben, die Sie in der XLSForm-Spalte body::esri:style für den Fragetyp barcode verwenden können.
body::esri:style
| Parameter | Beschreibung | App für die Übermittlung |
|---|---|---|
Geben Sie die Typen der Barcodes an, die von Benutzern gescannt werden können. Es können mehrere durch Kommas getrennte Typen angegeben werden. Wenn der Parameter barcodeType nicht angegeben wird, können Barcodes aller unterstützten Typen mit Ausnahme von aztec, code39, datamatrix, maxicode und pdf417 gescannt werden. Werte: all | 1d | 2d | <barcode types>
Eindimensionale Typen: codabar | code128 | code39 | code93 | ean13 | ean8 | itf | upca | upce | upceanextension Zweidimensionale Typen: aztec | datamatrix | maxicode | pdf417 | qrcode | rss14 | rssexpanded Beispiele: | Mobile App |
Datei
In der folgenden Tabelle werden die Parameter beschrieben, die Sie in der XLSForm-Spalte bind::esri:parameters für den Fragetyp file verwenden können.
bind::esri:parameters
| Parameter | Beschreibung | App für die Übermittlung |
|---|---|---|
| fileName | Geben Sie den Dateinamen an. Werte: <expression> Beispiele: | Web-App |
| max-size | Geben Sie die maximale Dateigröße in Megabyte an. Der Standardwert ist 10 MB. Wert: <megabytes> Beispiel: | Web-App |
Gruppen
In der folgenden Tabelle werden die Parameter beschrieben, die Sie in der XLSForm-Spalte body::esri:style für den Fragetyp begin group verwenden können.
body::esri:style
| Parameter | Beschreibung | App für die Übermittlung |
|---|---|---|
| backgroundColor borderColor | Legen Sie die Hintergrund- und Rahmenfarben für eine Gruppe oder Seite fest. Weitere Informationen finden Sie unter Farben für Gruppen, Seiten und Wiederholungen. Werte: <HTML color name> | <hex color code> Beispiele:
| Survey123 Mobile Mobile App |
| Legen Sie den Gitter-Layout-Style für eine Gruppe fest. Werte: dynamic-grid | fixed-grid Beispiel: | Mobile App |
Bilder
In diesem Abschnitt werden die Parameter beschrieben, die Sie in den XLSForm-Spalten für den Fragetyp image verwenden können.
In der folgenden Tabelle werden die Parameter beschrieben, die Sie in der XLSForm-Spalte bind::esri:parameters verwenden können.
bind::esri:parameters
| Parameter | Beschreibung | App für die Übermittlung |
|---|---|---|
| allowAdds | Deaktivieren Sie das Hinzufügen neuer Bilder beim Bearbeiten vorhandener Datensätze. Wert: false Beispiel: | Mobile App |
| fileName | Geben Sie den Dateinamen an. Werte: <expression> Beispiele: | Web-App Mobile App |
| max-size | Geben Sie die maximale Dateigröße in Megabyte an. Der Standardwert ist 10 MB. Wert: <megabytes> Beispiel: | Web-App |
Für eine Bildfrage mit dem Aussehen annotate werden automatisch Annotationsgrafiken von Beschriftungen und Rahmen um die erkannten Objekte generiert. Hängen Sie diese Eigenschaften an, um den Style und die Formatierung der Annotation zu definieren. Erforderliche Eigenschaft: <model_name> Optionale Eigenschaften: minScore | cameraPreview | label | class | boundingBoxes | outlineWidth | fontSize | font | bold | italic Beispiele: | Mobile App | |
Durchführen einer Objekterkennung oder Bildklassifizierung und Verwenden der EXIF-Ergebnisse im Survey. Erforderliche Eigenschaft: <model_name> Optionale Eigenschaften: minScore | cameraPreview | label | class Beispiele: | Mobile App | |
Automatisches Generieren oder manuelles Hinzufügen von umgebenden Rechtecken und Anwenden von Schwärzungseffekten auf die Zielregion. Erforderliche Eigenschaft: <model_name> | @faces | @manual Optionale Eigenschaften: minScore | cameraPreview | label | class | effect | symbol | fillColor | scale Beispiele: | Mobile App | |
watermark topLeftWatermark topCenterWatermark topRightWatermark leftCenterWatermark centerWatermark rightCenterWatermark bottomLeftWatermark bottomCenterWatermark bottomRightWatermark | Geben Sie die Position eines Bildwasserzeichens an. Hängen Sie Eigenschaften an, um den Inhalt und die Formatierung zu definieren. Weitere Informationen finden Sie unter Wasserzeichen. Eigenschaften: text | color | outlineColor | outlineWidth | haloColor | size | font | bold | italic | margin | image | imageSize Beispiele: | Mobile App |
In der folgenden Tabelle werden die Parameter beschrieben, die Sie in der XLSForm-Spalte body::esri:style für den Fragetyp image verwenden können.
body::esri:style
| Parameter | Beschreibung | App für die Übermittlung |
|---|---|---|
| allowRename | Geben Sie an, ob Benutzer den Dateinamen manuell bearbeiten können. Werte: true | false Beispiel: | Mobile App |
| fileNameVisible | Geben Sie an, ob der Dateiname im Survey sichtbar sein soll. Werte: true | false Beispiel: | Mobile App |
| footerText | Geben Sie für eine Bildfrage mit dem Aussehen "signature" den Text an, der unten im Pop-up für die Unterschrift angezeigt werden soll. Wenn kein Wert angegeben wird, wird der Hinweis zur Frage unterhalb der Unterschrift angezeigt. Mithilfe von footerText=@[hint] kann der Hinweis zur Anleitung in den Hinweis der Frage geändert werden. Werte: <none> | @[hint] Beispiele: | Survey123 Mobile Mobile App |
| method | Geben Sie die Erfassungsmethode für eine Bildfrage an. Der Wert map wird nur für Bildfragen mit dem Aussehen "annotate" unterstützt. Werte: browse | camera | map Beispiele: | Web-App Mobile App |
| palette | Geben Sie für eine Bildfrage mit dem Aussehen "draw" oder "annotate" eine benutzerdefinierte Palette mit Zeichenwerkzeugen an. Wert: <palette name> Beispiel: | Mobile App |
| previewHeight | Legen Sie nach Auswahl eines Bildes die Höhe der Bildvorschau fest. Verwenden Sie previewHeight=0, wenn die Bildvorschau in maximaler Größe ohne unnötigen Leerraum dargestellt werden soll. Werte: <lines> | <lines>lines | <percentage of screen height>% | <pixels>pixels Beispiele: | Mobile App |
In der folgenden Tabelle wird der Parameter beschrieben, den Sie in der XLSForm-Spalte parameters für den Fragetyp image verwenden können.
parameters
| Parameter | Beschreibung | App für die Übermittlung |
|---|---|---|
| max-pixels | Legen Sie für eine Bildfrage die maximale Bildgröße an der längsten Kante fest, während das Seitenverhältnis des Bildes beibehalten wird. Legen Sie für eine Bildfrage mit dem Aussehen "signature" die maximale Breite des Pop-ups für die Unterschrift fest. Legen Sie für eine Bildfrage mit dem Aussehen "draw" die Zeichenfläche auf ein quadratisches Bild (1:1) fest. Wert: <pixels> Beispiele: | Web-App Mobile App |
Kartenfragen
In der folgenden Tabelle werden die Parameter beschrieben, die Sie in den angegebenen XLSForm-Spalten für die Fragetypen geopoint, geotrace und geoshape verwenden können.
In der folgenden Tabelle werden der Parameter beschrieben, den Sie in der XLSForm-Spalte bind::esri:parameters verwenden können.
bind::esri:parameters
| Parameter | Beschreibung | App für die Übermittlung |
|---|---|---|
Legen Sie den Locator fest, von dem die geokodierten Ergebnisse zurückgegeben werden. Wert: <locator item ID> Beispiel: | Web-App Mobile App |
In der folgenden Tabelle werden die Parameter beschrieben, die Sie in der XLSForm-Spalte body::esri:style für die Fragetypen geopoint, geotrace und geoshape verwenden können.
body::esri:style
| Parameter | Beschreibung | App für die Übermittlung |
|---|---|---|
| height | Legen Sie die Höhe der Kartenvorschau fest. Werte: <lines> | <lines>lines | <percentage of screen height>% | <pixels>pixels Beispiele: | Mobile App |
lineColor2 fillColor3 | Geben Sie die Linien- und Füllfarben für das Linien- bzw. Polygon-Feature an. Dies betrifft nur die Kartenvorschau in Survey123. Weitere Informationen finden Sie unter Geopunkt-Symbolisierung. Werte: <HTML color name> | <hex color code> Beispiel: | Survey123 Mobile Mobile App |
| lineWidth2 | Geben Sie die Linienbreite in Pixeln für das Linien- bzw. Polygon-Feature an. Dies betrifft nur die Kartenvorschau in Survey123. Wert: <pixels> Beispiele: | Survey123 Mobile Mobile App |
| map | Legen Sie eine Standard-Grundkarte fest. Werte: <map name> | <map item ID> Beispiele: | Web-App Mobile App |
mapTools | Steuern der Kartenwerkzeuge, die für Fragen vom Typ "geopoint", "geotrace" und "geoshape" verfügbar sind. Werte: search | mapSwitcher | zoom | home | locate Beispiele: | Mobile App |
| method2 | Geben Sie die Erfassungsmethode an. Bei Verwendung der Methode "Stützpunkt" können Sie zusätzliche Parameter festlegen. Werte: sketch | vertex Zusätzliche Stützpunktwerte (nur in der mobilen App unterstützt): streaming | beep | haptic | edit Beispiele: | Web-App Mobile App |
| minCaptureZoomLevel | Geben Sie die minimale Erfassungsebene für die Geometrie an. Wert: <integer> Beispiel: | Web-App |
| overlay | Zeigen Sie Punktpositionen aus der ersten Frage vom Typ "geopoint" innerhalb einer Wiederholung in einer beliebigen anderen Frage vom Typ "geopoint", "geoshape" oder "geotrace" in Ihrem Survey an. Hängen Sie Eigenschaften an, um den Inhalt und den Style zu definieren. Wert: <repeat name> Eigenschaften: view | preview | icon | iconColor | iconOutlineColor | iconSize | label | labelColor | labelOutlineColor | fontSize Beispiele: | Mobile App |
precision | Geben Sie die Anzahl der Dezimalstellen an, die sowohl in der Kartenfrage erfasst als auch im Fenster "Einzelne Antwort" im Survey angezeigt werden. Wird dieser Parameter nicht festgelegt, werden alle verfügbaren Dezimalstellen in der Kartenfrage erfasst, aber nur sechs Dezimalstellen werden im Fenster "Einzelne Antwort" angezeigt. Wert: <integer> Beispiel: | Web-App |
| snapMode | Geben Sie das Fangverhalten an. Punkte können an anderen Features gefangen werden, und Linien und Polygone können an anderen Features oder an sich selbst gefangen werden. Nur verfügbar, wenn method=vertex verwendet wird. Werte: feature | self2 Beispiel: | Web-App |
| symbol1 | Geben Sie eine .png-Datei an, die als Punktmarker auf der Karte verwendet werden soll. Hängen Sie Eigenschaften an, um die Position und den Maßstab zu definieren. Wert: <file name>.png Eigenschaften: x | y | scale Beispiel: | Mobile App |
1Wird nur vom Fragetyp geopoint unterstützt.
2Wird nur von den Fragetypen geoshape und geotrace unterstützt.
3Wird nur vom Fragetyp geoshape unterstützt.
Multiple-Choice-Fragen
In der folgenden Tabelle werden die Parameter beschrieben, die Sie in der XLSForm-Spalte parameters für die Fragetypen select_one, select_multiple und rank verwenden können.
parameters
| Parameter | Beschreibung | App für die Übermittlung |
|---|---|---|
| randomize | Zufälliges Festlegen der Reihenfolge der Fragen in einer Auswahlliste. Werte: true Beispiel: | Web-App Mobile App |
Bereich
In diesem Abschnitt werden die Parameter beschrieben, die Sie in den XLSForm-Spalten für den Fragetyp range verwenden können. Kombinationen verschiedener Parameter müssen durch Leerzeichen voneinander getrennt werden.
In der folgenden Tabelle werden die Parameter beschrieben, die Sie in der XLSForm-Spalte body::esri:style verwenden können. Weitere Informationen finden Sie unter Style-Optionen.
body::esri:style
| Parameter | Beschreibung | App für die Übermittlung |
|---|---|---|
startColor endColor color | Geben Sie die Farben für den Bereichsschieberegler an:
Werte: <HTML color name> | <hex color code> Beispiele: | Survey123 Mobile Web-App Mobile App |
In der folgenden Tabelle werden die Parameter beschrieben, die Sie in der XLSForm-Spalte parameters für den Fragetyp range verwenden können. Weitere Informationen finden Sie unter Parameter für Bereichsschieberegler.
parameters
| Parameter | Beschreibung | App für die Übermittlung |
|---|---|---|
start end step | Geben Sie den Start-, End- und Schrittwert für den Bereichsschieberegler an. Werte: <integer> | <decimal> Beispiele: | Survey123 Mobile Web-App Mobile App |
Wiederholungen
In diesem Abschnitt werden die Parameter beschrieben, die Sie in den XLSForm-Spalten für den Fragetyp begin repeat verwenden können.
In der folgenden Tabelle werden die Parameter beschrieben, die Sie in der XLSForm-Spalte bind::esri:parameters verwenden können.
bind::esri:parameters
| Parameter | Beschreibung | App für die Übermittlung |
|---|---|---|
| allowAdds | Lässt das Hinzufügen neuer Wiederholungsdatensätze zu. Werte: true | false Beispiel: | Mobile App |
| allowUpdates | Lässt das Modifizieren vorhandener Wiederholungsdatensätze zu. Werte: true | false Beispiel: | Mobile App |
| query | Lässt die Anzeige vorhandener Wiederholungsdatensätze im Formular zu. Geben Sie zusätzliche Abfrageparameter an, um die verfügbaren Datensätze zu filtern. Werte: <none> | "SQL statement" Beispiele: | Mobile App |
In der folgenden Tabelle werden die Parameter beschrieben, die Sie in der XLSForm-Spalte body::esri:style für den Fragetyp begin repeat verwenden können.
body::esri:style
| Parameter | Beschreibung | App für die Übermittlung |
|---|---|---|
| backgroundColor borderColor | Legen Sie die Hintergrund- und Rahmenfarben für eine Wiederholung fest. Weitere Informationen finden Sie unter Farben für Gruppen, Seiten und Wiederholungen. Werte: <HTML color name> | <hex color code> Beispiele:
| Survey123 Mobile Mobile App |
Für eine Wiederholung mit tabellarischem Aussehen geben Sie den Modus für die Schaltfläche Datensatz hinzufügen und die Option In neuen Datensatz kopieren in der tabellarischen Ansicht an. Die Standardeinstellung ist row. Wenn der Wert row ist, wird der neue Datensatz an die tabellarische Ansicht angehängt. Wenn der Wert form ist, wird der neue Datensatz in der Formularansicht geöffnet. Werte: row | form Beispiel: | Survey123 Mobile | |
Für eine Wiederholung mit tabellarischem Aussehen blenden Sie die Option In Formularansicht bearbeiten in der tabellarischen Ansicht ein oder aus. Die Standardeinstellung ist true. Hinweis:Wenn die Wiederholung Fehler enthält, steht die Option In Formularansicht bearbeiten zur Verfügung, selbst wenn der Parameter editInFormView auf false festgelegt ist. Werte: true | false Beispiel: | Survey123 Mobile | |
Für eine Wiederholung mit tabellarischem Aussehen blenden Sie die Option In neuen Datensatz kopieren in der tabellarischen Ansicht ein oder aus. Mit dieser Option können Benutzer einen Datensatz in der Wiederholung duplizieren. Die Standardeinstellung ist true. Der Parameter addRecordMode legt fest, wie der duplizierte Datensatz hinzugefügt wird. Werte: true | false Beispiel: | Survey123 Mobile | |
Für eine Wiederholung mit tabellarischem Aussehen aktivieren oder deaktivieren Sie die Bearbeitungsfunktion. Die Standardeinstellung ist true. Wenn der Wert false ist, sind alle Zellen in der tabellarischen Ansicht schreibgeschützt. Werte: true | false Beispiel: | Survey123 Mobile |
In der folgenden Tabelle wird der Parameter beschrieben, den Sie in der XLSForm-Spalte body::esri:style für Fragen in tabellarischen Wiederholungen verwenden können.
body::esri:style
| Parameter | Beschreibung | App für die Übermittlung |
|---|---|---|
Für eine Wiederholung mit tabellarischem Aussehen zeigen Sie die Frage als Spalte in der tabellarischen Ansicht an. Die Standardeinstellung ist false. Werte: true | false Beispiel: | Survey123 Mobile |
Text
In diesem Abschnitt werden die Parameter beschrieben, die Sie in den XLSForm-Spalten für den Fragetyp text verwenden können.
In der folgenden Tabelle werden die Parameter beschrieben, die Sie in der XLSForm-Spalte bind::esri:parameters verwenden können.
bind::esri:parameters
| Parameter | Beschreibung | App für die Übermittlung |
|---|---|---|
| Geokodierung | Legen Sie für eine Textfrage mit dem Aussehen "geocode" den Locator fest, von dem geokodierte Ergebnisse zurückgegeben werden sollen, wenn das Aussehen "geocode" verwendet wird. Wert: <locator item ID> Beispiel: | Web-App Mobile App |
In der folgenden Tabelle werden die Parameter beschrieben, die Sie in der XLSForm-Spalte body::esri:style für den Fragetyp text verwenden können.
body::esri:style
| Parameter | Beschreibung | App für die Übermittlung |
|---|---|---|
| defaultHeight | Legen Sie für eine Textfrage mit dem Aussehen "multiline" die anfängliche Höhe des Textfeldes fest. Die Höhe des Textfeldes passt sich der Länge des Antworttextes an. Wert: <number of lines> Beispiel: | Mobile App |
| indicator | Geben Sie für eine Textfrage mit dem Aussehen "geocode" an, ob in den geokodierten Ergebnissen die Richtung und Entfernung von der aktuellen Geräteposition angezeigt werden sollen. Werte: direction | distance | none Beispiele: | Mobile App |
| maxResults | Geben Sie für eine Textfrage mit dem Aussehen "geocode" die maximale Anzahl der Ergebnisse an, die zurückgegeben werden sollen. Die Standardeinstellung ist 6. Wert: <number of results> Beispiel: | Web-App Mobile App |
| proximity | Geben Sie für eine Textfrage mit dem Aussehen "geocode" an, ob in den geokodierten Ergebnissen nur Ergebnisse innerhalb eines bestimmten Radius der Geräteposition angezeigt werden sollen. Werte: <distance>m | km | ft | mi | yd Beispiele: | Mobile App |
| suggestions | Für eine Textfrage mit dem Aussehen "geocode" wird geändert, wie Vorschläge befüllt werden. Der Standardwert ist "yes". Werte: yes | no Beispiel: | Mobile App |
Entfernungsmesser
In der folgenden Tabelle werden die Parameter beschrieben, die Sie in der XLSForm-Spalte bind::esri:parameters für die Fragetypen text, integer und decimal verwenden können, um Werte aus einem Entfernungsmesser abzurufen.
bind::esri:parameters
| Parameter | Beschreibung | App für die Übermittlung |
|---|---|---|
measurement | Legen Sie die Messwerte fest, die in einer Frage vom Typ "text", "decimal" oder "integer" mit dem Aussehen "rangefinder" gespeichert werden sollen. Schließen Sie die Werteliste in Anführungszeichen ein, wenn die Werte Leerzeichen enthalten. Werte: height | azimuth | horizontalDistance | slopeDistance | inclination | multipleHeights Beispiele: | Mobile App |