ArcGIS Survey123 può essere integrato con altre app utilizzando collegamenti per avviare l'app componente specifica. Ad esempio, è possibile creare collegamenti per avviare e aprire Survey123 Mobile 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.
Suggerimento:
Survey123 Mobile apre i collegamenti di tre app: Survey123 Mobile, l'app da campo Survey123 e QuickCapture. Quando questi collegamenti vengono attivati dall'interno di Survey123 Mobile (da Utilizza un collegamento, Scansiona un codice QR o da un collegamento all'interno di un sondaggio o progetto QuickCapture), verranno aperti dentro a Survey123 Mobile. Per maggiori informazioni, consultare Aprire i contenuti.
Utilizzare i modelli di URL nella tabella per creare link per accedere da un browser Web o un'altra app. Gli esempi mostrano come aprire uno specifico rilevamento utilizzando questi modelli di URL.
| Cosa avviare | Da dove collegarsi | Modello URL da utilizzare |
|---|---|---|
| Survey123 Mobile | Android iOS | Collegamento app Survey1231: Esempio: |
Windows Android iOS2 | Schema URL personalizzato3: Esempio: | |
Web app | browser Web | Modulo rilevamento per ID: Esempio: |
App da campo | Android iOS | Collegamento app Survey1231: Esempio: |
Windows Android iOS2 | Schema URL personalizzato3: Esempio: | |
| Survey123 Studio | Windows | Schema URL personalizzato3: Esempio: |
Survey123 Connect | Windows | Schema URL personalizzato3: Esempio: |
Altra app | Modulo rilevamento | Collegamento da Survey123: varia in base all'app |
1: 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.
2: nei dispositivi iOS, gli schemi URL personalizzati sono approvati solo per un gruppo ristretto di app.
3: 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-mobile://?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-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:color_1=red&field:color_2=bluePer ulteriori URL di esempio e parametri URL supportati, fare riferimento a Avviare Survey123 Mobile, Funzionalità feature | ArcGIS Arcade | Esri Developer, 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 in Survey123 Mobile o nell'app da campo, è preferibile che l'app sia già installata sul dispositivo. Per ulteriori informazioni, vedere Installare ArcGIS 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-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&callback=https://quickcapture.arcgis.app?itemID=867895a71a1840399476fc717e76bb43Di seguito è riportato lo stesso URL con parametri codificati:
https://survey123-mobile.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.