Validateurs
Les validateurs sont des règles qui vérifient le contenu d'un attribut lors de sa saisie dans le système et refusent les données qui ne les respectent pas. Vous pouvez configurer des validateurs pour chaque champ d'attribut. Pour cela, ouvrez les paramètres du champ d'attribut et descendez jusqu'à la section "Validation rules".
Les validateurs disponibles peuvent varier selon le type de données.
Types de validateurs
Chaque type de données (s'ouvre dans un nouvel onglet) a ses propres validateurs. Vous trouverez ci-dessous tous les validateurs que vous pouvez rencontrer, tous types de données confondus.
Champ obligatoire (Required field)
Cette règle indique que le champ doit obligatoirement être rempli. Aucun paramètre supplémentaire.
Suppression des espaces autour des données entrantes (Trimming spaces around incoming data)
Cette règle supprime les espaces au début et à la fin de la chaîne. Aucun paramètre supplémentaire.
Vérification de la chaîne (Checking the string)
Cette règle permet de configurer les paramètres du type texte. Dans les paramètres supplémentaires, vous pouvez indiquer une longueur de chaîne fixe ou définir une plage avec une valeur minimale et une valeur maximale.
Vérification de l'URL (URL verification)
Cette règle n'accepte une valeur de chaîne que si c'est un lien. Aucun paramètre supplémentaire.
Vérification d'un nombre (Checking for a number)
Cette règle vérifie que la valeur est un nombre. Dans les paramètres supplémentaires, vous pouvez indiquer si le nombre doit être entier et définir ses valeurs minimale et maximale.
Arrondi d'un nombre (Rounding a number)
Cette règle ne vérifie pas que la valeur est de type numérique. Elle arrondit le nombre selon les règles définies dans les paramètres supplémentaires. Dans les paramètres supplémentaires, vous pouvez indiquer l'ordre et la règle d'arrondi.
Vérification de l'email (Email Verification)
Cette règle vérifie que la valeur est une adresse email valide. Aucun paramètre supplémentaire.
Valeur par défaut (Default value)
Cette règle attribue une valeur par défaut à l'attribut si aucune valeur n'a été saisie. Dans les paramètres supplémentaires, vous pouvez définir cette valeur par défaut.
Vérification par liste donnée (Given list screening)
Cette règle vérifie que la valeur saisie dans l'attribut correspond à l'une des valeurs de la liste du validateur. Dans les paramètres supplémentaires, vous pouvez saisir les valeurs séparées par des virgules et activer une négation logique.
Masque de champ (Field mask)
Cette règle vérifie que les données saisies correspondent au masque. Dans les paramètres supplémentaires, vous pouvez définir le masque à l'aide de caractères spéciaux.
Vérification par expression régulière (Regular expression validation)
Cette règle vérifie que les données saisies correspondent à une expression régulière. Dans les paramètres supplémentaires, vous pouvez définir l'expression régulière. Pour en savoir plus sur les expressions régulières, consultez "cette page".
Vous pouvez ajouter plusieurs validateurs à un même champ d'attribut, mais la validation par expression régulière n'est pas compatible avec les autres vérifications de valeur. Une fois l'expression régulière ajoutée, les validateurs suivants ne sont plus proposés : Checking the string, Checking for a number, Default value, Given list screening, Field mask, Comparison, Logical, Email Verification, URL verification, Rounding a number et Trimming spaces around incoming data.
Inversement, si le champ a déjà Trimming spaces around incoming data, l'expression régulière, Field mask et Given list screening (ainsi que Size et Checking files) ne sont pas proposés.
Comparaison (Comparison)
Cette règle compare la valeur de l'attribut indiqué à une autre valeur pour vérifier que leur rapport correspond à la comparaison définie dans la propriété. Dans les paramètres supplémentaires, vous pouvez indiquer le type et la valeur de comparaison, ainsi que l'opérateur de comparaison.
Logique (Logical)
Cette règle vérifie que la valeur de l'attribut est logique. Dans les paramètres supplémentaires, vous pouvez configurer l'interprétation des valeurs non booléennes.
Taille (Size)
Cette règle vérifie la taille de l'image. Dans les paramètres supplémentaires, vous pouvez définir la largeur maximale (Max X) et la hauteur maximale (Max Y) de l'image en pixels. La taille minimale ne se définit pas.
Vérification des fichiers (Checking files)
Cette règle vérifie que le fichier téléversé respecte les paramètres définis. Dans les paramètres supplémentaires, vous pouvez configurer le poids minimal et maximal du fichier, l'unité de mesure utilisée et la liste des extensions de fichier autorisées (Extensions).
Plage de dates et d'heures (Date and time range for restriction)
Cette règle limite les valeurs que l'on peut sélectionner dans l'attribut. Elle est disponible pour les types "Date and Time", "Date" et "Time". Dans les paramètres supplémentaires, définissez les bornes inférieure et supérieure dans les champs Minimum date and time value et Maximum date and time value. Le format de ces champs dépend du type d'attribut (date, heure ou date avec heure). Si la valeur sélectionnée sort de ces bornes, l'utilisateur voit un message d'erreur.
Erreurs personnalisées
Vous pouvez ajouter un texte d'erreur à chaque validateur. L'utilisateur voit ce texte lorsque le validateur refuse les données. Saisissez-le dans les paramètres du validateur, dans le champ Custom error : ce texte remplace le message d'erreur de validation standard.
Exemples
Exemple de validation d'un champ email
Dans cet exemple, on ajoute à la valeur de chaîne :
- la suppression des éventuels espaces au début et à la fin de la chaîne ;
- la vérification que la chaîne est une adresse email.
Exemple de validation d'un champ mot de passe
Dans cet exemple, on ajoute à la valeur de chaîne :
- la vérification de la longueur et de la composition de la chaîne à l'aide d'une expression régulière.
Exemple de validation d'un champ image
Dans cet exemple, on ajoute à la valeur de chaîne :
- la vérification des dimensions de l'image ;
- la vérification du poids de l'image ;
- une erreur personnalisée.