ArcGIS Survey123 può essere integrato con altre app utilizzando link per aprire l'app Web o l'app da campo Survey123, Survey123 Connect o un'altra app. Ad esempio, è possibile creare link per avviare e aprire l'app da campo Survey123 da un'altra app Esri, un popup di una mappa web o un semplice collegamento ipertestuale in una email o sito Web. È possibile utilizzare un URL per scaricare e aprire automaticamente un rilevamento per modificarlo in Survey123 Connect. È anche possibile collegarsi ad altre app da Survey123, ad esempio ArcGIS QuickCapture e ArcGIS Field Maps.
Utilizzare i modelli di URL nella tabella per creare link per accedere da un browser Web o un'altra app.
| Cosa avviare | Da dove collegarsi | Modello URL da utilizzare |
|---|---|---|
Web app | browser Web | Modulo rilevamento per ID: |
App da campo | Android e iOS | Link app Survey123: |
Windows, Android, un gruppo selezionato di app su iOS | Schema URL personalizzato: | |
Survey123 Connect | Windows | Schema URL personalizzato: |
Altra app | Modulo rilevamento | Collegamento da Survey123: varia in base all'app |
I seguenti esempi mostrano come aprire uno specifico rilevamento utilizzando questi modelli di URL:
- https://survey123.arcgis.com/share/36ff9e8c13e042a58cfce4ad87f55d19
- https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19
- arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19
- arcgis-survey123connect://?portalUrl=https://www.arcgis.com&itemID=36ff9e8c13e042a58cfce4ad87f55d19
I collegamenti app Survey123 conformi ai requisiti impostati da App Store e Google Play consentono collegamenti ad altre app e supportano link brevi più facili da condividere.
I collegamenti schema URL personalizzati non possono essere abbreviati e possono essere difficili da aprire in Android. Valutare l'invio preventivo di collegamenti schema URL personalizzati in forma di collegamenti ipertestuali simili ai seguenti:
<a href="arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19">Open survey</a>Parametri URL
È possibile aggiungere parametri URL alla fine dei link per personalizzare ulteriormente il modo in cui si apre l'app. Ad esempio, è possibile impostare la posizione predefinita per una domanda geopoint o compilare una domanda di testo.
I parametri URL iniziano con il carattere ? e sono separati dal carattere &. L'esempio seguente mostra uno schema URL, con il primo parametro (itemID) che inizia con il carattere ? e ciascuno dei parametri di campi successivi (color_1 e color_2) separati dal carattere &.
arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:color_1=red&field:color_2=bluePer ulteriori URL di esempio e parametri URL supportati, fare riferimento a Avviare l'app Web, Avviare l'app da campo, Avviare Survey123 Connect e Avviare un'altra app da Survey123.
Nota:
Prima di utilizzare un collegamento contenente parametri per il lancio di un sondaggio nell'app sul campo, è preferibile che l'app sia già installata sul dispositivo. Per ulteriori informazioni, consultare Installare l'app da campo Survey123.
Codifica URL
Anche se i parametri URL non codificati funzionano in alcuni ambienti, si raccomanda di codificarli. La codifica sostituisce i caratteri non validi con il simbolo percentuale (%) seguito dal relativo equivalente esadecimale.
Ad esempio, il seguente è un collegamento Survey123 che utilizza un callback per tornare a uno specifico progetto in QuickCapture con parametri non codificati:
https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https://quickcapture.arcgis.app?itemID=867895a71a1840399476fc717e76bb43Di seguito è riportato lo stesso URL con parametri codificati:
https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https%3A%2F%2Fquickcapture.arcgis.app%3FitemID=867895a71a1840399476fc717e76bb43Non deve essere codificato un segno equivalente che specifica una interruzione tra una chiave e il suo valore.
Suggerimento:
Un modo per creare parametri codificati è usare ArcGIS Arcade. La funzione UrlEncode permette di definire un insieme di coppie di valori chiave che rappresentano ogni parametro e producono un URL con una codifica appropriata.
Un autore del rilevamento potrebbe anche voler oscurare i parametri degli URL così da non rendere visibili i dati sensibili nell'URL. In questo caso, quando si crea un URL da utilizzare nell'applicazione Web, includere encodeUrlParams=true. Per ulteriori informazioni, consultare Parametri URL per aprire l'app Web.