Survey123 supporta domande di tipo select_one (seleziona una sola risposta), select_multiple (seleziona più risposte) e rank (ordina un elenco di scelte).
Nota:
Le domande di tipo rank sono attualmente supportate solo nell'app sul campo e nell'app Web.
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:
Il nome dell'elenco, yes_no, nel foglio di lavoro del sondaggio deve corrispondere al nome dell'elenco nel foglio di lavoro choices. Ciò garantisce che il modulo visualizzi l'elenco corretto di risposte possibili per una domanda specifica.
Per impostazione predefinita, quando un sondaggio viene pubblicato, le scelte nelle domande select_one vengono aggiunte al feature layer del sondaggio come domini valore codificato. È possibile disabilitare la creazione di domini utilizzando il processo di pubblicazione. Per ulteriori informazioni, vedere Opzioni di pubblicazione.
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 sondaggi 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.
Per ulteriori considerazioni sulla modifica degli elenchi di scelte nei sondaggi esistenti, vedi Aggiorna un rilevamento.
È 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}')
Aspetto
Impostando la colonna aspetto su minimo, una domanda select viene visualizzata in un menu a discesa.
Impostando Aspetto su orizzontale, le scelte per una domanda di tipo select vengono visualizzate orizzontalmente in colonne di uguale larghezza.
L'aspetto compatto è simile all'aspetto orizzontale ma usa un metodo differente per determinare le larghezze della colonna che possono determinare scelte che occupano meno spazio.
Nota:
In Survey123 Connect, puoi specificare un numero massimo di colonne per l'aspetto compatto fornendo un numero separato da un trattino. Ad esempio, compact-3 limita la domanda a un massimo di tre colonne per le domande a scelta multipla nei sondaggi utilizzati con l'app sul campo o l'app Web.
Gli aspetti compatto e compatto orizzontale sono identici. Nell'app Web Survey123, invece di utilizzare colonne, questi aspetti dispongono affiancate nelle righe le etichette delle scelte di una domanda di tipo select, senza spaziatura aggiuntiva.
Per una domanda di tipo select_one, impostando la colonna aspetto su likert le scelte vengono visualizzate come una scala Likert. Una scala di Likert è una scala di valutazione che consente di specificare il grado di accordo con un'affermazione rispetto a una scala di accordo-disaccordo simmetrica.
Impostando aspetto su autocomplete, una domanda di tipo select viene visualizzata con un campo di testo e un menu a discesa. L'immissione di testo in questo campo consente di limitare il menu a discesa alle sole risposte che contengono il testo. Ciò è utile per gli elenchi di scelta molto lunghi.
Nota:
L'aspetto autocomplete per le domande di tipo select_multiple è supportato solo in Survey123 Mobile. Non è supportato nell'app di campo né nell'app Web.
Impostando aspetto su search, puoi popolare l'elenco delle scelte di una domanda di tipo select con valori provenienti da una tabella CSV nella cartella media del rilevamento oppure da un feature layer o una tabella esistenti. Per ulteriori informazioni, vedi Crea un elenco di scelte dinamico utilizzando l'aspetto search.
Impostando aspetto su image-map, nell'app di campo una domanda di tipo select può essere visualizzata come un'immagine con regioni selezionabili come scelte mediante un file SVG. Per ulteriori informazioni, vedi Lavora con file SVG
Crea un elenco di scelte dinamico utilizzando l'aspetto search
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.
Le domande di tipo select_one e select_multiple supportano l'aspetto search, che può essere utilizzato per popolare l'elenco delle scelte con valori provenienti da una tabella CSV nella cartella media del rilevamento oppure da un feature layer o una tabella esistenti. Quando l'aspetto search viene utilizzato, è comunque necessario includere una voce nel foglio di lavoro delle scelte, ma, invece di elencare ognuna delle scelte, fare riferimento al nome del campo dalla tabella o feature layer esistenti.
Nell'esempio che segue, un elenco di scelta denominato us_states è definito nel foglio di lavoro delle scelte e utilizzerà il campo STATE_NAME sia per il nome che per l'etichetta della scelta.
Nell'esempio che segue, questa lista di scelta ha un riferimento nel foglio di lavoro del sondaggio allo stesso modo di altre liste di scelta, ma include l'espressione di aspetto di ricerca che fa riferimento al feature layer esistente dal quale ottiene le scelte.
L'espressione di aspetto di ricerca deve essere strutturata nel modo seguente, con le variabili separate da una virgola:
search(tableName, searchType, searchColumn, searchText, filterColumn, filterText)Il parametro tableName accetta il nome del file .csv presente nella cartella media del sondaggio, ad esempio airports, oppure l'URL di un feature layer o di un layer di un map service, preceduto da un nome da utilizzare come riferimento interno alla tabella in Survey123. l nome della tabella non deve necessariamente corrispondere al nome del layer ospitato, ma poiché Survey123 lo utilizza internamente come riferimento alla ricerca, deve essere diverso da tutti gli altri nomi di tabella e dai file .csv utilizzati nel sondaggio. È possibile aggiungere facoltativamente i parametri della richiesta di interrogazione all'endpoint REST del feature layer o ai map service layer per configurare il comportamento di ricerca. Nell'esempio seguente, un URL del feature layer viene aggiunto con il parametro resultRecordCount per popolare l'elenco di scelte con i primi 10 risultati dell'interrogazione con la ricerca memorizzata internamente con il nome airports:
"airports?url=https://services1.arcgis.com/e7dVfn25KpfE6dDd/arcgis/rest/services/Airports2/FeatureServer/0&resultRecordCount=10"L'elenco di scelte può essere filtrato anche utilizzando un'espressione WHERE. Quando si utilizza il seguente esempio come tableName, l'elenco di scelte sarà filtrato per mostrare solo gli stati in cui il nome non è Alabama o Alaska:"state?url=https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/USA_States_Generalized_Boundaries/FeatureServer/0&where=STATE_NAME
NOT IN('Alabama', 'Alaska')"
Nota:
I parametri di ricerca che includono caratteri speciali devono essere codificati se il sondaggio verrà utilizzato nell'app Web Survey123. La codifica sostituisce i caratteri speciali (ad esempio un carattere jolly nell'espressione) con il simbolo di percentuale (%) seguito dal corrispondente valore esadecimale.
I seguenti parametri aggiuntivi sono facoltativi, ma possono essere utilizzati per restringere i risultati restituiti dalla ricerca:
| Parametro | Descrizione |
|---|---|
searchType | Controlla il tipo di ricerca eseguita e accetta valori diversi a seconda che la tabella da cercare sia una tabella spaziale all'interno di un feature layer o una tabella non spaziale in un CSV o una tabella feature. Per le tabelle spaziali i tipi di ricerca accettati sono intersects, contains, crosses, envelope_intersects, index_intercepts, overlaps, touches e within. Per maggiori informazioni, consultare Relazioni spaziali. Per le tabelle non spaziali i tipi di ricerca supportati sono contains, startswith, endswith e matches. |
searchColumn | Determina la colonna in cui avverrà la ricerca del testo nel parametro searchText. Queste colonne sono prese dalla tabella stessa. In aggiunta una tabella spaziale in un feature layer può cercare le colonne @geopoint, @geotrace e @geoshape. |
searchText | Contiene il testo che verrà cercato e restituito nel parametro searchColumn. |
Inoltre, è possibile aggiungere i seguenti parametri di filtro all'espressione di ricerca per affinare ulteriormente i valori dell'elenco delle scelte:
| Parametro | Descrizione |
|---|---|
filterColumn | Imposta una colonna per la ricerca di corrispondenze al testo fornito nel parametro filterText. L'interrogazione di ricerca restituirà solo i risultati contenenti questo testo. I parametri filterColumn e filterText devono essere usati insieme. |
filterText | Il testo ricercato nella colonna fornito dal parametro filterColumn. I parametri filterColumn e filterText devono essere usati insieme. |
L'esempio seguente di espressione di ricerca include alcuni dei parametri facoltativi dell'aspetto search. Popola un elenco di scelte con il contenuto di un file .csv, utilizzando una domanda precedente come testo di ricerca.
search('csvName', 'matches', 'breed', ${DogQuestion})
Nota:
Le domande con l'aspetto search vengono visualizzate nell'app Web Survey123 nello stesso modo delle domande di tipo select con l'aspetto autocomplete.
Specify other
Per le domande a scelta multipla, i sondaggi possono includere l'opzione other per consentire di selezionare un'altra risposta quando quella desiderata non è presente 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 sondaggi 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 sondaggio 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 il metodo integrato, Survey123 Studio e Survey123 Connect creano automaticamente la scelta other 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 sondaggio. 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 Studio e Survey123 Connect creano automaticamente un campo aggiuntivo nel feature layer utilizzando il nome della domanda a scelta multipla seguito da _other, ad 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. Devi creare manualmente nel feature layer il campo per la domanda Specify other utilizzando 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 sondaggio.
Per migliori risultati, codificare il file .csv usando la codifica dei caratteri UTF-8. Se utilizzi Microsoft Excel per creare il file .csv, salvalo in formato CSV UTF-8.
Nel file .csv possono essere incluse colonne di etichette tradotte, ma le scelte tradotte verranno visualizzate solo in Survey123 Studio, Survey123 Connect, Survey123 Mobile e nell'app di campo, non nell'app Web.
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 sondaggio 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
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.
Per collegare un file .csv dal contenuto ArcGIS a un sondaggio, procedere nel modo di seguito indicato:
- Assicurati che il file .csv sia ospitato in ArcGIS Online o ArcGIS Enterprise e che abbia le stesse autorizzazioni di condivisione del sondaggio.
- Assicurati che il sondaggio sia pubblicato in ArcGIS prima di tentare di collegare il contenuto.
- In Survey123 Connect, apri il sondaggio e fai 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 vengono scaricati automaticamente insieme al rilevamento nell'app di campo.
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
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.
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, procedi come segue:
- 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