L'app Web Survey123 può accettare parametri nello stesso formato dell'app da campo. Una differenza da tenere in considerazione è che l'ID elemento del rilevamento fa parte del percorso URL, invece di un parametro URL come gli altri link usano per aprire i rilevamenti. Quando si aggiungono parametri a questo URL, è necessario utilizzare un punto di domanda per separare l'ID elemento del rilevamento dal primo parametro, poi utilizzare & per separare i successivi parametri. Il seguente esempio di URL trasferisce i parametri di cognome e coordinate a un rilevamento nell'applicazione Web Survey123:
https://survey123.arcgis.com/share/36ff9e8c13e042a58cfce4ad87f55d19?field:surname=Klauser¢er=37.8199,-122.4783L'app Web Survey123 supporta anche alcuni parametri non supportati dall’app di campo Survey123. Si tratta di parametri relativi alla presentazione del rilevamento in un browser. Fare riferimento alla seguente tabella per i parametri URL e gli esempi di personalizzazione dell'apertura dell'app Web.
Nota:
Se un valore del parametro include spazi, segni più (+) o altri caratteri speciali, questi caratteri devono essere codificati per percentuali. Per ulteriori informazioni, consultare Codifica URL.
Parametri URL per avviare l'app Web
| Parametro | Descrizione | Tipo |
|---|---|---|
signIn | Per i rilevamenti pubblici, mostra il pulsante di accesso o richiede agli utenti di accedere. Per impostazione predefinita, l'app Web non fornisce agli utenti un metodo per accedere per i rilevamenti pubblici, ma i rilevamenti pubblici possono includere funzioni utilizzabili solo quando gli utenti sono collegati. Un esempio è costituito dall'utilizzo di un calcolo per estrarre l'indirizzo e-mail di un utente. I valori validi sono show, che visualizza il pulsante di accesso nella barra di navigazione in alto nell'app Web, e require, che richiede ai membri di accedere reindirizzando alla pagina di accesso. Esempio: | Stringa |
isOrgSignIn | Utilizza la pagina di accesso specifica dell'organizzazione. Per impostazione predefinita, Survey123 utilizza la pagina di accesso specifica dell'organizzazione, ma quando si condividono rilevamenti con più di un'organizzazione, utilizzare la pagina di accesso di ArcGIS Online potrebbe essere preferibile. Impostare questo parametro su false per utilizzare la pagina di accesso di ArcGIS Online. Esempio: | Booleano |
center | Centra la mappa in base a latitudine, longitudine e altitudine note. Esempio: | Stringa |
field:fieldname | Popola le domande del rilevamento con i valori del campo. Esempio: | Stringa |
portalUrl | Specifica l'URL del portale in cui è ospitato l'elemento del rilevamento. Esempio: | Stringa |
| open | Consente di specificare l'app usata per aprire il rilevamento. I valori validi sono web, che apre il rilevamento nell'app Web (predefinito), native, che apre il rilevamento nell'app da campo, se installata, e menu, che apre una pagina Web per determinare l'app che aprirà il rilevamento. Esempio: | Stringa |
| hide |
Nasconde gli elementi del rilevamento nell’app Web. Questo parametro può accettare più valori separati da una virgola. I valori validi sono navbar (la barra nella parte superiore del rilevamento, incluse le opzioni di accesso, scollegamento e cambio della lingua), header, description, footer, submit, theme, e leaveDialog (il messaggio di avvertenza che appare quando si abbandona o si chiude la pagina). È anche possibile usare il parametro field:fieldName per nascondere una domanda, un gruppo, una pagina o una ripetizione specifici fornendo il loro nome al posto di fieldName. Le domande contenenti ripetizioni non possono essere nascoste individualmente. Esempio: | Stringa |
| locale | Consente di cambiare la lingua del rilevamento. Funziona solo se il rilevamento comprende più lingue. Esempio: | Stringa |
| mode | Imposta la modalità dell'app Web. I valori validi sono edit, che imposta il rilevamento per modificare una voce esistente invece che crearne una, view, che apre una voce esistente in modalità di sola lettura, e copy, che crea un rilevamento popolato con i contenuti di una specifica voce. Quando si utilizza questo parametro, deve essere fornito anche il parametro globalId. Esempio: | Stringa |
| globalId | Specifica il record di rilevamento caricato nel modulo. I valori validi sono gli ID globali del record del rilevamento esistente. Il nome di questo parametro rileva la distinzione tra maiuscole e minuscole. Esempio: | Stringa |
recalculate | Può essere utilizzato solamente con mode=edit. Questo obbliga le domande specificate a essere ricalcolate mentre il rilevamento è in caricamento, senza l'utilizzo del pulsante Ricalcola. Esempio: | Stringa |
| version | Imposta la versione dell'applicazione Web da utilizzare. L'unico valore valido è latest, che utilizza la versione più recente dell'app Web, anche se il rilevamento presenta una versione bloccata. Esempio: | Stringa |
| token | Trasferisce un token valido per un rilevamento. Può essere utilizzato per consentire ai partecipanti di rispondere a un rilevamento che richiede l'accesso a un account ArcGIS senza eseguire il log in. Esempio: | Stringa |
autoReload | Ricarica il rilevamento dopo l'invio. Specificare il ritardo (in secondi) prima che il rilevamento venga aggiornato. Precedentemente chiamato autoRefresh. Il parametro autoRefresh è supportato per la compatibilità con le versioni precedenti. Esempio: | Intero |
| encodeUrlParams | Oscura i parametri URL. L'URL risultante includerà invece un parametro code che rappresenta tutti i parametri codificati; i parametri inclusi fuori dal parametro code saranno ignorati. Esempio: | Booleano |
width | Imposta la larghezza del rilevamento in pixel o come frazione della larghezza dello schermo. Un valore maggiore di 1 imposta la larghezza in pixel. Se il valore in pixel è minore della larghezza dello schermo, viene usata la larghezza dello schermo. Un valore compreso tra 0 e 1 imposta la larghezza del modulo come frazione della larghezza dello schermo. Tale valore influisce anche su altri controlli del rilevamento, ad esempio le caselle di testo, e può contribuire a migliorare la visualizzazione dell'app Web come griglia fissa o dinamica. Esempi: | Stringa |
Nota:
Il parametro field:fieldname nell'app Web supporta domande geopoint, geotrace e geoshape. Per le domande geopoint, specificare latitudine, longitudine e altitudine (opzionale) separandole con spazi. Per geotrace e geoshape, per ogni vertice specificare la latitudine e la longitudine separandole con uno spazio, con ogni paio di coordinate separate da un punto e virgola. Questo esempio funzionerebbe per una domanda di tipo geoshape:
field:geoshape=-37.842156723211474 144.95942945338243;-37.83554486071995 144.9726235713864;-37.85681405373047 144.98240735651922;-37.85954045531896 144.97715349053766