Puoi includere nei sondaggi domande di tipo text, integer e decimal che consentono agli utenti di immettere risposte di testo e numeriche.
Le domande di tipo text consentono di inserire risposte di testo libero nel sondaggio. Per impostazione predefinita, il modulo visualizza una casella di testo con un campo di input a riga singola. Se il testo supera le dimensioni della casella di testo, la casella non viene ridimensionata, ma scorre orizzontalmente senza interruzioni di linea. È ideale per le risposte brevi. Per fare in modo che il testo immesso rispetti un formato specifico, puoi applicare una maschera di input. Puoi anche applicare un'espressione regolare per fare in modo che il campo di testo rifiuti automaticamente le risposte che non rispettano un formato specifico, ad esempio un indirizzo e-mail o l'URL di un sito Web.
I tipi di domanda integer e decimal consentono agli utenti di immettere solo valori numerici validi. Nella colonna constraint per questi tipi di domanda, puoi specificare i valori minimo e massimo per impedire agli utenti di inviare il sondaggio se la risposta non rientra nell'intervallo specificato.
Puoi modificare il comportamento di questi tipi di domanda e il modo in cui vengono visualizzati impostando l'aspetto. Per verificare quali app di invio supportano un determinato aspetto, vedi Aspetto.
Aspetto text
Nota:
In Survey123 Mobile, per le domande di tipo text è supportato solo l'aspetto multiline.
Nell'app Web Survey123, gli aspetti predictivetext e nopredictivetext non sono supportati.
Impostando la colonna appearance su multiline, una domanda di tipo text viene visualizzata come una casella di testo a più righe. Questa casella di testo più ampia è ideale per le risposte lunghe. Il testo va automaticamente a capo durante la digitazione e sono consentiti gli a capo.
Nota:
Per i moduli utilizzati nell'app di campo Survey123, puoi impostare l'altezza predefinita della casella di testo multilinea specificando un parametro defaultHeight nella colonna body::esri:style. Ad esempio, immettendo defaultHeight=5 nella colonna body::esri:style verrà visualizzata una casella di testo multilinea di cinque righe all'apertura del sondaggio. Se non è impostato, una casella di testo a più righe visualizzerà tre righe all'apertura del rilevamento.
Impostando l'aspetto su predictivetext o nopredictivetext, la domanda testo impone che il testo predittivo sia abilitato o disabilitato, rispettivamente, sui dispositivi mobili. Per impostazione predefinita, in Android il testo predittivo è disabilitato per le domande di tipo text, il che può disattivare la funzione di dettatura vocale su alcune tastiere. Applica l'aspetto del testo predittivo a una domanda di testo per abilitare la sintesi vocale per tale domanda. Il testo predittivo è abilitato per impostazione predefinita in iOS.
Impostando l'aspetto su geocode, una domanda di tipo text viene utilizzata per cercare e inviare un indirizzo geocodificato.
Sono disponibili anche aspetti per ottenere un ID tag InfraMarker e ottenere un valore da un telemetro.
Cercare e inviare un indirizzo geocodificato
Nota:
Questa sezione descrive le funzionalità disponibili solo e nell'app da campo Survey123. Queste funzionalità non sono disponibili in Survey123 Mobile.
Impostando la colonna appearance su geocode, una domanda di tipo text viene utilizzata per cercare e inviare un indirizzo geocodificato. Quando gli utenti iniziano a digitare un indirizzo, viene visualizzata una serie di opzioni di autocomplete che suggeriscono località in base ai locator predefiniti disponibili per l'organizzazione. Se l'utente non ha effettuato l'accesso, verrà utilizzato ArcGIS World Geocoder. L'aspetto geocode necessita di una connessione a internet e non funziona in un ambiente offline.
L'indirizzo selezionato verrà infine inviato al feature layer come stringa; tuttavia, prima dell'invio i dati geocodificati completi vengono temporaneamente archiviati come oggetto JSON, consentendo di estrarre singole proprietà in altri campi.
Per estrarre delle proprietà individuali dall'oggetto JSON, usa la funzione pulldata("@json") nella colonna calculation di un'altra domanda.
pulldata("@json", ${address}, "location.x")
pulldata("@json", ${address}, "searchCandidate")
L'intero oggetto JSON può essere restituito in un singolo campo di testo senza definire una proprietà singola.
pulldata("@json", ${address})
Per ulteriori informazioni sulla funzione pulldata("@json"), consultare Recuperare un valore da JSON.
Nota:
La geocodifica che utilizza ArcGIS World Geocoding Service consumerà crediti. Per ulteriori informazioni, vedere Capire i crediti.Per impostare un localizzatore specifico che restituisca i risultati, fornire l'ID elemento del localizzatore nella colonna bind::esri:parameters, ad esempio geocode=36ff9e8c13e042a58cfce4ad87f55d19. Il localizzatore utilizzato nel rilevamento ArcGIS Online deve essere un elemento in ArcGIS Online. Il localizzatore utilizzato nel rilevamento ArcGIS Enterprise deve essere un elemento nello stesso portale del rilevamento.
Le proprietà disponibili variano in base al localizzatore utilizzato. Fa eccezione la proprietà searchText, che è disponibile indipendentemente dal locator utilizzato e restituisce la stringa esatta usata per cercare l'indirizzo oppure l'opzione selezionata da un elenco di risultati.
È possibile controllare ulteriormente la presentazione di una domanda di aspetto geocode impostando uno dei seguenti parametri nella colonna body::esri:style:
Nota:
I parametri indicator, proximity, maxResults e suggestions non sono supportati nell'app Web Survey123.
- indicator: Permette ai risultati di geocodifica di mostrare la direzione e la distanza dalla posizione attuale del dispositivo. Questo parametro può essere impostato su distance, direction, entrambi i valori separati da una virgola oppure none. Per impostazione predefinita, questo parametro è impostato per mostrare solo la distanza.
- proximity: Controlla se i risultati di geocodifica mostrano solo i risultati entro un certo raggio dalla posizione del dispositivo. Questo parametro accetta un numero seguito da una delle unità standard seguenti: m (metri), km (chilometri), ft (piedi), mi (miglia) o yd (iarde). Se non è fornita alcuna unità imposta i metri come predefinito. Se impostato a 0, non verrà contabilizzata la prossimità nei risultati di ricerca. Per impostazione predefinita, questo parametro è impostato a on, permettendo ai suggerimenti di essere ordinati in base alla prossimità senza escludere alcuna posizione in base alla distanza.
- maxResults- Controlla il numero massimo di risultati restituiti; ad esempio, maxResults=10 restituisce un massimo di 10 possibili risultati. Per impostazione predefinita, questo parametro è impostato per mostrare un massimo di 6 risultati.
- suggestions - Funge da interfaccia per l'operazione suggest in ArcGIS REST API. Quando questo parametro è impostato su yes, l'elenco a discesa delle posizioni potenziali viene compilato dall'operazione suggest. Quando questo parametro è impostato su no oppure se il servizio di geocodifica non supporta l'operazione suggest, l'elenco di potenziali posizioni viene compilato dall'operazione findAddressCandidates. Per impostazione predefinita, questo parametro è impostato su yes.
Ottieni un ID tag InfraMarker
Nota:
Questa sezione descrive le funzionalità disponibili solo e nell'app da campo Survey123. Queste funzionalità non sono disponibili in Survey123 Mobile.
Utilizza gli aspetti descritti di seguito per leggere dati da un tag RFID InfraMarker.
Impostando la colonna appearance di una domanda di tipo text su inframarker, puoi definire le informazioni da scrivere in un tag. Queste informazioni possono includere assetOwner, assetName, latitude e longitude e i relativi valori possono essere ricavati da altre domande del sondaggio. Ad esempio, la seguente espressione nella colonna calculation scrive le risposte dalle domande asset_name, asset_owner, lat e long nel tag:
concat("assetName=", ${asset_name}, "&assetOwner=", ${asset_owner}, "&latitude=", ${lat}, "&longitude=", ${long})
Impostando l'aspetto di un'altra domanda di testo nello stesso rilevamento su getinframarkerid, l'ID univoco del tag di 24 caratteri InfraMarker viene recuperato e memorizzato nel rilevamento.
Per maggiori informazioni, consultare la documentazione di InfraMarker.
Ottieni un valore da un telemetro
Nota:
Questa sezione descrive le funzionalità disponibili solo e nell'app da campo Survey123. Queste funzionalità non sono disponibili in Survey123 Mobile.
Impostando la colonna appearance su rangefinder, una domanda di tipo text può accettare l'intero oggetto JSON oppure un valore specifico restituito da un telemetro. Quando viene utilizzata per acquisire l'intero oggetto JSON, questa domanda deve avere bind::esri:fieldLength impostato su 1000 per garantire che l'intero valore possa essere contenuto.
Quando imposti l'aspetto rangefinder per una domanda di tipo integer o decimal, questa può acquisire un valore specifico restituito da un telemetro. Specifica la misurazione da memorizzare utilizzando uno dei seguenti valori nella colonna bind::esri:parameters: height, azimuth, horizontalDistance, slopeDistance oppure inclination. Ad esempio, measurement=height memorizzerà solo il valore di altezza restituito dal telemetro.
Aspetto integer
Nota:
In Survey123 Mobile, per le domande di tipo integer è supportato solo l'aspetto spinner.
Nell'app Web Survey123, nessuno di questi aspetti integer è supportato.
Impostando la colonna appearance su spinner, una domanda di tipo integer viene visualizzata con pulsanti che consentono di aumentare o diminuire il valore di un'unità. La progressione continua fino a quando si preme il pulsante.
Impostando appearance su numbers, una domanda di tipo integer evidenziata è accompagnata da una tastiera numerica personalizzata per immettere un valore. Il tastierino include anche un pulsante per rendere il valore positivo o negativo.
Impostando appearance su calculator, una domanda di tipo integer evidenziata è accompagnata da una tastiera calcolatrice personalizzata per immettere e modificare un valore.
Impostando appearance su distress, una domanda di tipo integer viene visualizzata come una scala di dissesto. a 10 punti utilizzata per misurare sensazioni quali stress, dolore e felicità.
Aspetto decimal
Nota:
In Survey123 Mobile, per le domande di tipo decimal è supportato solo l'aspetto spinner.
Nell'app Web Survey123, nessuno di questi aspetti decimal è supportato.
Impostando la colonna appearance su spinner, una domanda di tipo decimal viene visualizzata con pulsanti che consentono di aumentare o diminuire di un'unità l'ultima cifra del valore. La progressione continua fino a quando si preme il pulsante.
Quando utilizzi un valore predefinito per definire il numero di cifre decimali di una domanda, lo spinner lo rispetta. Seguono alcuni esempi di come il selettore numerico gestisce diversi valori decimali:
- 1,0 aumenta a 1,1, 1,2, 1,3, 1,4
- 3,07 aumenta a 3,08, 3,09, 3,10, 3,11
- 2,000000 aumenta a 2,000001, 2,000002, 2,000003
Impostando appearance su numbers, una domanda di tipo decimal è accompagnata da una tastiera numerica personalizzata per immettere un valore. Il tastierino include anche un pulsante per rendere il valore positivo o negativo.
Impostando appearance su calculator, una domanda di tipo decimal evidenziata è accompagnata da una tastiera calcolatrice personalizzata per immettere e modificare un valore.
Impostando appearance su thousands-sep, la risposta a una domanda di tipo decimal viene visualizzata con i separatori delle migliaia. Ciò non influisce sul valore inviato come parte della risposta al rilevamento, ma solo sulla visualizzazione nell'applicazione. I separatori sono impostati in base alle impostazioni locali del dispositivo e vengono applicati solo quando si apre un sondaggio dalle cartelle Drafts, Outbox, Inbox o Sent oppure quando la risposta viene popolata da un valore predefinito o da un calcolo. I separatori di migliaia non compaiono quando si inserisce manualmente un valore.
