Oltre a inviare i nuovi dati a un feature layer mediante un rilevamento, può essere necessario modificare i dati del rilevamento che sono stati inviati di recente, raccolti in precedenza o raccolti da altri utenti del rilevamento.
Abilita modifica
Le risposte ai rilevamenti possono essere modificate dalla cartella Inviati e dalla Posta in arrivo. Per abilitare la modifica in un rilevamento, la modifica deve essere abilitata anche per il feature layer sottostante.
È possibile modificare i rilevamenti precedentemente inviati esistenti nella cartella Inviati dell'app da campo Survey123. Per maggiori informazioni su come configurare le opzioni per le indagini inviate, vedi Cartella inviata.
Per modificare dati del rilevamento esistente memorizzati nel feature layer del rilevamento (per esempio, dati raccolti da un altro utente), è necessario abilitare la Posta in arrivo.
Attenzione:
L'abilitazione della Posta in arrivo abilita l'accesso in lettura ai dati del tuo rilevamento, che esporrà le tue risposte al rilevamento. Per ulteriori informazioni e pratiche consigliate per la protezione dei dati, consultare Condividere un rilevamento.
Per abilitare la posta in arrivo, vai alla scheda Opzioni della tua indagine in Survey123 Connect e clicca su Abilita caselladi posta. Appare una serie di opzioni che consente di controllare come gli utenti interagiscono con i rilevamenti nella posta in arrivo. Qualsiasi modifica apportata a queste opzioni avrà effetto quando il rilevamento viene pubblicato.
Scegli se i rilevamenti nella posta in arrivo possono essere modificati, visualizzati (solo lettura) o copiati in un nuovo rilevamento. È possibile digitare una espressione di interrogazione per limitare i rilevamenti che vengono restituiti nella posta in arrivo. È anche possibile applicare un filtro spaziale.
Nota:
La Posta in arrivo ora può contenere un massimo di 5.000 risposte al rilevamento. Questo limite si applica solo ai record del rilevamento dei genitori (non si applica alle ripetizioni).
Più record ci sono da restituire, più tempo sarà necessario per aggiornare la Posta in arrivo. Per un rilevamento che contiene ripetizioni, tieni presente che il numero totale di record recuperati dalla Posta in arrivo quando viene aggiornata potrebbe essere molto maggiore del numero di record principali. Ad esempio, se un feature layer contiene 2.000 record principali e ogni record principale ha 10 record ripetuti, la Posta in arrivo recupererà un totale di 22.000 record. È possibile limitare il numero di record padre applicando un'espressione di interrogazione o un filtro spaziale. È possibile limitare il numero di record ripetuti definendo un'interrogazione nella colonna bind::esri:parameters.
Attenzione:
Una risposta al rilevamento può solo esistere in un dispositivo in una cartella alla volta. Quando per un rilevamento sono abilitate sia la cartella Inviati che la Posta in arrivo, l'aggiornamento della Posta in arrivo non scarica le risposte che sono già nella cartella Inviati. Ciò significa che se una risposta presente nella cartella Inviati è stata aggiornata da un utente su un altro dispositivo, la risposta aggiornata non viene scaricata nella posta in arrivo.
Per questo motivo, si raccomanda di non abilitare la cartella Inviati e la Posta in arrivo per la stessa indagine se la tua intenzione è che più utenti possano modificare e aggiornare continuamente le risposte esistenti.
Espressioni WHERE
I rilevamenti disponibili per la modifica nella casella di entrata nell'app di campo Survey123 sono determinati dall'espressione di interrogazione specificata nel riquadro Opzioni del rilevamento in Survey123 Connect. Il rilevamento deve essere pubblicato ogni volta che l'interrogazione viene modificata in modo che le modifiche vengano attuate.
Le espressioni di interrogazione devono utilizzare la sintassi comune SQL e le funzioni supportate da ArcGIS. Tutte le interrogazioni vengono eseguite nel feature layer del rilevamento, quindi è possibile creare e testare l'espressione usando l'operazione di interrogazione nell'endpoint REST del feature layer. Per ulteriori informazioni su questo processo e per alcuni esempi di sintassi di interrogazione, consultare Interrogazione (Feature Service). Per maggiori informazioni sulle funzioni supportate, vedere Funzioni SQL standardizzate in ArcGIS Online.
Di seguito sono riportati degli esempi di casi di utilizzo e di sintassi:
- Questo esempio restituisce rilevamenti in cui il numero nel campo rating è maggiore o uguale a due:
rating>=2
- Questo esempio restituisce i rilevamenti per i quali le date nel campo EditDate sono uguali o successive al 13 aprile 2017:
EditDate>='2017-4-13'
- Questo esempio restituisce i rilevamenti nei quali il campo Editor è uguale a "BKlauser":
Editor='BKlauser'
- Questo esempio restituisce i rilevamenti nei quali il campo status è uguale a "for_review":
status='for_review'
- Questo esempio restituisce i rilevamenti per i quali le date nel campo inspection_date sono comprese negli ultimi sette giorni:
inspection_date>CURRENT_DATE-7 AND inspection_date<=CURRENT_DATE
- Questo esempio restituisce i rilevamenti nei quali il campo project_status non corrisponde a "complete":
project_status<>'complete'
- Questo esempio restituisce i rilevamenti nei quali il campo final_approval è vuoto (null):
final_approval IS NULL
- Questo esempio restituisce i rilevamenti nei quali il campo final_approval non è vuoto (null):
final_approval IS NOT NULL
Le interrogazioni della posta in arrivo supportano anche la variabile username. Questa variabile deve essere specificata nello stesso formato delle espressioni XLSForm. Ad esempio, Creator=${username} restituirà tutti i record creati dall'utente attualmente connesso.
Nota:
La variabile username è l'unico caso in cui la sintassi XLSForm può essere utilizzata in un'espressione di interrogazione. Anche se la variabile username deve essere scritta come ${username}, il suo valore è derivato dall'account ArcGIS dell'utente che ha effettuato l'accesso, non da una domanda nel rilevamento.
Per restituire i record dell'utente connesso da un campo che contiene un elenco di più utenti, deve essere utilizzata la funzione POSITION() nell'interrogazione. Ad esempio, l'interrogazione POSITION(${username} IN assigned_to) > 0 restituirà tutti i record del rilevamento che includono l'utente connesso, in cui i valori del campo assigned_to potrebbero essere un elenco separato da virgole di tutti i possibili assegnatari, come "George_Smith, Nick_Jones".
Filtro spaziale
Nella posta in arrivo, selezionare Aggiorna aggiornerà l'elenco dei rilevamenti mostrato sulla scheda Elenco. L'azione di aggiornamento generalmente restituisce tutti i rilevamenti che soddisfano l'espressione di interrogazione nella posta in arrivo (se impostata) e che non siano già memorizzati sul dispositivo in altre cartelle. Quando si seleziona Aggiorna sulla scheda Mappa, è possibile applicare un filtro spaziale per aggiornare l'elenco per mostrare solamente quei rilevamenti che sono presenti nell'estensione della mappa corrente.
Per abilitare il filtro spaziale, selezionare Applica filtro spaziale quando la scheda mappa è visibile sulla scheda Opzioni in Survey123 Connect. Nel seguente esempio, quando si seleziona Aggiorna, l'elenco dei rilevamenti viene aggiornato per mostrare solo le quattro risposte ai rilevamenti visibili nell'estensione della mappa corrente. Se il proprio rilevamento ha un nome istanze impostato, ogni feature sulla mappa viene etichettata col suo nome d'istanza.
Ripetizioni
Survey123 permette di modificare le feature che hanno record correlati sia dalla cartella Posta in arrivo che dalla cartella Inviati. Si possono aggiungere nuovi record e modificare quelli esistenti, anche se l'eliminazione dei record esistenti non è supportata. La modifica dei record esistenti è disattivata per impostazione predefinita a meno che non si abiliti allowUpdates=true mediante un parametro di interrogazione.
Nella colonna bind::esri:parameters si possono inserire parametri opzionali per le ripetizioni. Questi parametri sono formattati come coppie di valori chiave; i valori contengono spazi inseriti tra virgolette.
Per impostazione predefinita, nessun record correlato è disponibile con le risposte dell'indagine dalla cartella Posta in arrivo o dalla cartella Inviati. Per accedere ai record correlati a una risposta, occorre definire un'interrogazione nella colonna bind::esri:parameters per il tipo di domanda begin repeat. Le proprietà dell'interrogazione supportano gli stessi parametri delle espressioni WHERE di cui sopra, ad esempio, query="Editor='BKlauser'" per scaricare solo i record correlati a "BKlauser" nel campo Editor.
Per scaricare tutti i record in una tabella correlata, specificare un'interrogazione senza parametri (query).
I parametri applicabili alle ripetizioni mediante la colonna bind::esri:parameters su un tipo di domanda begin repeat includono i seguenti:
- query — Consente ai record di essere interrogati e scaricati sulla tabella correlata, per esempio query="severity='high'".
- allowAdds — Consente di aggiungere nuovi record a una ripetizione durante la modifica. Il valore predefinito è "True". Si può impostare su False utilizzando allowAdds=false.
- allowUpdates — Consente di aggiornare i record esistenti in una ripetizione durante la modifica. Il valore predefinito è "False". Si può impostare su True utilizzando allowUpdates=true.
Si possono usare più coppie di valori chiave contemporaneamente separandole con spazi, per esempio: allowUpdates=true query="Editor='BKlauser'". Se i valori stessi contengono degli spazi, possono essere racchiusi in virgolette.
Immagini
Survey123 permette all'utente di aggiungere immagini ai record di rilevamento esistenti. Mentre la modifica delle immagini esistenti non è supportata, ogni domanda di immagine fornisce un pulsante Duplica quando si modifica un sondaggio per copiare un'immagine esistente che può essere modificata con la rotazione, rinominando, o modificando con le apparenze draw e annotate.
Fornire nuove immagini è abilitato di default. Per disabilitare questa funzionalità, digitare allowAdds=false nella colonna bind::esri:parameters.
Ci sono alcune limitazioni note all'editing delle immagini:
- I flussi di lavoro offline non sono supportati.
- L'aspetto signature non supporta la funzione Duplica.
- Gli allegati immagine utilizzano proprietà di parole chiave per associare un'immagine alla domanda a cui è stata inviata. Le proprietà delle parole chiave non sono supportate da ArcGIS Enterprise prima della 10.8.1, quindi un'immagine inviata a un'indagine pubblicata in un portale ArcGIS Enterprise prima della 10.8.1 non sarà associata a una domanda. Allo stesso modo, le immagini allegate a una feature tramite un metodo diverso da un rilevamento (ad esempio, in ArcGIS Pro o una mappa web ArcGIS Online) potrebbero non avere parole chiave.
- Quando un rilevamento esistente viene scaricato su un dispositivo per l'uso da Posta in entrata, le immagini esistenti non vengono scaricate. La funzione count-selected conterà solo le immagini presenti sul dispositivo e restituirà 0 quando viene aperto il rilevamento per la prima volta. Le nuove immagini acquisite saranno contate.