Torna all'inizio

Parametri

In questo argomento

  1. Generale
  2. Audio
  3. Codice a barre
  4. File
  5. Gruppi
  6. Immagini
  7. Domande mappa
  8. Domande a risposta multipla
  9. Intervallo
  10. Ripetizioni
  11. Testo
  12. Telemetro

Alcuni tipi di domanda in XLSForm hanno parametri aggiuntivi che permettono di controllare lo stile o il comportamento delle domande in un rilevamento. In alcuni casi, questi parametri sono complementari agli aspetti che un tipo di domanda supporta. Non tutti i parametri sono supportati in tutte le app di invio (Survey123 Mobile, l'app di campo Survey123 e l'app Web Survey123). Per ulteriori informazioni sul supporto delle app, vedi le tabelle dei parametri riportate di seguito, organizzate in base al tipo di domanda e alla colonna XLSForm del foglio di lavoro del sondaggio che accetta ciascun parametro.

È possibile aggiungere più parametri per una domanda alla stessa colonna separandoli con spazi. Ad esempio, una domanda range può avere i parametri startColor, endColor e color nella colonna body::esri:style, come segue:

startColor=Orange endColor=White color=#FF6347

Generale

Questa sezione descrive i parametri che puoi utilizzare nelle colonne XLSForm bind::esri:parameters e body::esri:style per più tipi di domanda.

La tabella seguente descrive il parametro che puoi utilizzare nella colonna XLSForm bind::esri:parameters per i tipi di domanda text, integer, decimal, note, date, time, dateTime, select_one, select_multiple, geopoint, calculate, e hidden.

bind::esri:parameters

ParametroDescrizioneApp di invio
calculationMode

Controlla quando viene calcolato il calcolo in una domanda.

Valori: auto | manual | always | whenEmpty

Esempi:

calculationMode=manual
calculationMode=always

Web app

App di campo

La tabella seguente descrive il parametro che puoi utilizzare nella colonna XLSForm body::esri:style per i tipi di domanda text, integer, decimal, select_one (with autocomplete appearance), select_multiple (con aspetto autocomplete)* e barcode.

body::esri:style

ParametroDescrizioneApp di invio
placeholderText

Specifica il testo che appare nell'area di input della domanda quando la domanda è vuota.

Valori: @[hint] | @[guidance_hint]

Esempi:

placeholderText=@[hint]
placeholderText=@[guidance_hint]

Survey123 Mobile

App di campo

*Supportato solo su Survey123 Mobile.

Audio

La tabella seguente descrive i parametri che puoi utilizzare nella colonna XLSForm bind::esri:parameters per il tipo di domanda audio.

bind::esri:parameters

ParametroDescrizioneApp di invio
codec

Specifica il codec preferito per la registrazione audio. Possono essere forniti più codec separati da virgole. Il primo codec compatibile con il dispositivo verrà utilizzato.

Valore: <codec name>

Esempio:

codec=amr-nb,aac

Survey123 Mobile

App di campo

fileName

Specifica il nome file.

Valori: <expression>

Esempi:

fileName=concat("JobID-", ${job_id})
fileName=concat(${asset_id}, "_", 
  format-date(now(), "%Y%m%d%H%M%S"))

Web app

max-duration

Specifica la durata massima in secondi per una registrazione audio. La durata predefinita nell'app web è 600 (10 minuti).

Valore: <seconds>

Esempio:

max-duration=45

Survey123 Mobile

Web app

App di campo

max-size

Specifica la dimensione massima del file in megabyte per le registrazioni audio. La dimensione predefinita nell'app da campo è 10 MB.

Valore: <megabytes>

Esempio:

max-size=5

Survey123 Mobile

App di campo

Codice a barre

La tabella seguente descrive il parametro che puoi utilizzare nella colonna XLSForm body::esri:style èer il tipo di domanda barcode.

body::esri:style

ParametroDescrizioneApp di invio

barcodeType

Specifica i tipi di codice a barre che gli utenti possono scansionare. Possono essere forniti più tipi separati da virgole. Quando il parametro barcodeType non è fornito, tutti i tipi supportati di codice a barre possono essere scansionati, eccetto aztec, code39, datamatrix, maxicode e pdf417.

Valori: all | 1d | 2d | <barcode types>

  • all: tutti i tipi supportati eccetto code39 e pdf417.
  • 1d: tutti i tipi monodimensionali eccetto code39.
  • 2d: tutti i tipi bidimensionali eccetto pdf417.

Tipi monodimensionali: codabar | code128 | code39 | code93 | ean13 | ean8 | itf | upca | upce | upceanextension

Tipi bidimensionali: aztec | datamatrix | maxicode | pdf417 | qrcode | rss14 | rssexpanded

Esempi:

barcodeType=qrcode,aztec,code128
barcodeType=ean8,itf
barcodeType=2d
barcodeType=pdf417

App di campo

File

La tabella seguente descrive i parametri che puoi utilizzare nella colonna XLSForm bind::esri:parameters per il tipo di domanda file.

bind::esri:parameters

ParametroDescrizioneApp di invio
fileName

Specifica il nome file.

Valori: <expression>

Esempi:

fileName=concat("JobID-", ${job_id})
fileName=concat(${asset_id}, "_", 
  format-date(now(), "%Y%m%d%H%M%S"))

Web app

max-size

Specifica la dimensione massima del file in megabyte. La dimensione predefinita è 10 MB.

Valore: <megabytes>

Esempio:

max-size=5

Web app

Gruppi

La tabella seguente descrive i parametri che puoi utilizzare nella colonna XLSForm body::esri:style per il tipo di domanda begin group.

body::esri:style

ParametroDescrizioneApp di invio

backgroundColor

borderColor

Imposta i colori di sfondo e bordo per un gruppo o una pagina. Per maggiori informazioni, consultare Colori gruppi, pagina e ripetizioni.

Valori: <HTML color name> | <hex color code>

Esempi:

backgroundColor=LightBlue
borderColor=#4682B4
backgroundColor=#C7FFC7 borderColor=#3C6D9E

Survey123 Mobile

App di campo

layout

Imposta lo stile di layout della griglia per un gruppo.

Valori: dynamic-grid | fixed-grid

Esempio:

layout=fixed-grid

App di campo

Immagini

Questa sezione descrive i parametri che puoi utilizzare nelle colonne XLSForm specificate per il tipo di domanda image.

La tabella seguente descrive i parametri che puoi utilizzare nella colonna XLSForm bind::esri:parameters.

bind::esri:parameters

ParametroDescrizioneApp di invio
allowAdds

Disabilita l'aggiunta di nuove immagini durante la modifica di record esistenti.

Valore: false

Esempio:

allowAdds=false

App di campo

fileName

Specifica il nome file.

Valori: <expression>

Esempi:

fileName=concat("JobID-", ${job_id})
fileName=concat(${asset_id}, "_", 
  format-date(now(), "%Y%m%d%H%M%S"))

Web app

App di campo

max-size

Specifica la dimensione massima del file in megabyte. La dimensione predefinita è 10 MB.

Valore: <megabytes>

Esempio:

max-size=5

Web app

smartAnnotation

Per una domanda di immagine con l'aspetto annotate, genera automaticamente le grafiche di annotazione di etichette e caselle di contorno attorno agli oggetti rilevati. Aggiungere queste proprietà per definire lo stile e la formattazione dell'annotazione.

Proprietà richiesta: <model_name>

Proprietà facoltative: minScore | cameraPreview | label | class | boundingBoxes | outlineWidth | fontSize | font | bold | italic

Esempi:

smartAnnotation=modelname
  &cameraPreview=true&minScore=0.52
smartAnnotation=modelname&
  cameraPreview=true&minScore=0.52
  &class=classname1,classname2
  &label=false&bold=true

App di campo

smartAttributes

Eseguire il rilevamento degli oggetti o la classificazione delle immagini e utilizzare i risultati EXIF nel proprio rilevamento.

Proprietà richiesta: <model_name>

Proprietà facoltative: minScore | cameraPreview | label | class

Esempi:

smartAttributes=modelname
  &cameraPreview=true&minScore=0.45
smartAttributes=modelname
  &cameraPreview=true
  &class=classname1,classname2
  &label=false

App di campo

redaction

Generare automaticamente o aggiungere manualmente caselle di contorno e applicare effetti di redazione sulla regione di destinazione.

Proprietà richiesta: <model_name> | @faces | @manual

Proprietà facoltative: minScore | cameraPreview | label | class | effect | symbol | fillColor | scale

Esempi:

redaction=modelname
  &cameraPreview=true&effect=blur
redaction=@manual&effect=blockout
redaction=@faces&cameraPreview=true
  &class=classname1,classname2
  &label=false@effect=symbol&symbol=🐻

App di campo

watermark

topLeftWatermark

topCenterWatermark

topRightWatermark

leftCenterWatermark

centerWatermark

rightCenterWatermark

bottomLeftWatermark

bottomCenterWatermark

bottomRightWatermark

Specificare la posizione della filigrana dell'immagine. Aggiungere proprietà per definire il contenuto e la formattazione. Per ulteriori informazioni, consultare Filigrane.

Proprietà: text | color | outlineColor | outlineWidth | haloColor | size | font | bold | italic | margin | image | imageSize

Esempi:

watermark="Example Text
  &outlineColor=White"
bottomLeftWatermark="Example Text
  &bold=true"
topRightWatermark="@[latitude longitude]
  &size=20"

App di campo

La tabella seguente descrive i parametri che puoi utilizzare nella colonna XLSForm body::esri:style per il tipo di domanda image.

body::esri:style

ParametroDescrizioneApp di invio
allowRename

Specifica se gli utenti sono in grado di modificare manualmente il nome file.

Valori: true | false

Esempio:

allowRename=false

App di campo

fileNameVisible

Specifica se il nome file è visibile nel rilevamento.

Valori: true | false

Esempio:

fileNameVisible=true

App di campo

footerText

Per una domanda immagine con aspetto della firma, specifica il testo da visualizzare nella parte inferiore del popup della firma. Se non viene specificato alcun valore, il suggerimento di orientamento della domanda apparirà sotto la firma. Questo può essere cambiato nel suggerimento della domanda usando footerText=@[hint].

Valori: <none> | @[hint]

Esempi:

footerText
footerText=@[hint]

Survey123 Mobile

App di campo

metodo

Specifica il metodo di acquisizione per una domanda di immagine. Il valore map è supportato solo per le domande di immagine con aspetto di annotazione.

Valori: browse | camera | map

Esempi:

method=camera
method=map
method=browse,camera,map

Web app

App di campo

palette

Per una domanda di immagine con aspetto di disegno o annotazione, specifica una tavolozza degli strumenti di disegno personalizzata.

Valore: <palette name>

Esempio:

palette=SiteLayout

App di campo

previewHeight

Imposta l'altezza dell'anteprima dell'immagine dopo la selezione dell'immagine. Usare previewHeight=0 se si desidera che l'anteprima dell'immagine appaia nel formato massimo senza spazi vuoti non necessari.

Valori: <lines> | <lines>lines | <percentage of screen height>% | <pixels>pixels

Esempi:

previewHeight=3lines
previewHeight=120pixels

App di campo

La tabella seguente descrive il parametro che puoi utilizzare nella colonna XLSForm parameters per il tipo di domanda image.

parameters

ParametroDescrizioneApp di invio
max-pixels

Per una domanda di immagine, imposta la dimensione massima dell'immagine sul bordo più lungo, preservando le proporzioni originali.

Per una domanda di immagine con aspetto di firma, imposta la larghezza massima per il popup della firma.

Per una domanda di immagine con aspetto di disegno, imposta la tela su un'immagine quadrata (1:1).

Valore: <pixels>

Esempi:

max-pixels=1500
max-pixels=400

Web app

App di campo

Domande mappa

La tabella seguente descrive i parametri che puoi utilizzare nelle colonne XLSForm specificate per i tipi di domanda geopoint, geotrace e geoshape.

La tabella seguente descrive il parametro che puoi utilizzare nella colonna XLSForm bind::esri:parameters.

bind::esri:parameters

ParametroDescrizioneApp di invio

geocodifica

Impostare il localizzatore da cui restituire i risultati geocodificati

Valore: <locator item ID>

Esempio:

geocode=36ff9e8c13e042a58cfce4ad87f55d19

Web app

App di campo

La tabella seguente descrive i parametri che puoi utilizzare nella colonna XLSForm body::esri:style per i tipi di domanda geopoint, geotrace e geoshape.

body::esri:style

ParametroDescrizioneApp di invio
height

Imposta l'altezza dell'anteprima dell'immagine.

Valori: <lines> | <lines>lines | <percentage of screen height>% | <pixels>pixels

Esempi:

previewHeight=6lines
previewHeight=250pixels

App di campo

lineColor2

fillColor3

Specifica i colori di linea e di riempimento per la feature linea o la feature poligono. Si applica solo all'anteprima della mappa in Survey123. Per ulteriori informazioni, vedi Simbologia della geometria.

Valori: <HTML color name> | <hex color code>

Esempio:

lineColor=Black 
fillColor=#9EFFF5

Survey123 Mobile

App di campo

lineWidth2

Specifica l'ampiezza della linea in pixel per la feature linea o la feature poligono. Si applica solo all'anteprima della mappa in Survey123.

Valore: <pixels>

Esempi:

lineWidth=3

Survey123 Mobile

App di campo

map

Imposta una mappa di base predefinita.

Valori: <map name> | <map item ID>

Esempi:

map="World Topography"
map=de26a3cf4cc9451298ea173c4b324736

Web app

App di campo

mapTools

Controllare gli strumenti della mappa disponibili per le domande geopoint, geotrace e geoshape.

Valori: search | mapSwitcher | zoom | home | locate

Esempi:

mapTools=zoom
mapTools=search,locate

App di campo

method2

Specifica il metodo di acquisizione. Quando si utilizza il metodo vertice, possono essere impostati parametri aggiuntivi.

Valori: sketch | vertex

Valori aggiuntivi per vertice, applicabili solo nell'app di campo: streaming | beep | haptic | edit

Esempi:

method=vertex
method=vertex,streaming
method=vertex,streaming,haptic

Web app

App di campo

minCaptureZoomLevel

Specificare il livello minimo di acquisizione della geometria.

Valore: <integer>

Esempio:

minCaptureZoomLevel=17

Web app

overlay

Visualizza le posizioni di punto dalla prima domanda geopoint con una ripetizione su una qualsiasi altra domanda geopoint, geoshape o geotrace nel rilevamento. Aggiungere proprietà per definire il contenuto e lo stile.

Valore: <repeat name>

Proprietà: view | preview | icon | iconColor | iconOutlineColor | iconSize | label | labelColor | labelOutlineColor | fontSize

Esempi:

overlay=campsites&preview=true
overlay=hydrants&label=asset_id&icon=hydrant&iconColor=Red

App di campo

precision

Specifica il numero di posizioni decimali che saranno acquisite nella domanda mappa e mostrate nel pannello di risposta individuale nel rilevamento. Quando questo parametro non è impostato, tutte le posizioni decimali disponibili vengono acquisite nella domanda mappa ma solo sei di esse vengono mostrate nel pannello di risposta individuale.

Valore: <integer>

Esempio:

precision=4

Web app

snapMode

Specifica il comportamento della gestione delle tolleranze. I punti possono essere agganciati ad altre feature, mentre le linee e i poligoni possono essere agganciati ad altre feature o a loro stessi. Disponibile solo quando method=vertex.

Valori: feature | self2

Esempio:

snapMode=feature
snapMode=self
snapMode=self,feature

Web app

symbol1

Specifica un file .png da utilizzare come marcatore di punto sulla mappa. Aggiungere proprietà per definire la posizione e la scala.

Valore: <file name>.png

Proprietà: x | y | scale

Esempio:

symbol=meter.png?x=0.6&y=0.1&scale=1.5

App di campo

1 - Supportato solo dal tipo di domanda geopoint.

2 - Supportato solo dai tipi di domanda geoshape e geotrace.

3 - Supportato solo dal tipo di domanda geoshape.

Domande a risposta multipla

La tabella seguente descrive il parametro che puoi utilizzare nella colonna XLSForm parameters per i tipi di domanda select_one, select_multiple e rank.

parameters

ParametroDescrizioneApp di invio
randomize

Randomizza l'ordine delle scelte in un elenco di scelta

Valori: true

Esempio:

randomize=true

Web app

App di campo

Intervallo

Questa sezione descrive i parametri che puoi utilizzare nelle colonne XLSForm specificate per il tipo di domanda range. Quando li combini, i parametri devono essere separati da uno spazio.

La tabella seguente descrive i parametri che puoi utilizzare nella colonna XLSForm body::esri:style. Per maggiori informazioni, consultare Opzioni di stile.

body::esri:style

ParametroDescrizioneApp di invio

startColor

endColor

color

Specifica i colori per il dispositivo di scorrimento dell'intervallo:

  • Colore del cursore all'inizio dell'intervallo.
  • Colore del cursore alla fine dell'intervallo.
  • Colore che riempie lo spazio tra l'inizio del cursore e il valore selezionato.

Valori: <HTML color name> | <hex color code>

Esempi:

startColor=Blue endColor=Red
startColor=Orange endColor=White color=#FF6347
endColor=#262626 color=Yellow

Survey123 Mobile

Web app

App di campo

La tabella seguente descrive i parametri che puoi utilizzare nella colonna XLSForm parameters per il tipo di domanda range. Per ulteriori informazioni, vedi Parametri del dispositivo di scorrimento dell'intervallo.

parameters

ParametroDescrizioneApp di invio

start

end

step

Specifica i valori di inizio, fine e passaggio per la barra di scorrimento.

Valori: <integer> | <decimal>

Esempi:

start=0 end=50 step=5
start=10.25 end=1 step=0.25

Survey123 Mobile

Web app

App di campo

Ripetizioni

Questa sezione descrive i parametri che puoi utilizzare nelle colonne XLSForm specificate per il tipo di domanda begin repeat.

La tabella seguente descrive i parametri che puoi utilizzare nella colonna XLSForm bind::esri:parameters.

bind::esri:parameters

ParametroDescrizioneApp di invio
allowAdds

Consenti di aggiungere nuovi record di ripetizione.

Valori: true | false

Esempio:

allowAdds=true

App di campo

allowUpdates

Consente la modifica dei record di ripetizione esistenti.

Valori: true | false

Esempio:

allowUpdates=false

App di campo

query

Consente di mostrare i record di ripetizione esistenti nel modulo. Specificare parametri di interrogazione aggiuntivi per filtrare i record disponibili.

Valori: <none> | "SQL statement"

Esempi:

query
query="severity='high'"

App di campo

La tabella seguente descrive i parametri che puoi utilizzare nella colonna XLSForm body::esri:style per il tipo di domanda begin repeat.

body::esri:style

ParametroDescrizioneApp di invio

backgroundColor

borderColor

Imposta i colori di sfondo e bordo per una ripetizione. Per maggiori informazioni, consultare Colori gruppi, pagina e ripetizioni.

Valori: <HTML color name> | <hex color code>

Esempi:

backgroundColor=LightBlue
borderColor=#4682B4
backgroundColor=#C7FFC7 borderColor=#3C6D9E

Survey123 Mobile

App di campo

addRecordMode

Per un elemento ripetuto con aspetto tabular, specifica la modalità per il pulsante Aggiungi record e l'opzione Copia in un nuovo record nella vista tabulare. L'impostazione predefinita è row. Quando il valore è row, il nuovo record viene aggiunto alla vista tabulare. Quando il valore è form, il nuovo record viene aperto nella vista modulo.

Valori: row | form

Esempio:

addRecordMode=form

Survey123 Mobile

editInFormView

Per un elemento ripetuto con aspetto tabular, mostra o nascondi l'opzione Modifica nella vista modulo nella vista tabulare. L'impostazione predefinita è true.

Nota:

Quando l'elemento ripetuto contiene errori, l'opzione Modifica nella vista modulo è abilitata anche quando il parametro editInFormView è impostato su false.

Valori: true | false

Esempio:

editInFormView=false

Survey123 Mobile

copyToNewRecord

Per un elemento ripetuto con aspetto tabular, mostra o nascondi l'opzione Copia in un nuovo record nella vista tabulare. Questa opzione consente agli utenti di duplicare un record nell'elemento ripetuto. L'impostazione predefinita è true. Il parametro addRecordMode determina come viene aggiunto il record duplicato.

Valori: true | false

Esempio:

copyToNewRecord=true

Survey123 Mobile

editInTabularView

Per un elemento ripetuto con aspetto tabular, abilita o disabilita la modifica nella vista tabulare. L'impostazione predefinita è true. Quando il valore è false, tutte le celle nella vista tabulare sono di sola lettura.

Valori: true | false

Esempio:

editInTabularView=false

Survey123 Mobile

La tabella seguente descrive il parametro che puoi utilizzare nella colonna XLSForm body::esri:style per le domande negli elementi ripetuti tabular.

body::esri:style

ParametroDescrizioneApp di invio

showInTabularView

Per un elemento ripetuto con aspetto tabular, mostra la domanda come colonna nella vista tabulare. L'impostazione predefinita è false.

Valori: true | false

Esempio:

showInTabularView=true

Survey123 Mobile

Testo

Questa sezione descrive i parametri che puoi utilizzare nelle colonne XLSForm specificate per il tipo di domanda text.

La tabella seguente descrive i parametri che puoi utilizzare nella colonna XLSForm bind::esri:parameters.

bind::esri:parameters

ParametroDescrizioneApp di invio
geocodifica

Per una domanda di testo con aspetto geocode, imposta il localizzatore in modo da restituire i risultati geocodificati quando si usa l'aspetto geocode.

Valore: <locator item ID>

Esempio:

geocode=36ff9e8c13e042a58cfce4ad87f55d19

Web app

App di campo

La tabella seguente descrive i parametri che puoi utilizzare nella colonna XLSForm body::esri:style per il tipo di domanda text.

body::esri:style

ParametroDescrizioneApp di invio
defaultHeight

Imposta l'altezza iniziale della casella di testo per le domande di testo con aspetto multilinea. L'altezza della casella di testo aumenterà per adattarsi al testo della risposta.

Valore: <number of lines>

Esempio:

defaultHeight=5

App di campo

indicator

Per una domanda di testo con aspetto geocode, consente ai risultati geocodificati di mostrare la direzione e la distanza dalla posizione corrente del dispositivo.

Valori: direction | distance | none

Esempi:

indicator=none
indicator=direction
indicator=direction,distance

App di campo

maxResults

Per una domanda di testo con aspetto geocode, specifica il numero massimo di risultati da restituire. L’impostazione predefinita è 6.

Valore: <number of results>

Esempio:

maxResults=10

Web app

App di campo

proximity

Per una domanda di testo con aspetto geocode, specifica se i risultati geocodificati mostrano solo i risultati entro un certo raggio dalla posizione del dispositivo.

Valori: <distance>m | km | ft | mi | yd

Esempi:

proximity=3km
proximity=1000ft

App di campo

suggerimenti

Per una domanda Testo con aspetto di geocodifica, modificare il modo in cui vengono inseriti i suggerimenti. Il valore predefinito è Sì.

Valori: yes | no

Esempio:

suggestions=no

App di campo

Telemetro

La tabella seguente descrive il parametro che puoi utilizzare nella colonna XLSForm bind::esri:parameters per i tipi di domandathe text, integer e decimal per recuperare valori da un telemetro.

bind::esri:parameters

ParametroDescrizioneApp di invio

misurazione

Per una domanda di testo, decimale o numero intero con comparsa di telemetro, impostare quali misurazioni saranno memorizzate nella domanda. Racchiudere l'elenco di valori all'interno di virgolette se i valori includono spazi.

Valori: height | azimuth | horizontalDistance | slopeDistance | inclination | multipleHeights

Esempi:

measurement=height
measurement=height,azimuth,horizontalDistance
measurement="multipleHeights,Height 1,Height 2"

App di campo

Qualche feedback su questo argomento?

In questo argomento
  1. Generale
  2. Audio
  3. Codice a barre
  4. File
  5. Gruppi
  6. Immagini
  7. Domande mappa
  8. Domande a risposta multipla
  9. Intervallo
  10. Ripetizioni
  11. Testo
  12. Telemetro