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 e la lunghezza di un campo da creare in ArcGIS per le domande del rilevamento. Per ulteriori informazioni sui tipi di campo supportati, 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. |
Per controllare il tipo di campo, fornire uno dei seguenti valori nella colonna bind::esri:fieldType:
- esriFieldTypeString
- esriFieldTypeDate
- esriFieldTypeDateOnly
- esriFieldTypeTimeOnly
- esriFieldTypeTimestampOffset
- esriFieldTypeInteger
- esriFieldTypeBigInteger
- esriFieldTypeSingle
- esriFieldTypeDouble
- esriFieldTypeSmallInteger
- esriFieldTypePointZ
- esriFieldTypeGUID
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
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
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
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.