Survey123 Connect convertirà i moduli progettati usando la specifica XLSForm in una XForm da usare in Survey123 e pubblicarli in ArcGIS Online o ArcGIS Enterprise. Durante questo processo potrebbero verificarsi dei problemi.
Suggerimento:
Lo strumento Analizza rilevamento controlla l'XLSForm del rilevamento per individuare i problemi comuni e fornisce alcuni suggerimenti di procedure consigliate nella progettazione del rilevamento.Errori di conversione del modulo
Quando si crea un rilevamento in Survey123 Connect, si utilizza la specifica XLSForm per progettare il modulo utilizzando un foglio di calcolo. Survey123 Connect converte il foglio di calcolo in un XForm, permettendovi di vedere in anteprima il vostro sondaggio come apparirà in Survey123.
La conversione viene effettuata dopo il completamento della seguente operazione:
- Salvare le modifiche nel foglio di calcolo.
- Fare clic sul pulsante Aggiorna in Survey123 Connect.
Se c'è un problema con il tuo sondaggio, riceverai un errore dal servizio di conversione dei moduli. Nell'esempio riportato, il messaggio di errore indica che il problema riguarda una voce del nome indicata come "cognome". In questo caso, la voce in oggetto presenta uno spazio. Lo spazio deve essere rimosso o sostituito con un carattere di sottolineatura o un trattino.
Nella tabella seguente sono indicati alcuni errori comuni relativi ai moduli:
| Descrizione dell'errore | Diagnosi |
|---|---|
Errore durante la conversione XLSForm | Nell'esempio in alto, l'errore aveva evidenziato la domanda detta last name. In questo caso, l'errore è lo spazio nella colonna name. Questo messaggio viene visualizzato anche quando si utilizzano caratteri non ASCII nella colonna name del foglio di calcolo survey o choices. È possibile utilizzare i caratteri ASCII nella colonna label ma non in quella name. |
[row : 2] Nome dell'elenco non presente nel foglio choices: [JobType] | Questo errore indica che una delle domande select_one o select_multiple fa riferimento a una lista che non esiste nel foglio di lavoro delle scelte. Nell'esempio, è necessario rimuovere le parentesi. |
Dovrebbero esservi più risposte possibili per la domanda. | Questo errore indica che una delle domande select_one o select_multiple che ha il parametro aggiuntivo or_other come parte del tipo ha anche un filtro di scelta definito. In una selezione cascade non è possibile selezionare le domande che includono l'opzione di immissione di un valore Other. |
Errori di rete
In caso di problemi ad accedere al servizio di conversione dei moduli, viene visualizzato un errore simile al seguente:
Nella tabella seguente sono indicati alcuni errori di rete comuni:
| Numero errore | Descrizione dell'errore | Diagnosi |
|---|---|---|
-1 | Impossibile aprire C:/Utenti/nome utente/ArcGIS/My Survey Designs/Form 1/Form 1.xlsx | Excel potrebbe aver bloccato il file. Assicurarsi che il rilevamento non sia stato aperto da un'altra applicazione o da un altro utente. |
3 | Impossibile trovare l'host survey123.arcgis.com | Stai eseguendo una versione precedente di Survey123 Connect. Aggiorna alla versione più recente. |
6 | Errore SSL handshake | Esistono una serie di problemi che potrebbero causare errori SSL handshake, come i seguenti:
È possibile testare i certificati SSL usati in un server Web mediante un tester online, come SSL Labs. |
99 | Timeout della connessione | A volte si verifica quando si lavora con rilevamenti di grandi dimensioni. Riprovare. |
202 | Errore durante il download https://survey123.esri.com/api/xls2xform - il server ha risposto: Proibito | Qualsiasi errore che ha esri.com nel messaggio punta al vecchio server. Aggiorna alla versione più recente. |
203 | Errore durante il download https://survey123.esri.com/api/xls2xform - il server ha risposto: Non trovato | Qualsiasi errore che ha esri.com nel messaggio punta al vecchio server. Aggiorna alla versione più recente. |
401 | Errore durante il download https://survey123.arcgis.com/api/xls2xform - il server ha risposto: Errore interno del server | In genere, questo errore viene attivato da espressioni nelle colonne rilevanti o di calcolo. Utilizzare le parentesi graffe e inserire il simbolo $ all'inizio dell'istruzione. |
403 | Errore durante il download di https://survey123.esri.com/api/xls2xform - Errore restituito dal server: Servizio temporaneamente non disponibile | Segnalare immediatamente il problema a Esri. |
498 | Token non valido | Il token che Survey123 Connect ha cercato di passare ad ArcGIS non è stato accettato. Spesso il problema è causato dall'URL di invio che tenta di trasferire un token a un feature layer pubblico. |
499 | Errore durante il trasferimento di https://survey123.arcgis.com/api/xls2xform - Errore restituito dal server: Errore proxy | L'API Survey123 non è disponibile o è scaduta. Riprovare dopo un breve periodo. Se il problema persiste, fate riferimento al Survey123 Esri Community per ulteriori informazioni. |
Nella finestra di dialogo dell'errore è possibile acquisire l'errore per inviarlo a Esri. Aggiungere eventuali ulteriori informazioni nell'e-mail che possano aiutare nella risoluzione del problema.
Errori di pubblicazione
Questi errori sono solitamente legati a problemi di creazione degli elementi dal proprio rilevamento in ArcGIS.
Nella tabella seguente sono indicati errori comuni di pubblicazione:
| Errore | Diagnosi |
|---|---|
URL di invio non compatibile (campo non trovato) | Il campo indicato non è presente nel feature layer designato dall'URL di invio, quindi le risposte del rilevamento sono incompatibili con il rilevamento. Annullare l'assegnazione dell'URL di invio per crearne uno nuovo oppure verificare che l'URL di invio sia abbinato al feature layer corretto. Questo errore è comunemente causato dal campo aggiuntivo creato quando si usa l'opzione or_other per le domande select_one o select_multiple. Per ulteriori informazioni, consultare Domante a scelta multipla. |
URL di invio non compatibile (errore di richiesta) | Controlla che l'utente con cui hai fatto il login in Survey123 Connect abbia il permesso di accedere al feature layer. |
Nessun campo chiave figlio in SurveyName per repeat_1 padre | Questo errore si verifica se il feature layer inviato utilizza chiavi padre ID globali non presenti nel rilevamento. Nella finestra Opzioni di pubblicazione, impostare Utilizza chiavi padre ID globale in relazioni ripetute su true. |
Impossibile eseguire CREATE TABLE perché la colonna 'x' nella tabella 'y' supera il limite massimo di 1024 colonne | Il rilevamento che si sta tentando di pubblicare ha un numero di campi maggiore al limite consentito da un feature layer in un'organizzazione ArcGIS (1.024). Ridurre il numero di campi a meno di 1.024 e pubblicare di nuovo il rilevamento. Per ulteriori informazioni su queste limitazioni, fare riferimento a Risoluzione dei problemi nella guida ArcGIS Online. |
L'URL di invio del Feature Service personalizzato non è compatibile con il rilevamento (il Feature Service non soddisfa i requisiti per un rilevamento con ripetizioni - supportsApplyEditsWithGlobalIds) | La proprietà supportsApplyEditsWithGlobalIds è impostata su false, ma deve essere impostata su true. Il modo più semplice per farlo è abilitare la sincronizzazione quando si pubblica il feature layer. |
L'URL di invio personalizzato non è compatibile con questo rilevamento (Destinazione relazione non trovata per la tabella) | C'è la possibilità che una ripetizione nel rilevamento sia associata scorrettamente a una tabella correlata nel feature layer, o che la tabella non esista. Assicurarsi che la ripetizione abbia lo stesso nome della tabella correlata di destinazione. |
Errori del portale
I rilevamenti pubblicati su ArcGIS Enterprise hanno limitazioni elencate sotto, che sono diverse da quelli pubblicati su ArcGIS Online.
- Non è possibile pubblica rilevamenti su ArcGIS Enterprise che usano certe parole chiave riservate come nomi di campo, come end(nomi di campo contenenti parole chiave sono accettati, come endSurvey, finché non sono esattamente la parola chiave). Parole chiave riservate sono elencate nel foglio di lavoro Riservato dei modelli XLSForm Survey123.
- Tutti i nomi di campo devono essere in minuscolo quando pubblicati su ArcGIS Enterprise.
- Il numero massimo di colonne che un layer feature pubblicato su un portale può contenere dipende dal geodatabase enterprise. Vedere la documentazione per il sistema di gestione del database per determinare i limiti di dimensione. Se il numero di domande nel tuo sondaggio supera il limite di colonne per il tuo geodatabase aziendale, la soluzione è quella di includere una ripetizione e impostare repeat_count a 1 per estendere il sondaggio su più tabelle.
- Il nome di una domanda nel foglio di lavoro del rilevamento non può contenere più di 32 caratteri.
- Non è possibile caricare il contenuto Survey123 su ArcGIS Enterprise o Portal for ArcGIS se non si sta usando ArcGIS Data Store.
- Quando ArcGIS Enterprise è installato in un ambiente disconnesso, i modello di rilevamento, gli esempi e gli URL di iscrizione sui layer feature ArcGIS Online non funzionano.
- Gli URL di invio non possono essere usati direttamente con un layer feature ArcGIS Server non federato. Una soluzione è fornita dalla registrazione del servizio con ArcGIS Online o ArcGIS Enterprise.
- Se si usa un geodatabase multiutente, i livelli possono usare il branch versioning ma non il versioning tradizionale. Survey123 sceglierà come destinazione la versione predefinita quando si usa un geodatabase con branch versioning. Per maggiori informazioni, vedere Tipi di versioni.
- esriFieldTypeDateOnly, esriFieldTypeTimeOnly, esriFieldTypeTimestampOffset e esriFieldBigInteger possono essere utilizzati solo in ArcGIS Online. Questi tipi di campi sono disponibili in ArcGIS Enterprise 11.2 e versioni successive.
Abilitare la registrazione diagnostica
Se si ricevono messaggi di errore non indicati in questo argomento o si verifica un comportamento imprevisto, potrebbe essere utile acquisire un registro delle informazioni da Survey123 Connect da condividere con altri soggetti (come il supporto Esri) per risolvere il problema.
Per abilitare la registrazione, aprire il menu nella home page dell'app, fare clic su Impostazioni e fare clic sulla scheda Diagnostica.
Per acquisire i messaggi in un file, fare clic sul pulsante di attivazione Registrazione per abilitare la registrazione. La casella di testo Posizione output di registrazione viene compilata automaticamente con la posizione predefinita dei file di registro. È possibile modificare il percorso del file. Per acquisire i messaggi di una console online compatibile con syslog, immettere il proprio URL nella casella di testo Registra percorso di output al posto della posizione del file di registro.
I file di registro possono essere condivisi o inviati via e-mail. Quando si sceglie di inviare il file di registro via e-mail dall'app, verranno inclusi la versione dell'app, il nome del sistema operativo e le impostazioni locali del sistema nel corpo dell'e-mail e il file di registro verrà incluso come allegato.
Nota:
Per la registrazione in tempo reale, la scheda Diagnostica mostra eventuali istanze della console di AppStudio aperta attualmente nella rete. Un simbolo circolare di ricerca viene visualizzato sulla scheda Diagnostiche fino a quando viene individuata una console AppStudio in esecuzione. Se si seleziona prima una console AppStudio e si fa clic sul pulsante di attivazione Registrazione, le informazioni di registrazione inizieranno a comparire in tale console. Per maggiori informazioni, vedere Cattura dell'output della console nell'aiuto di ArcGIS AppStudio.