Regole di convalida › Implementazione delle regole di convalida personalizzate › Implementazione di JavaScript › Interfaccia di JavaScript per la convalida a livello di attività

Interfaccia di JavaScript per la convalida a livello di attività

La definizione dell'interfaccia di JavaScript per la convalida a livello di attività è la seguente:

Sintassi

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

Parametri

context

Parametro di input

Specifica un oggetto contenente i metodi per recuperare le informazioni nella sessione di attività corrente.

attributeValue

Parametro di input

Specifica il valore dell'attributo che viene convalidato.

changedValue

Parametro di output

Fornisce un valore di trasformazione facoltativo che sostituisce il valore fornito dall'utente in fase di convalida. Se non è necessaria alcuna trasformazione, restituire null.

errorMessage

Parametro di output

Se la convalida non riesce, visualizza un messaggio all'utente.

Il messaggio viene visualizzato attraverso AttributeValidationException. Se il metodo restituisce false, CA Identity Manager genera questa eccezione.

Commenti

I parametri di output changedValue ed errorMessage sono di tipo di dati StringRef. StringRef è un tipo di dati predefinito che contiene il riferimento al campo a cui si assegna un valore, così come illustrato nei seguenti esempi:

• Aggiungere un prefisso 1 per un numero di telefono formattato correttamente:

  changedValue.reference="+1 " + phoneNumber;
  

• Fornisce un messaggio di errore per un numero di telefono non correttamente formattato:

  errorMessage.reference="Phone number " + phoneNumber + 
              " non corrisponde al formato nnn-nnn-nnnn.";
  

Restituisce

• True. L'implementazione considera valido il valore in attributeValue o restituisce un valore trasformato in changedValue.
• False. L'implementazione considera attributeValue non valido. CA Identity Manager genera un AttributeValidationException che include errorMessage.

Interfaccia di JavaScript per la convalida a livello di directory

La definizione dell'interfaccia di JavaScript per la convalida a livello di directory è la seguente:

Sintassi

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

Parametri

attributeValue

Parametro di input

Specifica il valore dell'attributo che viene convalidato.

changedValue

Parametro di output

Fornisce un valore di trasformazione facoltativo che sostituisce il valore fornito dall'utente in fase di convalida. Se non è necessaria alcuna trasformazione, restituire null.

errorMessage

Parametro di output

Se la convalida non riesce, visualizza un messaggio all'utente.

Il messaggio viene visualizzato attraverso AttributeValidationException. Se il metodo restituisce false, CA Identity Manager genera questa eccezione.

Commenti

I parametri di output changedValue ed errorMessage sono di tipo di dati StringRef. StringRef è un tipo di dati predefinito che contiene il riferimento al campo a cui si assegna un valore, così come illustrato nei seguenti esempi:

• Aggiungere un prefisso 1 per un numero di telefono formattato correttamente:

  changedValue.reference="+1 " + phoneNumber;
  

• Fornisce un messaggio di errore per un numero di telefono non correttamente formattato:

  errorMessage.reference="Phone number " + phoneNumber + 
               " non corrisponde al formato nnn-nnn-nnnn.";
  

Restituisce

• True: l'implementazione considera valido il valore in attributeValue o restituisce un valore trasformato in changedValue.
• False: l'implementazione considera attributeValue non valido. CA Identity Manager genera un AttributeValidationException che include errorMessage.