Per impostazione predefinita, quando si pubblica un rilevamento in ArcGIS Survey123 Connect, viene creato un feature layer utilizzando lo schema del rilevamento. In alternativa, è possibile scegliere di associare il rilevamento a un feature layer esistente.
Preparare un feature layer
Per usare un feature layer con Survey123, esso deve essere un elemento in ArcGIS Enterprise o ArcGIS Online. Sono inclusi i feature layer ospitati e i feature layer pubblicati nei server federati e non federati.
Nota:
Per utilizzare i feature service non federati è necessaria una configurazione aggiuntiva, in quanto è necessario creare manualmente un elemento feature layer nella propria organizzazione ArcGIS che rappresenti il servizio. Per maggiori dettagli, consultare l'articolo della base di conoscenza su come effettuare connessioni a servizi ArcGIS Server non federati.
Il proprietario e gli utenti del rilievo devono avere accesso al feature layer e deve essere modificabile. Considerare anche quanto segue:
- Se gli utenti raccolgono nuovi rilevamenti, è necessaria la funzionalità Create.
- Se gli utenti modificano i rilevamenti esistenti, è necessaria la funzionalità Update sul layer.
- Se gli utenti acquisiscono immagini, audio o file, hasAttachments deve essere impostato su true.
Quando si abilitano gli allegati in un feature layer, le colonne KEYWORD e EXIFINFO non vengono aggiunte allo schema per impostazione predefinita. Questa colonna è necessaria per poter associare gli allegati al record corretto. Dopo aver abilitato gli allegati, eseguire lo strumento di geoprocessing Aggiorna allegati per abilitare le parole chiave.
Nota:
Si consiglia di aggiungere le colonne KEYWORD ed EXIFINFO prima di acquisire i record con Survey123, in modo che tutti gli allegati inviati abbiano le parole chiave. Se le colonne KEYWORD ed EXIFINFO non esistono prima che gli allegati vengano inviati, il notebook Python Aggiorna parole chiave allegato può essere utilizzato per aggiornare gli allegati.Le ripetizioni non possono fare riferimento a tabelle o layer correlati, a meno che la tabella o il layer figlio utilizzi un campo GUID per la relazione.
Se si prevede di modificare i propri rilevamenti, assicurarsi che il feature layer consenta i valori null o che il rilevamento utilizzi i campi richiesti. Survey123 utilizza i valori nulli nelle modifiche quando si elimina una risposta senza sostituirla, quindi Survey123 non invierà un rilevamento da un feature layer che non consente i valori nulli.
Devono essere impostate su true le seguenti funzionalità aggiuntive per il feature layer:
- supportsAttachmentsByUploadId: questa funzionalità viene attivata automaticamente quando gli allegati sono abilitati nel feature layer. Consente all'app di caricare tutti gli allegati associati a un rilevamento prima di inviarlo. Se uno degli allegati non viene caricato, l'intero invio del sondaggio viene annullato, prevenendo la perdita di dati.
- supportsApplyEditsWithGlobalIds: il feature layer deve supportare l'applicazione di modifiche con ID globali. Ciò consente all'app di creare e gestire gli ID globali nelle feature create (a differenza del server che crea un nuovo ID globale per le feature create).
Affinché un feature layer supporti le modifiche con gli ID globali, devono essere soddisfatti i seguenti requisiti:
- I layer del feature layer devono avere una colonna GlobalId con un indice univoco. Il modo migliore per farlo è abilitare la sincronizzazione quando si pubblica il feature layer.
- 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.
- Gli ID globali devono esistere in un feature layer o in una tabella, prima di abilitare gli allegati su entrambi.
- Se il feature layer contiene layer abilitati per m, è necessario abilitare la modifica senza valori m.
Per ulteriori informazioni sul supporto della modifica in un feature layer, consultare supportsApplyEditsWithGlobalIds in Layer (Feature Service) nella documentazione di ArcGIS REST API.
Nota:
Survey123 supporta solo relazioni GUID uno a molti durante l'utilizzo dei feature layer esistenti e delle tabelle correlate. Le relazioni uno a uno non sono supportate
Creare un sondaggio da un feature layer
Si può creare un rilievo da un feature layer esistente in Survey123 Connect. Il feature layer deve essere predisposto per l'uso con Survey123. Accedere alla propria organizzazione ArcGIS, poi fare clic su Nuovo rilevamento. Scegliere la categoria Feature service. Cercare e selezionare un feature layer, quindi fare clic su Crea rilevamento. Viene generato un XLSForm dal feature layer. È quindi possibile pubblicare il rilevamento immediatamente oppure personalizzarlo ulteriormente. Per esempio, puoi aggiungere etichette più descrittive alle domande o organizzarle in gruppi.
Se il feature layer scelto dispone di più di un layer, il rilevamento viene generato in base al primo layer. Per basare un rilevamento su un altro layer del feature layer, è necessario autorizzare il rilevamento manualmente e aggiornare le proprietà form_id e submission_url nella scheda delle impostazioni del foglio di calcolo. Per maggiori informazioni, consultare Creare un rilevamento che corrisponde a un feature layer.
Se il feature layer scelto dispone di allegati, verrà creata una singola domanda di immagine nel rilevamento denominata <nome_layer>_image. Questo nome non corrisponderà a una parola chiave nella tabella degli allegati e deve essere aggiornato. Se gli allegati esistenti rappresentano più di una domanda, è necessario aggiungere domande di immagine al rilevamento per far corrispondere ogni parola chiave nella tabella degli allegati.
Nota:
Se il rilevamento in fase di creazione richiede domande audio o file, è necessario aggiungerle manualmente al rilevamento. Dopo la generazione del rilevamento, aprire il foglio di calcolo e aggiungere le domande. Per maggiori informazioni, vedere Domande sui media. Il feature layer deve anche avere gli allegati abilitati.
Creare un rilevamento che corrisponde a un feature layer
È possibile creare manualmente un nuovo rilevamento che corrisponde a un feature layer esistente, ma è necessario aggiornare le proprietà form_id e submission_url nel riquadro impostazioni del foglio di calcolo in modo da definire un collegamento tra il rilevamento e l'elemento del feature layer nel portale o in ArcGIS Online.
La proprietà form_id definisce in modo esplicito il nome del layer nel feature layer utilizzato dal rilevamento. Per ulteriori informazioni, vedi l'articolo della Knowledge Base su come scrivere un'indagine che corrisponde ad un servizio di feature.
La proprietà submission_url corrisponde all'URL dell'elemento del feature layer.
Suggerimento:
Devi fornire l'URL dell'elemento del livello della caratteristica, come mostrato sopra. Spesso si commette l'errore di usare al suo posto l'URL del feature layer, che non è supportato.
Per creare l'URL, è necessario concatenare l'ID elemento con i Contenuti principali del portale. L'esempio nell'immagine precedente mostra un collegamento a un elemento ArcGIS Online; il collegamento allo stesso elemento in un portale appare come segue:https://<host>:<port>/arcgis/sharing/rest/content/items/21a6c530b31a4523bdff7gg94c9c5d9a
Se si ha l'esigenza di un rilevamento che richiede non tutti, ma solo alcuni campi del feature layer, si consiglia di generare il rilevamento dal feature layer (come descritto nella sezione precedente) ed eliminare le domande superflue prima di pubblicare il rilevamento. In questo modo, le proprietà form_id e submission_url vengono create automaticamente.
Modifica schema
Una volta creato un rilevamento da un feature layer esistente, possono essere aggiunte nuove domande e nuovi valori di elenco di scelta al rilevamento solo dopo che il campo o il dominio corrispondenti sono aggiunti al feature layer. Quando viene creato un rilevamento da una vista di feature layer, possono essere aggiunte nuove domande e nuovi valori di elenco di scelta al rilevamento solo dopo che il campo o il dominio corrispondenti sono aggiunti al feature layer sottostante ed è stato propagato alla vista del feature layer.