È possibile pre-popolare le risposte in Survey123 in diversi modi.
Risposte predefinite
Quando si progetta un rilevamento, è possibile impostare le risposte predefinite per le domande del rilevamento nella colonna Default del foglio di calcolo. Ciò permette di precompilare la domanda con la stessa risposta ogni volta che si inizia un rilevamento o quando una domanda diventa pertinente. Questa funzione è utile soprattutto quando, nella maggior parte dei casi, la risposta alla domanda del rilevamento sarà la stessa. Se necessario, è comunque possibile modificare la risposta predefinita, ma impostare una risposta predefinita permette di risparmiare tempo durante la compilazione dei rilevamenti. Le risposte predefinite possono contenere delle costanti come stringhe e numeri.
Le risposte alle domande select_multiple funzionano in modo diverso rispetto alle altre, con le singole risposte selezionate immesse nell'ordine di selezione e separate da virgole. Per definire più valori come predefiniti in un campo select_multiple, separarli con la virgola, ad esempio, elemento1,elemento2,elemento3.
Le domande geopoint, geotrace e geoshape supportano le risposte predefinite. Per ulteriori informazioni sull'impostazione predefinita, consultare Geopoint e Geotrace e geoshape.
Calcoli
I calcoli sono simili ai valori predefiniti, ma vi sono comunque delle differenze. Diversamente dalla colonna Default, che viene valutata solo all’apertura del rilevamento o quando la domanda diventa pertinente, i calcoli vengono valutati ogni volta che le risposte nel rilevamento che sono input del calcolo cambiano o diventano pertinenti. I calcoli possono utilizzare risposte presenti nel modulo. Ad esempio, l'espressione 100 - (${integer1} + ${integer2}) immessa nella colonna dei calcoli di una domanda somma i valori delle domande integer1 e integer2, sottrae il valore da 100 e imposta il valore come risposta. L'utente può sovrascrivere il valore, ma il calcolo può rappresentare una risposta iniziale per guidare l'utente.
Suggerimento:
Se il risultato di un calcolo viene modificato manualmente, è possibile utilizzare un pulsante che appare per cancellare il valore modificato ed eseguire nuovamente il calcolo.
Modalità di calcolo
Il parametro calculationMode, inserito nella colonna bind::esri:parameters, controlla quando i calcoli nelle domande vengono ricalcolati, ad esempio calculationMode=manual. Esistono quattro valori supportati:
- auto: calcola quando la domanda è vuota o non è stata precedentemente modificata dall'utente. Se non viene fornito alcun valore, questo è il comportamento predefinito di calcolo.
- manual: la domanda calcolerà solamente quando viene premuto il pulsante Calcola a fianco della domanda.
- always: calcola quando un qualsiasi valore con riferimento nell'espressione di calcolo cambia. Ciò include le funzioni dinamiche come now().
- whenEmpty: esegue il calcolo fino alla restituzione di un valore non vuoto. Quando viene restituito un valore non vuoto, la domanda si comporta allo stesso modo della modalità manual. I calcoli che contengono funzioni dinamiche, come now(), non effettueranno il ricalcolo, a meno che non venga premuto il pulsante Calcola. La modalità whenEmpty è utile quando non si desidera aggiornare una domanda che è già stata calcolata con un valore non vuoto quando il modulo viene ricaricato, ad esempio, quando viene aperto dalla Posta in entrata.
I seguenti tipi di domande supportano il parametro calculationMode:
- testo
- decimale
- intero
- nota
- data
- tempo
- datetime
- select_one
- select_multiple
- geopoint
- calcola
- nascosto
Nota:
Il parametro calculationMode non è supportato nell'app web Survey123.
Proprietà dispositivo e utente
La funzione pulldata("@property") consente di estrarre le informazioni sui dispositivi dai quali vengono inviate le risposte ai rilevamenti e sugli utenti registrati che inviano tali risposte. Questa funzione è utile per registrare i dettagli tecnici e le informazioni sul contesto nel quale è stato acquisito il rilevamento.
La funzione restituisce una proprietà di dispositivo o di utente nel formato pulldata("@property", '<property name>'). Il seguente esempio restituisce l'offset UTC del dispositivo, consentendo agli utenti di registrare il fuso orario in cui si è effettuato il rilevamento:
pulldata("@property", 'utcOffset')
La funzione pulldata("@property") può essere utilizzata per rilevare il modo in cui l'utente sta attualmente interagendo con la risposta al rilevamento utilizzando le seguenti modalità:
pulldata("@property", 'mode')
La proprietà mode dispone di tre possibili valori, che restituiscono new se l'utente sta producendo una nuova risposta al rilevamento (inclusa una copiata da un rilevamento esistente), edit se l'utente sta modificando una risposta esistente, e view se l'utente sta visualizzando una risposta esistente in modalità di sola lettura. L'esempio seguente, se inserito nella colonna readonly, rileva se l'utente sta modificando una risposta esistente e gli impedisce di modificare la domanda scelta:
pulldata("@property", 'mode') = 'edit'
La funzione pulldata("@property") può essere utilizzata anche per determinare dove è stato aperto un rilevamento. L'esempio seguente determina se il rilevamento è stato aperto dalla casella di posta in arrivo:
pulldata("@property", 'status') = 'inbox'
Attenzione:
Si raccomanda di non memorizzare i risultati delle proprietà mode o status in un campo nascosto o di calcolo e di non abilitare o disabilitare le domande utilizzando queste proprietà nella colonna relevant. In caso contrario, si potrebbe causare la cancellazione del contenuto di questi campi o il mancato aggiornamento dei valori previsto.
La funzione pulldata("@property") supporta le seguenti proprietà:
| Proprietà | Descrizione |
|---|---|
| pulldata("@property", 'portalUrl') | L'URL del portale al quale il rilevamento viene inviato. |
| pulldata("@property", 'token') | Il token trasferito al feature layer. |
| pulldata("@property", 'portalInfo') | Tutte le informazioni riguardanti il portale, sotto forma di oggetto JSON. |
pulldata("@property", 'submissionUrl') | L'URL del layer feature service (o layer padre del modulo quando presenta ripetizioni) a cui viene inviato il rilevamento. |
| pulldata("@property", 'online') | Un valore booleano. Il valore è true se il dispositivo ha attività di rete, altrimenti è false. |
| pulldata("@property", 'utcOffset') | Offset in ore dall'UTC per il fuso orario locale. |
| pulldata("@property", 'language') | Lingua utilizzata nel rilevamento corrente. |
pulldata("@property", 'locale')¹ | L'Oggetto Locale usato nel rilevamento corrente. |
pulldata("@property", 'localeInfo')¹ | L'oggetto AppStudio LocaleInfo usato nel rilevamento corrente contenente il codice linguistico in varie notazioni. |
| pulldata("@property", 'timeZone') | Codice del fuso orario. |
pulldata("@property", 'username') | Nome utente dell'account aziendale ArcGIS dell'utente che ha attualmente effettuato l'accesso. |
pulldata("@property", 'email') | Indirizzo email dell'account aziendale ArcGIS dell'utente che ha attualmente effettuato l'accesso. |
pulldata("@property", 'userFullName') | Nome e cognome dell'utente attualmente connesso. |
pulldata("@property", 'userFirstName')² | Nome dell'utente attualmente registrato. |
pulldata("@property", 'userLastName')² | Cognome dell'utente attualmente registrato. |
pulldata("@property", 'deviceId')³ | ID unico generato da Survey123 che rappresenta il dispositivo specifico sul quale il sondaggio viene preso. È distinto dal dispositivo mobile International Mobile Equipment Identity (IMEI), poiché Survey123 funziona su dispositivi che potrebbero non avere un IMEI. |
pulldata("@property", 'deviceModel')³ | Nome del modello del dispositivo dell'utente. |
pulldata("@property", 'OS')³ | Nome del sistema operativo del dispositivo dell'utente. |
pulldata("@property", 'appVersion') | Numero di versione della field app o numero di build della web app. |
pulldata("@property", 'surveyName') | Nome dell'indagine. |
pulldata("@property", 'userAgent') | Stringa dell'agente utente per il dispositivo dell'utente. |
pulldata("@property", 'mode') | Restituisce new se l'utente sta creando una risposta al rilevamento, edit se l'utente sta modificando una risposta esistente o view se l'utente sta visualizzando una risposta in modalità di sola lettura. |
pulldata("@property", 'status') | Restituisce draft, submitted, sent o inbox se il rilevamento è stato aperto da Bozze, Posta in uscita, Inviato o Posta in arrivo, rispettivamente. Una stringa vuota viene restituita se la risposta è nuova. |
¹Per l'uso solo con la funzione pulldata("@javascript").
²Questi parametri dipendono da ciò che è presente nella configurazione dell'identity provider e potrebbero non essere disponibili nelle organizzazioni che utilizzano un'autenticazione diversa da quella integrata.
³Solo l'app di campo Survey123.
Risposte preferite
Dopo aver inserito le risposte nell'app da campo Survey123 e averle inviate o aver salvato il rilevamento come bozza, è possibile utilizzarle nei rilevamenti successivi impostandole come preferite. Utilizzando il menu nell’angolo in alto a destra, è possibile impostare lo stato corrente del rilevamento in modo che agisca come risposta preferita.
Una volta impostate le risposte preferite, queste possono essere inserite nei nuovi rilevamenti aprendo il menu e facendo clic su Copia risposte dai preferite.
Se è necessario modificare le risposte preferite, immetterle nel rilevamento corrente e fare clic su Imposta come risposte preferite. Se in un campo vengono immesse informazioni ripetitive, è possibile utilizzare le risposte correnti per precompilare i rilevamenti successivi. Il rilevamento utilizzato per impostare le risposte preferite sarà contrassegnato da una stella.
Nota:
Se la cartella Inviati è stata disabilitata, non puoi usare un'indagine inviata per le risposte preferite. In questo caso, occorre salvare il rilevamento con le risposte preferite come bozza in modo che l'opzione Incolla risposte dai preferiti funzioni.
Dati CSV
La compilazione delle risposte con informazioni salvate sul proprio dispositivo può ridurre al minimo il tempo necessario per completare il rilevamento. Le informazioni possono essere dati acquisiti da un precedente rilevamento oppure possono fornire più risposte basate sull'immissione di un utente di una singola risposta.
La precompilazione delle risposte è utile nei rilevamenti di ispezione delle risorse. Immettendo il numero ID di una risorsa (digitandolo o effettuando la scansione del codice a barre), è possibile recuperare i dettagli dal file .csv e utilizzarli per rispondere ad altre domande come posizione, data dell'ispezione e condizioni al momento dell'ultima ispezione.
Per ulteriori dettagli su come compilare le risposta utilizzando questo metodo, consultare Recuperare un valore da CSV.
Nota:
Se il file .csv non ha una intestazione di colonna o ha una virgola alla fine delle righe del file, non sarà possibile importare il file .csv nel rilevamento.