È possibile creare collegamenti per aprire Survey123 Mobile 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 Survey123 Mobile 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 Survey123 Mobile 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-mobile:// con https://survey123-mobile.arcgis.app come collegamento Survey123 da utilizzare su iOS o Android.
Per creare uno schema URL personalizzato e utilizzarlo in un browser Web desktop, completare i seguenti passaggi:
- Digitare arcgis-survey123-mobile:// nel browser.
Survey123 Mobile si apre (o viene richiesto di aprirlo).
Nota:
Per avviare e scaricare un sondaggio da un portale specifico, includere il parametro URL del portale, ad esempio arcgis-survey123-mobile://?portalUrl=host.domain.com/webadaptor (in cui host, domain e webadaptor sono sostituiti dalle informazioni del portale).
- Aggiungere un riferimento univoco a un rilevamento e aggiungerlo all'URL eseguendo le seguenti operazioni:
- 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.
- 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-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19Se si esegue il test dell'URL, deve aprire Survey123 Mobile e aprire immediatamente il sondaggio.
Nota:
Se non è già presente sul dispositivo, il rilevamento viene scaricato su di esso.
- Identificare l'ID elemento del rilevamento che si desidera aprire.
- 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 Surname, 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-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=KlauserÈ quindi possibile usare l'URL per aprire Survey123 Mobile e il sondaggio 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.
- Definire una posizione per una domanda geopoint nel rilevamento aggiungendo coordinate all'URL come segue:
- Digitare ¢er= 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-mobile://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser¢er=37.8199,-122.4783,20Questo URL aprirà Survey123 Mobile e il sondaggio 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 Mobile 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 Mobile con il valore dell'attributo di una feature anziché con un valore definito, indicando il nome dell'attributo tra parentesi graffe.
- Aprire la mappa web, selezionare Popup per uno dei layer, scegliere Aggiungi contenuto, selezionare Testo, fornire il testo da mostrare per il link e fare clic sul pulsante Link per immettere il valore URL link.
Collegare da un'altra app su iOS o Android
È possibile creare un collegamento da utilizzare in applicazioni ArcGIS per aprire Survey123 Mobile 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.
- Aprire una mappa web che verrà visualizzata sul dispositivo e selezionare Popup per uno dei layer.
- Scegliere Aggiungi contenuto e selezionare Testo.
- Digitare Avvia Survey123, evidenziare questo testo, fare clic sul pulsante Link per inserire l'URL del collegamento, digitare https://survey123-mobile.arcgis.app, fare clic su OK ed eseguire ciò che segue
- Aprire la mappa web su un dispositivo mobile tramite browser o un'app ArcGIS.
- Selezionare una feature e fare clic sul collegamento Avvia Survey123 nel popup per aprire Survey123.
- 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-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19Se si esegue il test dell'URL, esso deve aprire Survey123 Mobile e aprire immediatamente il sondaggio.
Nota:
Se non è già presente sul dispositivo, il rilevamento viene scaricato su di esso.
- 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 Surname, 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-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=KlauserÈ quindi possibile usare l'URL per aprire Survey123 Mobile e il sondaggio 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.
- Definire una posizione per una domanda geopoint nel rilevamento aggiungendo coordinate all'URL come segue:
- Digitare ¢er= 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-mobile.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser¢er=37.8199,-122.4783,20L'URL completo ora aprirà Survey123 Mobile e il sondaggio scelto, compilerà una domanda di testo e fornirà una nuova posizione predefinita per la domanda geopoint.
Parametri URL per avviare Survey123 Mobile
I seguenti parametri possono essere utilizzati per personalizzare l'apertura DI Survey123 Mobile:
| Parametro | Descrizione | Tipo |
|---|---|---|
center | Centra la mappa in base ai valori di latitudine, longitudine e altitudine note. Esempio: | Stringa |
field:fieldname | Popola le domande del rilevamento con i valori del campo. Esempio: | Stringa |
portalUrl | L'URL del portale in cui è ospitato l'elemento del rilevamento. Esempio: | Stringa |
itemID | Il modulo da aprire Esempio: | UUID |
download | Scarica automaticamente il rilevamento quando il dispositivo è online. L'impostazione predefinita è true. Esempio: | Booleano |
callback | L'URL a cui tornare quando un'azione del modulo (per esempio inviare, passare a bozze, annullare o uscire) è completata. Esempio: | URL |
callback:status | Esempio: | Stringa |