Torna all'inizio

Parametri XLSForm

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. Le tabelle seguenti forniscono una panoramica dei parametri che è possibile utilizzare in XLSForm e la colonna del foglio di lavoro del rilevamento che accetta ciascun parametro. Non tutti i parametri sono supportati sia nell'app da campo che la app Web ArcGIS Survey123. Per ulteriori informazioni sul supporto delle app da campo e delle app Web, fare riferimento all'argomento della documentazione per ciascun parametro.

È possibile aggiungere più parametri per una domanda alla stessa colonna separandoli con spazi. Ad esempio, una domanda geoshape può avere i parametri map, method, lineColor e fillColor nella colonna body::esri:style, come di seguito:

map="Imagery Hybrid" method=vertex lineColor=#DC143C fillColor=LightYellow

Generale

La tabella seguente contiene i parametri XLSForm che è possibile utilizzare con vari tipi di domande. Fare riferimento alla descrizione di ciascun parametro per l'elenco dei tipi di domande che lo supportano. Questi parametri sono supportati solo nell'app da campo.

Colonna XLSFormParametroDescrizione
bind::esri:parameterscalculationMode

Controlla quando viene calcolato il calcolo in una domanda.

Tipi di domande: text | decimal | integer | note | date | time | dateTime | select_one | select_multiple | geopoint | calculate | hidden

Valori: auto | manual | always | whenEmpty

Esempi:

calculationMode=manual
calculationMode=always
body::esri:styleplaceholderText

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

Tipi di domande: text | integer | decimal | select_one (con aspetto di autocompletamento) | barcode

Valori: @[hint] | @[guidance_hint]

Esempi:

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

Audio

La tabella seguente contiene i parametri XLSForm che è possibile utilizzare con i tipi di domande audio. Questi parametri sono supportati solo nell'app da campo, a meno che non sia indicato diversamente nella descrizione.

Colonna XLSFormParametroDescrizione
bind::esri:parameterscodec

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
fileName

Specifica il nome file.

Valori: <expression>

Questo parametro è supportato solo nell'app Web.

Esempi:

fileName=concat("JobID-", ${job_id})
fileName=concat(${asset_id}, "_", 
  format-date(now(), "%Y%m%d%H%M%S"))
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
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

Codice a barre

La tabella seguente contiene i parametri XLSForm che è possibile utilizzare con il tipo di domanda barcode. Questi parametri sono supportati solo nell'app da campo.

Colonna XLSFormParametroDescrizione
body::esri:style

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

File

La tabella seguente contiene i parametri XLSForm che è possibile utilizzare con i tipi di domande file.

Colonna XLSFormParametroDescrizione
bind::esri:parametersfileName

Specifica il nome file.

Valori: <expression>

Questo parametro è supportato solo nell'app Web.

Esempi:

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

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

Valore: <megabytes>

Questo parametro è supportato nell'app da campo e nell'app Web.

Esempio:

max-size=5

Gruppi

La tabella seguente contiene i parametri XLSForm che è possibile utilizzare con i tipi di domande begin group. Questi parametri sono supportati solo nell'app da campo.

Colonna XLSFormParametroDescrizione
body::esri:style

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

layout

Imposta lo stile di layout della griglia per un gruppo.

Valori: dynamic-grid | fixed-grid

Esempio:

layout=fixed-grid

Immagini

La tabella seguente contiene i parametri XLSForm che è possibile utilizzare con i tipi di domande image. Questi parametri sono supportati solo nell'app da campo, a meno che non sia indicato diversamente nella descrizione.

Colonna XLSFormParametroDescrizione
bind::esri:parametersallowAdds

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

Valore: false

Esempio:

allowAdds=false
fileName

Specifica il nome file.

Valori: <expression>

Questo parametro è supportato anche nell'app Web.

Esempi:

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

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

Valore: <megabytes>

Questo parametro è supportato anche nell'app Web.

Esempio:

max-size=5

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

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

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=🐻

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"
body::esri:styleallowRename

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

Valori: true | false

Esempio:

allowRename=false
fileNameVisible

Specifica se il nome file è visibile nel rilevamento.

Valori: true | false

Esempio:

fileNameVisible=true
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]
method

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

Questo parametro è supportato anche nell'app Web.

Valori: browse | camera | map

Esempi:

method=camera
method=map
method=browse,camera,map
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
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
parametersmax-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).

Questo parametro è supportato anche nell'app Web.

Valore: <pixels>

Esempi:

max-pixels=1500
max-pixels=400

Domande mappa

La tabella seguente contiene i parametri XLSForm che è possibile utilizzare con i tipi di domande geopoint, geotrace e geoshape: Questi parametri sono supportati solo nell'app da campo, a meno che non sia indicato diversamente nella descrizione.

Colonna XLSFormParametroDescrizione
body::esri:styleheight

Imposta l'altezza dell'anteprima dell'immagine.

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

Esempi:

previewHeight=6lines
previewHeight=250pixels

lineColor²

fillColor³

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 maggiori informazioni, consultare Opzioni di stile.

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

Esempio:

lineColor=Black 
fillColor=#9EFFF5
lineWidth²

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
map

Imposta una mappa di base predefinita.

Questo parametro è supportato anche nell'app Web.

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

Esempi:

map="World Topography"
map=de26a3cf4cc9451298ea173c4b324736

mapTools

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

Questo parametro è supportato solo nell'app da campo.

Valori: search | mapSwitcher | zoom | home | locate

Esempi:

mapTools=zoom
mapTools=search,locate

method²

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

Questo parametro è supportato anche nell'app Web.

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
minCaptureZoomLevel

Specificare il livello minimo di acquisizione della geometria.

Questo parametro è supportato solo nell'app Web.

Valore: <integer>

Esempio:

minCaptureZoomLevel=17

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

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.

Questo parametro è supportato solo nell'app Web.

Valore: <integer>

Esempio:

precision=4

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.

Questo parametro è supportato solo nell'app Web.

Valori: feature | self²

Esempio:

snapMode=feature
snapMode=self
snapMode=self,feature
symbol¹

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

¹Supportato solo dal tipo di domanda geopoint.

²Supportato solo dai tipi di domanda geoshape e geotrace.

³Supportato solo dal tipo di domanda geoshape.

Domande a risposta multipla

La tabella seguente contiene i parametri XLSForm che è possibile utilizzare con i tipi di domande select_one, select_multiple e rank: Questo parametro è supportato nell'app da campo e nell'app Web.

Colonna XLSFormParametroDescrizione
parametersrandomize

Randomizza l'ordine delle scelte in un elenco di scelta

Valori: true

Esempio:

randomize=true

Intervallo

La tabella seguente contiene i parametri XLSForm che è possibile utilizzare con il tipo di domanda range. Questi parametri sono supportati nell'app di campo e nell'app Web.

Colonna XLSFormParametroDescrizione

body::esri:style

startColor

endColor

color

Specifica il colore della barra di scorrimento all'inizio e alla fine dell'intervallo. Utilizzare il parametro color per specificare il colore usato per riempire lo spazio fra l'inizio della barra di scorrimento e il valore selezionato. I parametri devono essere separati da uno spazio. Per maggiori informazioni, consultare Opzioni di stile.

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

Esempi:

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

parametri

start

end

step

Specifica i valori di inizio, fine e passaggio per la barra di scorrimento. I parametri devono essere separati da uno spazio. Per ulteriori informazioni, consultare Parametri di intervallo.

Valori: <integer> | <decimal>

Esempi:

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

Ripetizioni

La tabella seguente contiene i parametri XLSForm che è possibile utilizzare con il tipo di domanda begin repeat. Questi parametri sono supportati solo nell'app da campo.

Colonna XLSFormParametroDescrizione
bind::esri:parametersallowAdds

Consenti di aggiungere nuovi record di ripetizione.

Valori: true | false

Esempio:

allowAdds=true
allowUpdates

Consente la modifica dei record di ripetizione esistenti.

Valori: true | false

Esempio:

allowUpdates=false
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'"
body::esri:style

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

Testo

La tabella seguente contiene i parametri XLSForm che è possibile utilizzare con il tipo di domanda text. Questi parametri sono supportati solo nell'app da campo, a meno che non sia indicato diversamente nella descrizione.

Colonna XLSFormParametroDescrizione
bind::esri:parametersgeocode

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

Questo parametro è supportato anche nell'app Web.

Valore: <locator item ID>

Esempio:

geocode=36ff9e8c13e042a58cfce4ad87f55d19

misurazione

Per una domanda di testo con l'aspetto telemetro, impostare quali misurazioni verranno 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"
body::esri:styledefaultHeight

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
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
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>

Questo parametro è supportato anche nell'app Web.

Esempio:

maxResults=10
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
suggestions

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

Telemetro

La seguente tabella contiene il parametro XLSForm che è possibile utilizzare con i tipi di domanda text, decimal e integer per recuperare i valori da un telemetro. Questi parametri sono supportati solo nell'app da campo, a meno che non sia indicato diversamente nella descrizione.

Colonna XLSFormParametroDescrizione
bind::esri:parameters

misurazione

Per una domanda di testo con l'aspetto telemetro, impostare quali misurazioni verranno 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"

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