Le colonne personalizzate di Esri per XLSForm offrono funzionalità aggiuntive agli utenti di Survey123.
Tipo di campo
Usare la colonna personalizzata bind::esri:fieldType per controllare il tipo di un campo da creare in ArcGIS per le domande del sondaggio. Sono supportati i valori campo nella seguente tabella:
| Valore campo | Risultato |
|---|---|
| esriFieldTypeDate | Valori di data e ora |
esriFieldTypeDateOnly | Valori solo data senza valori ora |
esriFieldTypeTimeOnly | Valori solo ora senza valori data |
esriFieldTypeTimestampOffset* | Data, ora e valore di offset da UTC |
esriFieldTypeSingle | Numero a virgola mobile con precisione singola |
| esriFieldTypeDouble | Numero a virgola mobile con doppia precisione |
| esriFieldTypeGUID | Identificatore univoco globale |
| esriFieldTypeSmallInteger | Numeri interi (16 bit) |
| esriFieldTypeInteger | Numeri interi (32 bit) |
| esriFieldTypeBigInteger | Numeri interi (64 bit) |
| esriFieldTypePointZ | Abilita l'acquisizione del valore dell'altitudine nei geopoint. |
| esriFieldTypeString | Una serie di simboli alfanumerici |
| null | Campo vuoto; non memorizza i valori |
*Supportato solo nell'app da campo e app Web Survey123.
Per ulteriori informazioni sui tipi di campi, consultare Tipi di dati dei campi ArcGIS.
Per alcune domande, è possibile modificare il tipo di dati che Survey123 assegna per impostazione predefinita. Nella tabella seguente sono riportati alcuni esempi:
| Tipo di domanda | Tipo di campo predefinito | Commenti |
|---|---|---|
select_one | esriFieldTypeString | Per garantire che la scelta sia memorizzata come intero, passare a esriFieldTypeInteger. |
date | esriFieldTypeDate | esriFieldTypeDate include sempre un elemento ora. Per memorizzare solo una data, passare a esriFieldTypeDateOnly. |
dateTime | esriFieldTypeDate | esriFieldTypeDate non fornisce indicazione di fuso orario. Per includere il fuso orario nel campo, passare a esriFieldTypeTimestampOffset. Quando esriFieldTypeTimestampOffset è impostato, un selettore di fuso orario viene visualizzato nel modulo per la domanda dateTime. Il fuso orario corrente del dispositivo sarà applicato per impostazione predefinita. |
time | esriFieldTypeString | Per memorizzare l'ora come valore temporale, passare a esriFieldTypeTimeOnly. |
Si noti che bind::esri:fieldType controlla soltanto il tipo di campo creato nel feature layer. Per controllare il tipo di campo per una domanda durante un rilevamento, usare la colonna bind::type. Ad esempio, immettendo il valore int nella colonna bind::type per una domanda calculate, il campo viene trattato come intero anziché come tipo di campo predefinito, stringa. I valori ammessi nella colonna bind::type sono i seguenti:
- int
- decimale
- stringa
- data
- datetime
- tempo
La colonna bind::esri:fieldType accetta anche il valore null, che determina l'esclusione della domanda dal feature layer creato. Mentre la domanda è ancora presente nel rilevamento e si comporta normalmente, la risposta non viene inviata al feature layer e non è presente quando si rivedono le risposte. È l'ideale per calcoli, vincoli o altre domande che devono essere presenti per finalità legate alla presentazione, ma che non servono nei risultati.
I seguenti tipi di domanda non supportano campi nulli:
- select_one or other
- select_multiple or other
- hidden
- begin group
- begin repeat
Nota:
Le domande geopoint, geotrace e geoshape supportano il tipo di campo null solo se il rilevamento include almeno un'altra domanda geopoint, geotrace o geoshape che non presenta un tipo di campo null o se il geopoint, geotrace o geoshape si trova in una ripetizione.
Lunghezza campo
Usare la colonna personalizzata bind::esri:fieldLength per controllare i campi di lunghezza della stringa (testo) da creare in ArcGIS per le domande del rilevamento.
Nota:
Non è possibile controllare le domande intere e decimali in questo modo. I database non specificano la lunghezza di un campo numerico; l'intervallo di valori validi è regolato dal tipo di campo numerico. Ad esempio, un campo di valori interi memorizza qualsiasi valore intero compreso tra -2.147.483.648 e 2.147.483.647.
Alias di campo
Per impostazione predefinita, un alias di campo di un rilevamento eredita lo stesso valore dell'etichetta del campo, a cui si far riferimento principalmente quando il rilevamento viene aperto in ArcGIS. È possibile modificare questa impostazione fornendo un valore nella colonna bind::esri:fieldAlias, che diventa poi il nuovo alias di campo.
Poiché le domande nascoste e calcolate non vengono visualizzate in un modulo, i contenuti del campo dell'etichetta non vengono conservati. Ciò significa che quando vengono visualizzati i record del rilevamento nel sito Web Survey123 o in ArcGIS, viene visualizzato il nome della domanda nell'intestazione di colonna per questi tipi di domande. Per forzare la visualizzazione di un’etichetta nell'intestazione di colonna delle domande nascoste e di calcolo, utilizzare la colonna bind::esri:fieldAlias nel foglio di calcolo per specificare un'etichetta.
Maschera di input
Nota:
Questa sezione descrive le funzionalità disponibili solo in Survey123 Connect e nell'app da campo Survey123. Queste funzionalità non sono disponibili in Survey123 Studio o Survey123 Mobile.
Le maschere di input forniscono un formato impostato per le domande di testo tramite l'utilizzo di caratteri e simboli. Quando si applica una maschera di input a una domanda, tutte le risposte devono seguire un modello specifico definito dalla maschera di input. Nell'app di campo Survey123 e nell'app Web, le risposte al rilevamento non possono essere inviate fino a quando tutte le maschere di input non sono soddisfatte.
Suggerimento:
Le maschere di input possono essere applicate solo al tipo di domanda text. Per i tipi integer o decimal, utilizzare la colonna constraint per limitare le risposte. Per ulteriori informazioni, vedere Vincoli
Per applicare una maschera di input a una domanda, definire la maschera nella colonna body::esri:inputMask. La tabella seguente elenca i caratteri e i simboli che è possibile usare nella maschera di input:
| Carattere | Significato |
|---|---|
| A | Carattere alfabetico ASCII richiesto. I caratteri ammessi sono da A a Z e da a a z. |
| a | Carattere alfabetico ASCII consentito ma non richiesto. |
| N | Carattere alfanumerico ASCII richiesto. I caratteri ammessi sono da A a Z, da a a z e da 0 a 9. |
n | Carattere alfanumerico ASCII consentito ma non richiesto. |
X | Qualsiasi carattere non vuoto richiesto. |
x | Qualsiasi carattere non vuoto consentito ma non richiesto. |
| 9 | Cifra ASCII richiesta. Le cifre ammesse sono da 0 a 9. |
0 | Numero ASCII consentito ma non richiesto. Le cifre ammesse sono da 0 a 9. |
| D | Cifra ASCII richiesta. Le cifre ammesse sono da 1 a 9. |
d | Numero ASCII consentito ma non richiesto. Le cifre ammesse sono da 1 a 9. |
# | Numero ASCII o segno più/meno consentito ma non richiesto. |
| H | Carattere esadecimale richiesto. I caratteri ammessi sono da A a F, da a a f e da 0 a 9. |
h | Carattere esadecimale consentito ma non richiesto. |
| B | Carattere binario richiesto. I caratteri ammessi sono da 0 a 1. |
b | Carattere binario consentito ma non richiesto. |
| > | Tutti i seguenti caratteri alfabetici sono in maiuscolo. |
| < | Tutti i seguenti caratteri alfabetici sono in minuscolo. |
| ! | Disattivazione della conversione tra caratteri maiuscoli e minuscoli. |
| \ | Eseguire l'escape dei caratteri speciali elencati sopra per utilizzarli come separatori. |
La maschera consiste in una stringa di caratteri e separatori seguita, in via opzionale, da un punto e virgola per terminare la maschera di input e dal carattere utilizzato per gli spazi vuoti. I caratteri vuoti vengono rimossi dal testo dopo la modifica. La tabella che segue riporta esempi di maschere.
| Esempio di maschera | Descrizione |
|---|---|
| >A<xxxxxxxxxxxx | Testo che inizia con una lettera maiuscola seguita da qualsiasi carattere minuscolo. |
| AAA-AAA-AAA;_ | Identificativo univoco che utilizza trattini alti come separatori, con un punto e virgola alla fine della maschera di input seguito da un trattino basso per rappresentare ciascun carattere da completare. |
| B9.99;- | Rappresenta un valore di pH. Il numero può iniziare solo con 0 o 1 e può contenere solo due cifre decimali. Un punto e virgola termina la maschera di input, seguito da un trattino per rappresentare ciascun carattere da completare. |
| 999-99-9999 | Numero di previdenza sociale degli Stati Uniti. |
| (999) 999-9999 | Numero di telefono degli Stati Uniti. |
| 900 kg | Peso in chilogrammi compreso tra 0 e 999. |
| 99999 | CAP a 5 cifre degli Stati Uniti. |
| AAA | Codice di aeroporto di IATA. |
Flusso di lavoro
Nota:
Questa sezione descrive le funzionalità disponibili solo in Survey123 Connect e nell'app da campo Survey123. Queste funzionalità non sono disponibili in Survey123 Studio o Survey123 Mobile.
Utilizzare la colonna personalizzata bind::esri:workflow per indicare che il campo può essere compilato dal tile Telemetro avviato dalla galleria. Questa colonna è supportata solo dalle domande di testo e i seguenti valori vengono accettatti dalla colonna bind::esri:workflow:
- rangefinderMode=height
- rangefinderMode=offset
- rangefinderMode=height,offset
- rangefinderHeight
Ogni valore rangefinderModeconsente un'esperienza utente simile per l'operatore sul campo. Quando il flusso di lavoro desiderato per il telemetro è selezionato, all'utente viene chiesto di selezionare un rilevamento ed effettuare da 1 a 3 scatti con lo strumento; dopodiché, il rilevamento viene avviato automaticamente per l'operatore sul campo in modo da completare eventuali ulteriori domande.
Il valore di rangefinderHeight è univoco, in quanto consente all'operatore sul campo di consultare ogni domanda del rilevamento configurata per ricevere un valore di altezza, usando le frecce avanti e indietro. Quando tutte le altezze sono state misurate, l'operatore preme Fatto e procede al rilevamento per completare eventuali ulteriori domande.