Guide d'utilisation Annuler

Préremplissage des valeurs des champs de formulaire web avec les paramètres d’URL

 

Guide Adobe Acrobat Sign

Nouveautés

Commencer

Administration

Envoi, signature et gestion des accords

Fonctionnalités et workflows d’accord avancés

Intégration à d’autres produits

Développeur Acrobat Sign

Assistance et dépannage

Utilisation des paramètres d’URL pour remplir les champs d’un formulaire web

Deux étapes sont nécessaires pour insérer des valeurs dans un champ de formulaire web :

  • Marquage d’un champ comme disponible pour les paramètres d’URL
  • Construction des paramètres d’URL à insérer

 

Marquage d’un champ comme disponible pour les paramètres d’URL

  1. Créez ou modifiez un formulaire web pour accéder aux champs.

  2. Ajoutez un champ de texte à renseigner par l’URL.

    •  Seuls les champs Texte acceptent des valeurs.
  3. Ouvrez les propriétés du champ en double-cliquant sur ce dernier.

  4. Modifiez le nom du champ pour qu’il soit significatif. Le nom du champ correspond à la première partie du paramètre que vous utiliserez. Par conséquent, évitez qu’il ne soit trop long.

  5. Cochez la case La valeur par défaut peut provenir de l’URL.

    • Éventuellement, cochez la case Lecture seule si la valeur ne doit pas être modifiable.
  6. Cliquez sur OK pour enregistrer les paramètres.

  7. Répétez cette procédure pour tous les champs qui devront accepter un paramètre de l’URL.

  8. Cliquez sur Enregistrer pour enregistrer le formulaire web.

URL

Dans cet exemple, nous créons deux champs qui seront renseignés par l’URL :

  • Branch_Office : champ où sera insérée la chaîne de la succursale (illustrée ci-dessus).
  • Emp_ID : champ dans lequel sera inséré le matricule de l’employé.

 

Construction des paramètres d’URL à insérer

  1. Copiez l’URL du formulaire web. La façon la plus simple consiste à procéder comme suit :

    • Modifiez le formulaire web à partir de la page Gérer.
    • Cliquez sur le lien Copier l’URL du formulaire web.
    URL

    Les URL de formulaires web sont très longues. Nous utilisons donc une URL abrégée ici pour l’exemple (la vôtre sera différente) :

    Exemple d’URL :

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

  2. Collez l’URL du formulaire web dans un éditeur de texte (tel que le Bloc-notes).

  3. Ajoutez vos paramètres.

    • Le début des paramètres est identifié en ajoutant un symbole de hachage (dièse, #) à la fin de l’URL du formulaire web.
    • Ajoutez ensuite les paramètres au format {nom_champ}={valeur}.

    Exemple d’URL avec un paramètre :

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

    • Plusieurs valeurs sont ajoutées en insérant une esperluette (&) entre les valeurs de champs.

    Exemple d’URL avec deux paramètres :

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

  4. Une fois que toutes les paires champ=valeur sont ajoutées à l’URL, copiez la chaîne complète et collez-la dans le navigateur.

    Le formulaire web sera rendu avec les champs renseignés :

    URL  paramètres d’un formulaire web

Propriétés et limites

  • Vous pouvez utiliser le caractère de hachage une seule fois pour définir le début des paramètres.
    • Le fait d’utiliser un autre caractère de hachage dans une valeur ne nuit pas au résultat.
  • Il est possible d’utiliser des espaces dans les valeurs.
  • Il est possible d’utiliser des espaces dans le nom de champ uniquement si vous les insérez explicitement (%20) dans l’URL.
    • Ceci fonctionnera : https://secure.na1.adobesign.com/public/esignWidget?wid=CBF2s*#Branch%20Office=San Jose #621
    • Ceci ne fonctionnera pas : https://secure.na1.adobesign.com/public/esignWidget?wid=CBF2s*#Branch Office=San Jose #621
    • Il est généralement recommandé d’utiliser des caractères de soulignement plutôt que des espaces dans les noms de champ.  Au final, vous gagnerez du temps.
  • Vous ne pouvez pas ajouter d’espace entre le nom du champ, le signe égal (=) et le début de la valeur (nom_champ=valeur).
  • Vous ne pouvez pas ajouter d’espace avant et après l’esperluette s’il y a plusieurs valeurs.
  • Il n’existe aucune limite (à l’exception peut-être des limites de longueur d’URL) quant au nombre de champs qui peuvent obtenir leur valeur depuis les paramètres d’URL.
  • Les champs de texte calculés ne peuvent pas être remplacés ; aucune case à cocher n’est associée à leurs propriétés.
  • Les paramètres d’URL ne fonctionnent pas avec les formulaires web authentifiés. En raison de l’utilisation de fragments de hachage d’URL, si un formulaire web est protégé par un mot de passe ou une autre authentification, les paramètres d’URL ne sont pas retransmis au client une fois l’authentification terminée (le serveur ne voit jamais cette partie de l’URL).

 

Gestion des erreurs

  • Tout paramètre d’URL qui ne correspond pas exactement à un nom de champ de formulaire est ignoré.
  • Un paramètre d’URL qui tente d’affecter une valeur à un champ autre qu’un champ de texte ou à un champ de texte pour lequel l’option La valeur par défaut peut provenir de l’URL n’est pas activée est ignoré.