È 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:
Nell'app da campo Survey123, 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
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.
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 passa alla modalità manual. La domanda rimane in modalità manual anche se il valore viene cancellato. 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
Proprietà del dispositivo, dell'utente e del sondaggio
La funzione pulldata("@property") consente di estrarre le informazioni riguardanti a:
- Il dispositivo dal quale sono state inviate le risposte.
- L'utente registrato che ha inviato le risposte.
- Il sondaggio per il quale sono state inviate le risposte.
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à:
Dispositivo
| Proprietà | Descrizione |
|---|---|
| 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", 'timeZone') | Codice del fuso orario. |
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", 'userAgent') | Stringa dell'agente utente per il dispositivo dell'utente. |
*Non supportato nell'app Web Survey123.
Utente
| Proprietà | Descrizione |
|---|---|
pulldata("@property", 'email') | Indirizzo email dell'account aziendale ArcGIS dell'utente che ha attualmente effettuato l'accesso. |
pulldata("@property", 'username') | Nome utente 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", 'portalUrl') | L'URL dell'organizzazione ArcGIS dell'utente ha attualmente effettuato l'accesso. |
| pulldata("@property", 'portalInfo') | Tutte le informazioni riguardanti il portale, sotto forma di oggetto JSON. |
| pulldata("@property", 'token') | Il token di accesso dell'utente che ha attualmente effettuato l'accesso. |
*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.
Rilevamento
| Proprietà | Descrizione |
|---|---|
pulldata("@property", 'submissionUrl')* | L'URL REST del feature layer (o layer padre del modulo quando contiene ripetizioni) a cui è stato inviato il sondaggio. Utilizzato per espressioni di ricerca o di estrazione dati che interrogano le risposte ai sondaggi esistenti. |
| pulldata("@property", 'language') | Lingua utilizzata nel rilevamento corrente. |
pulldata("@property", 'locale')* | Impostazioni locali utilizzate nel sondaggio corrente. Per l'uso solo con la funzione pulldata("@javascript"). |
pulldata("@property", 'localeInfo')* | Impostazioni locali utilizzate nel sondaggio corrente contenenti il codice linguistico in varie notazioni. Per l'uso solo con la funzione pulldata("@javascript"). |
pulldata("@property", 'surveyName') | Nome dell'indagine. |
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. |
*Non supportato in Survey123 Mobile.
Risposte preferite
Nota:
Questa sezione descrive le funzionalità disponibili solo e nell'app da campo Survey123. Queste funzionalità non sono disponibili in Survey123 Mobile.
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
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.
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.