Validierungsregeln › Implementieren von benutzerdefinierten Validierungsregeln › JavaScript-Implementierung › JavaScript-Schnittstelle für Validierung auf Aufgabenebene

JavaScript-Schnittstelle für Validierung auf Aufgabenebene

Die Definition der JavaScript-Schnittstelle für die Validierung auf Aufgabenebene lautet wie folgt:

Syntax

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

Parameter

Kontext

Eingabeparameter

Gibt ein Objekt an, das in der aktuellen Aufgabensitzung Methoden zum Abrufen von Informationen enthält.

attributeValue

Eingabeparameter

Gibt den Wert des Attributs an, das validiert wird.

changedValue

Ausgabeparameter

Gibt einen optionalen Transformationswert an, der den vom Benutzer bereitgestellten Wert ersetzt, welcher validiert wird. Wenn keine Transformation notwendig ist, geben Sie den Wert "Null" zurück.

errorMessage

Ausgabeparameter

Wenn die Validierung fehlschlägt, wird eine Meldung für den Benutzer angezeigt.

Die Meldung wird über AttributeValidationException angezeigt. Wenn die Methode einen falschen Wert zurückgibt, generiert CA IdentityMinder diese  Ausnahme.

Kommentare

Die Ausgabeparameter changedValue und errorMessage weisen den Datentyp "StringRef" auf. "StringRef" ist ein vordefinierter Datentyp, der die Feldreferenz enthält, der Sie einen Wert zuweisen, wie in den folgenden Beispielen dargestellt:

• Fügen Sie ein "1 Präfix" für eine angemessen formatierte Telefonnummer hinzu:

  changedValue.reference="+1 " + phoneNumber;
  

• Geben Sie eine Fehlermeldung für eine unzureichend formatierte Zahl an:

  errorMessage.reference="Phone number " + phoneNumber + 
              " stimmt nicht mit Format "nnn-nnn-nnnn" überein.";
  

Gibt zurück

• Wahr. Die Implementierung betrachtet den Wert in attributeValue als gültig, oder sie gibt einen transformierten Wert in changedValue zurück.
• Falsch. Die Implementierung betrachtet attributeValue als ungültig. CA IdentityMinder generiert eine "AttributeValidationException", die eine "errorMessage" beinhaltet.