Guida utente Annulla

Precompilare i valori dei campi del modulo web utilizzando i parametri URL

Guida di Adobe Acrobat Sign

Novità

Introduzione

Amministrazione

Inviare, firmare e gestire gli accordi

Funzionalità e flussi di lavoro avanzati per gli accordi

Integrazione con altri prodotti

Acrobat Sign per sviluppatori

Supporto e risoluzione dei problemi

Per compilare i campi dei moduli Web, utilizza i parametri URL

Per inserire dei valori in un campo del modulo Web, è importante conoscere due aspetti:

  • Contrassegnare un campo in modo da renderlo disponibile per i parametri URL
  • Creare i parametri URL da inserire

 

Contrassegnare un campo in modo da renderlo disponibile per i parametri URL

  1. Crea o modifica un modulo Web per accedere ai campi.

  2. Aggiungi il campo di testo da compilare tramite l’URL.

    •  I valori possono essere accettati solo da campi di testo.
  3. Fai doppio clic per aprire le proprietà del campo.

  4. Modifica il nome del campo in modo da renderlo comprensibile. Il nome del campo è la prima parte del parametro che verrà utilizzato, quindi è bene scegliere un nome breve.

  5. Seleziona la casella di controllo dell’opzione Il valore predefinito potrebbe provenire dall’URL

    • Facoltativamente, seleziona Sola lettura per impedire che il valore possa essere modificato.
  6. Fai clic su OK per salvare i parametri

  7. Ripeti questa operazione per tutti i campi che dovranno accettare un parametro dall’URL.

  8. Fai clic su Salva per salvare il modulo Web

URL

In questo esempio vengono creati due campi che saranno compilati dall’URL:

  • Branch_Office: campo che accetta la stringa relativa alla filiale (vedi sopra)
  • Emp_ID: campo che accetta il codice ID del dipendente

 

Creare i parametri URL da inserire

  1. Copia l’URL dal modulo Web. Il modo più facile per effettuare tale operazione è il seguente:

    • Modifica il modulo Web dalla pagina Gestisci
    • Fai clic sul collegamento Copia URL modulo Web
    URL

    Gli URL dei moduli Web sono molto lunghi. Per praticità, in questo esempio ne abbiamo usato uno abbreviato (il tuo URL si presenterà diversamente):

    URL di esempio:

    https://secure.na1.adobesign.com/public/esignWidget?wid=CBF2s*

  2. Incolla l’URL del modulo Web in un editor di testo (ad esempio, in Blocco note).

  3. Aggiungi i parametri.  

    • L’inizio dei parametri è identificato dal carattere cancelletto (#) aggiunto alla fine dell’URL del modulo Web.
    • Quindi aggiungi i parametri nel formato {field_name}={value} 

    URL di esempio con un parametro

    https://secure.na1.adobesign.com/public/esignWidget?wid=CBF2s*#Branch_Office=San Jose #621

    • Per aggiungere più valori, inserisci il carattere della e commerciale (&) tra i valori del campo.

    URL di esempio con due parametri

    https://secure.na1.adobesign.com/public/esignWidget?wid=CBF2s*#Branch_Office=San Jose #621&Emp_ID=429939

  4. Una volta aggiunte all’URL tutte le coppie campo=valore, copia la stringa completa e incollala nel browser.

    Il modulo Web viene riprodotto con i campi compilati:

    URL parametri di un modulo Web

Proprietà e limitazioni

  • Il carattere cancelletto viene utilizzato una sola volta per definire l’inizio dei parametri.
    • L’eventuale utilizzo di un ulteriore cancelletto all’interno di un valore non influisce negativamente sul risultato.
  • L’utilizzo di spazi nei valori è accettabile.
  • L’utilizzo di spazi nel nome del campo è accettabile solo se nell’URL viene inserito esplicitamente %20 come carattere per lo spazio
    • Esempio di un URL funzionante: https://secure.na1.adobesign.com/public/esignWidget?wid=CBF2s*#Branch%20Office=San Jose #621
    • Esempio di un URL non funzionante: https://secure.na1.adobesign.com/public/esignWidget?wid=CBF2s*#Branch Office=San Jose #621
    • In genere nei nomi dei campi è consigliabile utilizzare un trattino basso (_) invece di uno spazio. Adotta questa prassi per risparmiare tempo.
  • Non è consentito alcuno spazio tra il nome del campo, il segno uguale e l’inizio del valore (Nome_campo=Valore)
  • Se usi più valori, non inserire alcuno spazio prima e dopo il carattere della e commerciale.
  • Non esiste alcun limite (eccetto forse i limiti di lunghezza dell’URL) al numero di campi che possono ottenere un valore dai parametri URL.
  • I campi di testo calcolati non possono essere sovrascritti e non dispongono della casella di controllo nelle proprietà del campo.
  • I parametri URL non funzionano con i moduli Web autenticati. A causa dell’uso dei frammenti hash per URL, se un modulo Web è protetto da password o altra forma di autenticazione, i parametri URL non vengono trasmessi al client una volta completata l’autenticazione (il server non vede mai quella parte dell’URL). 

 

Gestione degli errori

  • Eventuali parametri URL che non corrispondono esattamente al nome di un campo vengono ignorati.
  • Verranno ignorati eventuali parametri URL che tentano di assegnare un valore a un campo che non è un campo di testo oppure a un campo di testo per il quale non è stata attivata l’opzione Il valore predefinito potrebbe provenire dall’URL.