Utiliser l’autocomplétion (pour un champ liste)
L'aide à la saisie (autocomplétion) permet de voir la liste des éléments sélectionnables s'affiner au fur et à mesure que l'on tape des caractères au clavier. L'aide à la saisie se base sur un référentiel de données.
Référentiel de données
Un webservice externe ou une source de données interne peuvent servir de référentiel de données :
Voir :
Création du champ de formulaire
Supposons que notre formulaire appelle un champ « Adresse » associé à un référenciel nommé « Ma Ville » :
L'aide à la saisie se paramètre sur un champ de type liste et liste à choix multiple.
Dans la fabrique de formulaire, sur le formulaire de votre choix, créer un champ de type liste, puis renseigner :
- adresse dans le champ identifiant
- autocomplétion dans le champ mode d'affichage
- sélectionner Ma Ville dans le champ source de données
Essayez maintenant de remplir une demande correspondant à ce formulaire, vous constaterez que l'aide à la saisie fonctionne sur le champ adresse.
Exploitation des données
Supposons qu'un usager ait rempli ce formulaire, et qu'il ait choisi la première l'entrée suivante dans le référentiel :
| 1 | Rue de Lutèce | 75001 | Paris |
Voici les variables qui seront associées à cette demande :
- form_var_adresse qui prendra la valeur Rue de Lutèce
- form_var_adresse_raw qui prendra la valeur 1
- form_var_adresse_code_postal qui prendra la valeur 75001
- form_var_adresse_ville qui prendra la valeur Paris
Dans cette convention de nommage des variables, adresse vient de l'identifiant du champ liste. Une fois qu'un champ permettant de récupérer la liste existe (le champ dont l'identifiant est form_var_adresse ici), les autres colonnes peuvent donc être récupérée en ajoutant _clé_de_la_colonne, par exemple form_var_adresse_ville.