Reglas de validación › Cómo implementar reglas de validación personalizadas › Implementación de JavaScript › Interfaz de JavaScript para la validación a nivel de tarea

Interfaz de JavaScript para la validación a nivel de tarea

La definición de la interfaz de JavaScript para la validación a nivel de tarea es la siguiente:

Sintaxis

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

Parámetros

context

Parámetro de entrada

Especifica un objeto que contiene métodos para recuperar información en la sesión de tarea actual.

attributeValue

Parámetro de entrada

Especifica el valor del atributo que se valida.

changedValue

Parámetro de salida

Proporciona un valor de transformación opcional que reemplaza el valor proporcionado por el usuario que se valida. Si no hay ninguna transformación necesaria, se transfiere de vuelta nulo.

errorMessage

Parámetro de salida

Si la validación produce un error, muestra un mensaje al usuario.

El mensaje se muestra mediante AttributeValidationException. Si el método devuelve el valor false, CA Identity Manager genera esta excepción.

Comentarios

Los parámetros de salida changedValue y errorMessage son del tipo de datos StringRef. StringRef es un tipo de datos predefinido que contiene el campo reference, al que se asigna un valor, como se muestra en los siguientes ejemplos:

• Agregar el prefijo 1 a un número de teléfono con el formato correcto:

  changedValue.reference="+1 " + phoneNumber;
  

• Proporcionar un mensaje de error para un número con un formato incorrecto:

  errorMessage.reference="Phone number " + phoneNumber + 
              " does not match the format nnn-nnn-nnnn.";
  

Devuelve

• True. La implementación considera como válido el valor de attributeValue o lo transfiere de vuelta a un valor transformado en changedValue.
• False. La implementación considera como no válido attributeValue. CA Identity Manager genera AttributeValidationException que incluye errorMessage.

Interfaz de JavaScript para la validación a nivel de directorio

La definición de la interfaz de JavaScript para la validación a nivel de directorio es la siguiente:

Sintaxis

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

Parámetros

attributeValue

Parámetro de entrada

Especifica el valor del atributo que se valida.

changedValue

Parámetro de salida

Proporciona un valor de transformación opcional que reemplaza el valor proporcionado por el usuario que se valida. Si no hay ninguna transformación necesaria, se transfiere de vuelta nulo.

errorMessage

Parámetro de salida

Si la validación produce un error, muestra un mensaje al usuario.

El mensaje se muestra mediante AttributeValidationException. Si el método devuelve el valor false, CA Identity Manager genera esta excepción.

Comentarios

Los parámetros de salida changedValue y errorMessage son del tipo de datos StringRef. StringRef es un tipo de datos predefinido que contiene el campo reference, al que se asigna un valor, como se muestra en los siguientes ejemplos:

• Agregar el prefijo 1 a un número de teléfono con el formato correcto:

  changedValue.reference="+1 " + phoneNumber;
  

• Proporcionar un mensaje de error para un número con un formato incorrecto:

  errorMessage.reference="Phone number " + phoneNumber + 
               " does not match the format nnn-nnn-nnnn.";
  

Devuelve

• True. La implementación considera como válido el valor de attributeValue o lo transfiere de vuelta a un valor transformado en changedValue.
• False. La implementación considera como no válido attributeValue. CA Identity Manager genera AttributeValidationException que incluye errorMessage.