Validate Fonction

S’applique à : Applications canevas basées sur des modèles

La Validate fonction vérifie si la valeur d’une seule colonne 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 Validate fonction utilise ces informations pour déterminer si une valeur est valide et retourner un message d’erreur approprié si ce n’est pas le cas. Vous pouvez utiliser la fonction DataSourceInfo pour afficher les mêmes informations que celles utilisées 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 peut uniquement vérifier les valeurs en fonction de ces informations. Même s’il Validate ne trouve pas de problème, l’application de la modification des données peut toujours échouer. Vous pouvez utiliser la fonction Errors pour obtenir des informations sur l’échec.

Si Validate un problème se produit, la fonction retourne un message d’erreur que vous pouvez afficher à l’utilisateur de l’application. Si toutes les valeurs sont valides, Validate retourne vide. Lorsque vous travaillez avec une collection qui ne contient aucune information de validation, les valeurs sont toujours valides.

Syntaxe

Validate( DataSource, Column, Value )

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

Validate( DataSource, OriginalRecord, Updates )

• 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.

Validate avec une seule colonne

Validate avec un enregistrement complet