Avviare l'app da campo

È possibile creare collegamenti app per aprire l'app da campo Survey123 da un'altra app, un popup di una mappa web o un collegamento ipertestuale o sito Web. Utilizzare uno schema URL personalizzato per avviare l'app dal browser Web o utilizzare il collegamento app Survey123 per avviarla da un'app su Android o iOS. Utilizzare parametri URL per personalizzare il modo in cui l'app da campo viene aperta, ad esempio caricare uno specifico rilevamento, impostare coordinate per la posizione mappa predefinita e compilare risposte alle domande con valori predefiniti o trasferendo attributi di dati da un popup di una mappa web.

Collegare da un browser Web su Windows

È possibile creare un collegamento per aprire l'app da campo e integrarlo in un'altra app. È possibile inserire lo stesso collegamento in un browser Web per i test.

Nota:

Una volta creato il collegamento, è possibile sostituire arcgis-survey123:// con https://survey123.arcgis.app come collegamento Survey123 da utilizzare su iOS o Android.

La seguente procedura descrive come creare uno schema di URL personalizzato e utilizzarlo in un browser Web desktop:

1. Digitare arcgis-survey123:// nel browser.

   L'app di campo Survey123 si apre (o viene visualizzato un messaggio che invita ad aprirla).

   Nota:

   Per avviare e scaricare un rilevamento da un portale specifico, includere il parametro URL del portale, ad esempio, arcgis-survey123://?portalUrl=host.domain.com/webadaptor (dove host, domain e webadaptor sono sostituiti dalle informazioni del portale).

2. Aggiungere un riferimento univoco a un rilevamento e aggiungerlo all'URL:
   1. Identificare l'ID elemento del rilevamento che si desidera aprire.

      Nota:

      Questa è la stringa di caratteri utilizzata da ArcGIS Online per identificare in modo univoco il rilevamento e che è possibile trovare nell'URL dall'elemento del modulo in ArcGIS Online. Ad esempio, se l'URL del rilevamento è https://exampleurl.maps.arcgis.com/home/item.html?id=36ff9e8c13e042a58cfce4ad87f55d19, l'ID dell'elemento del modulo è 36ff9e8c13e042a58cfce4ad87f55d19.

   2. Includere il rilevamento nell'URL aggiungendo ?itemID= e l'ID elemento del modulo alla fine dell'URL.
   L'URL dovrà essere simile al seguente:

   arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19

   Se si esegue il test dell'URL, deve aprire l'app da campo Survey123 e aprire immediatamente il rilevamento.

   Nota:

   Se non è già presente sul dispositivo, il rilevamento viene scaricato su di esso.

3. Includere risposte predeterminate alle domande aggiungendo nell'URL un riferimento a un campo utilizzando il nome a esso assegnato in XLSForm (non la sua etichetta). Ad esempio, per popolare il campo Cognome, digitare &field:surname= e il valore.

   & funge da separatore di parametri e field: si riferisce al nome della domanda da popolare.

   L'URL dovrà essere simile al seguente:

   arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser

   È quindi possibile usare l'URL per aprire l'app da campo Survey123 e il rilevamento e compilare la domanda con la risposta indicata. In un URL del rilevamento è possibile compilare più domande. I nomi dei campi sono sensibili alle maiuscole e minuscole.

4. Definire una posizione per una domanda geopoint nel rilevamento aggiungendo coordinate all'URL:
   • Digitare &center= e inserire le coordinate.
   • Digitare le coordinate di latitudine e longitudine in gradi decimali, separandole con una virgola.
   • Facoltativamente, aggiungere l'altitudine in metri decimali come terzo valore, anch’esso separato da una singola virgola.

   L'URL finale dovrà essere simile al seguente:

   arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser&center=37.8199,-122.4783,20

   Questo URL aprirà l'app da campo Survey123 e il rilevamento scelto, compilerà una domanda di testo e fornirà una nuova posizione predefinita per la domanda geopoint.

   Gli attributi dei campi possono essere trasferiti a Survey123 anche da un popup in una mappa web di ArcGIS, consentendo l'integrazione con altre app Esri che utilizzano i popup in una mappa web. Questa funzionalità si può utilizzare per compilare un campo in Survey123 con il valore dell'attributo di una feature anziché con un valore definito, indicando il nome dell'attributo tra parentesi graffe.

5. Aprire la mappa web e selezionare Pop-up per uno dei layer. Scegli Aggiungere contenuto e selezionare Testo. Fornire il testo da visualizzare per il collegamento e fare clic sul pulsante Collegamento per inserire il valore dell'URL collegamento.

   

   Questo URL compila il campo surname con il contenuto dell'attributo del nome della feature selezionata, anziché con un valore impostato:

   arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname={name}

   Questo URL compila il campo hydrantGlobalID con l'ID globale dell'idrante selezionato:

   arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:hydrantGlobalID={globalid}

   Nota:

   Per impostazione predefinita, i valori possono solamente essere trasferiti a domande a scelta singola o a scelta multipla da un pop-up in una mappa web se il nome e l'etichetta della scelta corrispondente sono identici. Se i nomi e le etichette nel proprio elenco di opzioni sono differenti, è possibile utilizzare le funzioni DomainCode o UrlEncode in un'espressione ArcGIS Arcade nel popup per trasferire il valore desiderato.

   Le domande all'interno di ripetizioni non possono essere compilate.

Collegare da un'altra app su iOS o Android

È possibile creare un collegamento da utilizzare in applicazioni ArcGIS per aprire Survey123 e acquisire dati in un rilevamento. La seguente procedura descrive come creare un collegamento a un'app Survey123 e utilizzarlo in un pop-up di una mappa web. Questo collegamento viene inserito nel popup di una mappa Web nell'organizzazione ArcGIS. È possibile testare il collegamento con un browser Web (con passaggi simili a quelli della sezione precedente) su un dispositivo iOS o Android.

1. Aprire una mappa web che verrà visualizzata sul dispositivo e selezionare Pop-up per uno dei layer.
2. Scegliere Aggiungi contenuto e selezionare Testo.
3. Digitare Avvia Survey123, evidenziare questo testo e fare clic sul pulsante Collegamento per inserire l'URL collegamento. Digitare https://survey123.arcgis.app e fare clic su OK.
   1. Aprire la mappa web su un dispositivo mobile tramite browser o un'app ArcGIS.
   2. Selezionare una feature e fare clic sul collegamento Avvia Survey123 nel popup per aprire Survey123.
4. Per includere il rilevamento nell'URL, aggiungere ?itemID= e l'ID elemento del modulo alla fine dell'URL.
   L'URL dovrà essere simile al seguente:

   https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19

   Se si esegue il test dell'URL, deve aprire l'app da campo Survey123 e aprire immediatamente il rilevamento.

   Nota:

   Se non è già presente sul dispositivo, il rilevamento viene scaricato su di esso.

5. Includere risposte predeterminate alle domande aggiungendo nell'URL un riferimento a un campo utilizzando il nome a esso assegnato in XLSForm (non la sua etichetta). Ad esempio, per popolare il campo Cognome, digitare &field:surname= e il valore.

   & funge da separatore di parametri e field: si riferisce al nome della domanda da popolare.

   L'URL dovrà essere simile al seguente:

   https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser

   È quindi possibile usare l'URL per aprire l'app da campo Survey123 e il rilevamento e compilare la domanda con la risposta definita. In un URL del rilevamento è possibile compilare più domande. I nomi dei campi sono sensibili alle maiuscole e minuscole.

6. Definire una posizione per una domanda geopoint nel rilevamento aggiungendo coordinate all'URL:
   • Digitare &center= e inserire le coordinate.
   • Digitare le coordinate di latitudine e longitudine in gradi decimali, separandole con una virgola.
   • Facoltativamente, aggiungere l'altitudine in metri decimali come terzo valore, anch’esso separato da una singola virgola.

   L'URL finale dovrà essere simile al seguente:

   https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser&center=37.8199,-122.4783,20

   L'URL completo ora aprirà l'app da campo Survey123 e il rilevamento scelto, compilerà una domanda di testo e fornirà una nuova posizione predefinita per la domanda geopoint.

Parametri URL per avviare l'app da campo

I seguenti parametri possono essere utilizzati per personalizzare l'apertura dell'app di campo:

Parametro	Descrizione	Tipo
center	Centra la mappa in base a latitudine, longitudine e altitudine note. Esempio: center=37.8199,-122.4783,20	Stringa
field:fieldname	Popola le domande del rilevamento con i valori del campo. Esempio: field:surname=Klauser	Stringa
portalUrl	L'URL del portale in cui è ospitato l'elemento del rilevamento. Esempio: portalUrl=https://myorg.arcgis.com	Stringa
itemID	Il modulo da aprire Esempio: itemID=36ff9e8c13e042a58cfce4ad87f55d19	UUID
download	Scarica automaticamente il rilevamento quando il dispositivo è online. L'impostazione predefinita è true. Esempio: download=false	Booleano
action	Specifica come viene aperto il rilevamento. I valori supportati sono collect (predefinito), edit, view e copy. Esempio: action=edit	Stringa
folder	Specifica la cartella da mostrare quando viene aperto il rilevamento. I valori supportati sono inbox, drafts, outbox, sent e * (cartella panoramica). Aggiungere il parametro filter all'URL per filtrare i rilevamenti nella cartella specificata. Specificare folder=* e il parametro filter per filtrare i rilevamenti in tutte le cartelle e mostrarli nella cartella panoramica. Esempi: folder=inbox folder=*&filter=lake	Stringa
callback	L'URL a cui tornare quando un'azione del modulo (per esempio inviare, passare a bozze, annullare o uscire) è completata. Esempio: callback=https://quickcapture.arcgis.app	URL
callback:status	Specifica lo stato del rilevamento quando viene attivato il callback. I valori supportati per lo stato sono cancel, draft, submit e close. Lo stato close può essere usato solo quando action=view. Esempio: callback:draft=https://quickcapture.arcgis.app	Stringa
filter	Filtra i rilevamenti esistenti nel dispositivo che corrispondono a una stringa presente nel nome istanza o in un campo specifico. Filtra la posta in entrata per impostazione predefinita. Aggiungere il parametro folder all'URL per filtrare i rilevamenti in una cartella specifica. Quando è stato definito un nome istanza, fornire una stringa che rappresenta il nome completo dell'istanza o una sottostringa del nome istanza. I seguenti esempi mostrano come filtrare tutti i record con il nome istanza completo Klauser o tutti i record nelle Bozze che contengono la parola lago all'interno del loro nome istanza. Esempi: filter=Klauser filter=lake&folder=drafts Quando non è definito alcun nome istanza o quando è necessario filtrare in base a un campo che non fa parte del nome istanza, includere sia il nome campo che il valore del campo, nel formato filter=field:fieldname:fieldvalue. Solo i valori campo completi possono essere filtrati usando il campo. I seguenti esempi mostrano come filtrare i record per i quali il tipo di corpo acqueo è Fiume o per i quali il numero di stazione è 5171. Esempi: filter=field:waterbodytype:River filter=field:ws_stationnumber:5171	Stringa
update	Aggiorna la cartella Posta in arrivo quando usata con il parametro folder=inbox. Se un URL include sia update che filter, il filtro viene applicato dopo l'aggiornamento. L'impostazione predefinita è false. Esempio: update=true&folder=inbox	Booleano
q:queryparameter	Interroga il feature layer per un record esistente. Viene utilizzato per recuperare i contenuti non ancora presenti nel dispositivo. Esempi: q:where=ws_stationnumber=5171 q:where=waterbodytype='Lake' q:globalId=1d392670-33e2-456d-8435-7fad3abd8bb9	Stringa