Le composant multi-liste, disponible dans le Studio de Modèle de Formulaire, affiche plusieurs listes déroulantes qui se filtrent en fonction de la valeur choisi dans la liste précédente suivant une hiérarchie définie dans le fichier d'import.
Ce fichier doit être au format .csv et doit respecter certaines spécifications.
Spécifications du fichier à importer
Le fichier à importer pour générer une multi-liste doit respecter :
- Format .csv
- Encodage UTF-8
- Séparateur au choix - mais ";" conseillé
- La première colonne doit obligatoirement s'intituler "Value"
- Respectant la structure suivante :
Value | Titre de la 1ère liste déroulante | Titre de la 2ème liste déroulante | Titre de la 3ème liste déroulante |
Option1|Option1.1|Option1.1.1 | Option1 | Option1.1 | Option1.1.1 |
Option1|Option1.1|Option1.1.2 | Option1 | Option1.1 | Option1.1.2 |
Option1|Option1.2|Option1.2.1 | Option1 | Option1.2 | Option1.2.1 |
Option1|Option1.2|Option1.2.2 | Option1 | Option1.2 | Option1.2.2 |
Option2|Option2.1|Option2.1.1 | Option2 | Option2.1 | Option2.1.1 |
La colonne Value doit contenir une valeur unique. Dans l'exemple, il est proposé une concaténation des valeurs en colonne avec un séparateur de type |. Il est tout à fait possible de mettre un identifiant différent.
Fichier valide
Exemple de fichier valide
L'affichage en cas de fichier validé
- Dans la carte "Propriétés spécifiques" :
- En bas de la page :
Les erreurs
L'affichage en cas d'erreur
- Dans la carte "Propriétés spécifiques" dans le cas d'un premier import :
- Dans la carte "Propriétés spécifiques" dans le cas d'un import alors qu'un fichier est déjà pris en compte :
- En bas de page :
Liste des erreurs connues
- Un guillemet n'est pas doublé
- Erreur critique lorsqu'un guillemet n'est pas doublé (ouvrant sans fermant, ou fermant sans ouvrant)
En effet, si le guillemet est seul, il sera considéré comme un séparateur, ce qui cassera la structure du fichier. Si des guillemets sont placées en double (un ouvrant et un fermant) alors il sera inclus en une valeur, et l'import se fera correctement. MissingQuotes
- Erreur critique lorsqu'un guillemet n'est pas doublé (ouvrant sans fermant, ou fermant sans ouvrant)
- Séparateur absent ou non-reconnu
- Des caractères utilisés habituellement comme des éléments textuels ne seront jamais considérés comme séparateurs (comme un point, ".", ou un tiret "-")
UndetectableDelimiter
- Colonne "Value" manquante
- Sans colonne "Value", aucune valeur technique ne peut être récupérée. Or, c'est un champ obligatoire.
ValueColumnError
- Aucune colonne autre que "Value" n'est présente
- Chaque colonne en plus de "Value" représente une liste déroulante. En avoir au moins une est obligatoire.
EmptyPickerColumnError
- Séparateur(s) manquant(s)
- Un séparateur manquant fait que la longueur d'une combinaison ne coïncide pas avec le nombre de listes, aboutissant donc en une incohérence.
RowsLengthError