XLSForm supporta domande select_one (selezionare una sola risposta), select_multiple (selezionare varie risposte) e rank (ordinare un elenco di scelte). Per scrivere una domanda a scelta multipla occorre aggiungere un foglio di lavoro scelte nella cartella di lavoro di Excel. Di seguito è riportato un esempio di domanda select_one:
Ricordare che yes_no nel foglio di lavoro Rilevamento deve corrispondere a yes_no nella colonna Elenco nomi nel foglio di lavoro delle scelte. Ciò garantisce che il modulo visualizzi l'elenco corretto di risposte possibili per una domanda specifica.
Per impostazione predefinita, quando un rilevamento viene pubblicato, le scelte nelle domande select_one vengono aggiunte al feature layer del rilevamento come domini valore codificato. È possibile disabilitare la creazione di domini utilizzando il processo di pubblicazione. Per ulteriori informazioni, vedere Opzioni di pubblicazione.
Quando si modificano le scelte per domande select_one e si ripubblica il rilevamento, Survey123 Connect visualizza un riepilogo delle modifiche e consente di decidere se tali modifiche devono essere applicate ai domini nel feature layer. Per ulteriori informazioni, consultare Aggiornare un rilevamento.
Attenzione:
Di seguito sono riportate le limitazioni quando si utilizza un elenco di scelte con nomi di scelta duplicati:
- I nomi di scelta duplicati non sono supportati nelle domande select_multiple.
- I nomi di scelta duplicati non sono supportati nei rilevamenti multilingue.
- La funzione jr:choice-name() restituisce l'etichetta della prima scelta duplicata nell'elenco.
- Quando vengono aperte dalle cartelle Posta in entrata, Bozze, Posta in uscita, Inviata o Panoramica, le domande select_one ritornano alla prima scelta duplicata nell'elenco.
È anche possibile aggiungere domande a scelta multipla che consentono di selezionare più risposte, come nel seguente esempio:
Per impostazione predefinita, queste scelte appaiono nell'ordine fornito nel foglio di lavoro delle scelte. È invece possibile randomizzare l'ordine in cui appaiono queste scelte immettendo randomize=true nella colonna dei parametri.
Attenzione:
Tutti i valori acquisiti per una domanda select_multiple o rank vengono salvati in un elenco di valori separati da virgole. Per questo, evitare di usare virgole nella colonna dei nomi dell'elenco delle opzioni. Le domande select_multiple e rank inviano solo il nome di un'opzione al feature layer, piuttosto che il nome e l'etichetta inviati da domande select_one.
Il valore per una domanda rank rimane vuoto fino a che l'ordine di scelta è modificato dall'utente. Il valore predefinito è stato impostato, l'ordine predefinito è applicato a meno che l'ordine di scelta sia modificato dall'utente.
Una risposta individuale per una domanda select_multiple può essere restituita usando la funzione selected-at. Quanto segue restituisce il valore del nome per la prima risposta data per una domanda select_multiple:
selected-at(${species}, 0)
Per inviare l'etichetta per una risposta, è possibile utilizzare la funzione jr:choice-name. Per ottenere il valore dell'etichetta per la seconda risposta data alla stessa domanda select_multiple, utilizzare quanto segue:
jr:choice-name(selected-at(${species}, 1), '${species}')
Specify other
Per le domande a scelta multipla, i rilevamenti possono contenere l'opzione "Altro" quando la risposta desiderata non compare nell'elenco. In seguito all'intervistato viene chiesto di specificare l'altra opzione. È possibile fare ciò in XLSForm usando il metodo manuale o il metodo integrato. Il metodo integrato è più rapido e semplice da configurare rispetto al metodo manuale, ma implica varie limitazioni.
Metodo manuale
Il metodo manuale è raccomandato, in quanto permette di specificare il nome e l'etichetta della scelta "Altro" e il nome e etichetta della domanda di testo che raccoglie la relativa risposta. È possibile fornire traduzioni per questi nomi ed etichette. È anche possibile applicare vincoli e aspetti alla domanda di testo e renderla obbligatoria.
Per prima cosa, aggiungere una scelta other all'elenco di scelte della domanda nel foglio di lavoro delle scelte. Specificare un nome e un'etichetta per questa scelta allo stesso modo di una qualsiasi altra scelta dell'elenco. Nel seguente esempio, l'elenco di scelte color ha una scelta denominata other.
Nel foglio di lavoro delle scelte, aggiungere una domanda di testo per raccogliere la risposta "Altro". Aggiungere un'espressione appropriata in modo che la domanda di testo sia rilevante solo quando viene selezionata la scelta "Altro". Nel seguente esempio, la domanda other_color è rilevante quando la risposta alla domanda select_one è other.
Per rilevamenti multilingue, le domande e le scelte possono essere tradotte. Nel seguente esempio, vengono fornite le traduzioni in francese e greco sul foglio di lavoro del rilevamento sia per la domanda select_one che per la domanda di testo.
Le traduzioni vengono anche fornite nel foglio di lavoro delle scelte, anche per la scelta other.
Metodo integrato
Con questo metodo Survey123 Connect crea automaticamente l'altra scelta e la domanda per raccogliere l'altra risposta. Per utilizzare questo metodo, digitare or_other dopo il nome dell'elenco di scelte nella colonna tipo nel foglio di lavoro del rilevamento. Viene visualizzata una scelta Altro nell'elenco delle scelte per la domanda. Quando è selezionata la scelta Altro, viene visualizzata una domanda Specifica altro che consente agli utenti di fornire le loro risposte. Per memorizzare questa risposta, Survey123 Connect crea automaticamente un campo aggiuntivo nel feature layer usando il nome della domanda a scelta multipla seguito da _other, per esempio favorite_toppings_other. Vedere l'esempio seguente:
Attenzione:
L'etichetta per la domanda Specifica altro non verrà visualizzata in lingue diverse dall'inglese.
Se si crea un'indagine da un livello di caratteristica esistente, il campo per la domanda Specifica altro non sarà creato automaticamente e l'indagine non sarà pubblicata. È necessario creare manualmente il campo per la domanda Specifica altro nel feature layer, con il nome della domanda a scelta multipla seguito da _other, ad esempio favorite_toppings_other.
Elenchi di scelta esterni
È possibile salvare gli elenchi di scelta per le domande select_one e select_multiple in un file .csv esterno. Questo è ideale per elenchi di scelte molto grandi, così come elenchi di scelta che sono gestiti fuori da Survey123. Elenchi di scelta esterni non sono da confondere con selezioni esterne, nei quali le scelte devono essere elencate in un foglio di lavoro aggiuntivo.
Il file .csv deve contenere le colonne nome e etichetta.
Nota:
Se il file .csv non ha una intestazione di colonna o ha una virgola alla fine delle righe del file, il file non verrà importato nel rilevamento.
Per migliori risultati, codificare il file .csv usando la codifica dei caratteri UTF-8. Se si sta utilizzando Microsoft Excel per creare il file .csv, salvarlo come CSV UTF-8..
Possono essere incluse colonne etichetta tradotte nel file .csv, ma le scelte tradotte verranno mostrate solo in Survey123 Connect e nell'app da campo Survey123, non nell'app Web Survey123.
Per includere una domanda con un elenco di scelta esterno, immettere il tipo di domanda, select_one_from_file o select_multiple_from_file, seguito dal nome del file .csv, ad esempio select_one_from_file CoverType.csv. I nomi dei file distinguono tra maiuscole e minuscole e non accettano spazi.
Esistono solo due modi per includere un file .csv: memorizzare manualmente il file nella cartella media del rilevamento o collegarsi a un file .csv ospitato in ArcGIS.
Suggerimento:
Eseguire lo strumento Converti elenchi di scelte in CSV per automatizzare la migrazione degli elenchi di scelte dal foglio di scelte in file .csv.
Collegare un file .csv
Per collegare un file .csv dal contenuto ArcGIS a un rilevamento, procedere nel modo di seguito indicato:
- Assicurarsi che il file .csv sia ospitato in ArcGIS Online o ArcGIS Enterprise e che abbia gli stessi permessi di condivisione del rilevamento.
- Assicurare che il sondaggio sia pubblicato su ArcGIS prima di provare a collegare il contenuto.
- In Survey123 Connect, aprire il rilevamento e fare clic sulla scheda Contenuto collegato. Fare clic sul pulsante Contenuto collegato, scegliere CSV e cercare e selezionare il file .csv da collegare.
Perché l'anteprima del modulo visualizzi le scelte dal file .csv collegato, in Survey123 Connect, nella scheda Contenuto collegato, fare clic sul pulsante di download 
. Questo posiziona una copia del file .csv nella cartella media del rilevamento. I file collegati sono automaticamente scaricati con il sondaggio nell'app campo Survey123.
Se si posiziona manualmente il file .csv nella cartella del sondaggio , e un momento successivo si carica un file .csv con lo stesso nome su ArcGIS e lo si collega al rilevamento, il file .csv nel rilevamento è aggiornato al contenuto collegato (se nuovo).
Converti elenchi di scelte in CSV
Eseguire lo strumento Converti elenchi di scelte in CSV in Survey123 Connect per migrare automaticamente gli elenchi di scelte specificati dal foglio delle scelte ai nuovi file .csv nella cartella degli elementi multimediali. Lo strumento modifica anche le domande corrispondenti nel foglio del rilevamento in modo da utilizzare i tipi di domanda select_one_from_file e select_multiple_from_file.
Per eseguire lo strumento, completare la procedura seguente:
- Configurare un ambiente Python in Survey123 Connect in modo da eseguire lo strumento. Per maggiori informazioni, vedere Configurare Python.
- Aprire XLSForm del rilevamento. Nel foglio scelte, aggiungere un colonna denominata esri_tool_convert_csv. Aggiungere un valore sì ad almeno una riga un per ogni elenco di scelte che si desidera convertire in elenchi di scelte esterne. Salvare e chiudere il file.
- In Survey123 Connect, aprire il rilevamento, fare clic su Strumentie scegliere Converti elenchi di scelte in CSV.
Quando la conversione è completata, un file .csvviene salvato nella cartella degli elementi multimediali per ogni elenco di scelte migrato Il nome file corrisponde al valore del nome dell'elenco di scelte originale (list_name column). Il foglio delle scelte viene aggiornato per includere solo gli elenchi rimanenti non migrati. Include ancora eventuali intestazioni personalizzate dell'originale. Nel foglio del rilevamento, le domande select_one e select_multiple applicabili vengono commutate in select_one_from_file e select_multiple_from_file per fare riferimento ai nuovi elenchi di scelte esterne. ll foglio delle scelte originale viene salvato in un foglio choices_backup in modo da poter verificare i risultati o annullare. È possibile mantenere o eliminare il foglio di backup.
Lo strumento non convertirà gli elenchi di scelte utilizzati nelle domande di classificazione, gruppi di elenchi di tabelle o domande con aspetto di ricerca. Nessuna delle domande che utilizzano questi elenchi di scelte viene modificata nel sondaggio.
Se lo strumento rileva domande non supportate, un file .xlsx viene creato nella cartella di debug con i nomi degli elenchi di scelte interessati. È possibile trovare questo file nella cartella seguente:
C:\Users\<username>\ArcGIS\My Survey Designs\<surveyName>\debug\convertchoicelists