Fonction Validate

Article
10/16/2024

S’applique à : Applications canevas Applications pilotées par modèle

La fonction Validate vérifie si la valeur d’une colonne unique ou d’un enregistrement complet est valide pour une source de données.

Description

Avant qu’un utilisateur ne soumette une modification de données, vous pouvez fournir un retour immédiat sur la validité de cette soumission afin d’améliorer l’expérience utilisateur.

Les sources de données peuvent fournir des informations sur ce qui constitue des valeurs valides au sein d’un enregistrement. Ces informations peuvent comprendre plusieurs contraintes, spécifiant par exemple :

si une colonne requiert une valeur
la longueur maximale autorisée pour une chaîne de texte
les valeurs minimale et maximale autorisées pour un nombre
les valeurs minimale et maximale autorisées pour une date

La fonction Validate utilise ces informations pour déterminer si une valeur est valide et renvoyer un message d’erreur approprié si ce n’est pas le cas. Vous pouvez utiliser la fonction DataSourceInfo pour afficher les informations utilisées par la fonction Validate.

Les sources de données ne fournissent pas toutes la même quantité d’informations de validation et peuvent n’en fournir aucune. Validate ne peut vérifier que les valeurs basées sur ces informations. Même si la fonction Validate ne détecte aucun problème, l’application de la modification de données peut quand même échouer. Vous pouvez utiliser la fonction Errors pour obtenir des informations sur l’échec.

Si la fonction Validate détecte un problème, elle renvoie un message d’erreur que vous pouvez afficher pour l’utilisateur de l’application. Si toutes les valeurs sont valides, la fonction Validate renvoie la valeur blank. Lorsque vous travaillez avec une collection qui ne contient aucune information de validation, les valeurs sont toujours valides.

Syntaxe

Valider( DataSource, Colonne, Valeur )

DataSource – Obligatoire. Source de données à utiliser pour la validation.
Colonne – Obligatoire. Colonne à valider.
Valeur – Obligatoire. Valeur de la colonne sélectionnée à valider.

Valider( Source de données, Enregistrement d’origine, Mises à jour )

DataSource – Obligatoire. Source de données à utiliser pour la validation.
OriginalRecord - Obligatoire. Enregistrement pour lequel des modifications doivent être validées.
Mises à jour - Obligatoire. Modifications à appliquer à l’enregistrement d’origine.

Exemples

Pour ces exemples, les valeurs de la colonne Percentage de la source de données Scores doivent être comprises entre 0 et 100, ces deux valeurs incluses. Si les données sont validées, la fonction renvoie la valeur blank. Dans le cas contraire, la fonction renvoie un message d’erreur.