Règles de validation › Implémentation des règles de validation personnalisées › Implémentation à l'aide de JavaScript › Interface JavaScript pour la validation de niveau tâche

Interface JavaScript pour la validation de niveau tâche

La définition de l'interface JavaScript pour la validation de niveau tâche est la suivante :

Syntaxe

public boolean validate(
   BLTHContext context,
   String attributeValue,
   StringRef changedValue,
   StringRef errorMessage
   );

Paramètres

context

Paramètre d'entrée

Spécifie un objet qui contient des méthodes pour récupérer des informations dans la session de tâche actuelle.

attributeValue

Paramètre d'entrée

Spécifie la valeur de l'attribut en cours de validation.

changedValue

Paramètre de sortie

Fournit une valeur de transformation facultative qui remplace la valeur fournie par l'utilisateur en cours de validation. Si aucune transformation n'est nécessaire, la valeur renvoyée est nulle.

errorMessage

Paramètre de sortie

Si un échec de la validation se produit, un message s'affiche.

Le message est affiché via AttributeValidationException. Si la méthode renvoie la valeur False, CA IdentityMinder génère une exception.

Commentaires

Les paramètres de sortie changedValue et errorMessage sont du type de données StringRef. StringRef est un type de données prédéfini qui contient la référence de champ à laquelle vous affectez une valeur, comme dans les exemples suivants :

• Ajout du préfixe 1 au numéro de téléphone correctement formaté :

  changedValue.reference="+1 " + phoneNumber;
  

• Définition d'un message d'erreur pour un numéro formaté de façon incorrecte :

  errorMessage.reference="Phone number " + phoneNumber + 
              " Ne correspond pas au format nnn-nnn-nnnn.";
  

Renvoie :

• True L'implémentation considère la valeur d'attributeValue valide ou renvoie une valeur transformée dans changedValue.
• False L'implémentation considère attributeValue comme non valide. CA IdentityMinder génère une exception AttributeValidationException qui inclut errorMessage.