Regras de validação › Como implementar regras de validação personalizadas › Implementação de JavaScript › Interface JavaScript para validação em nível de tarefa

Interface JavaScript para validação em nível de tarefa

A definição da interface JavaScript para validação em nível de tarefa é a seguinte:

Sintaxe

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

Parâmetros

context

Parâmetro de entrada

Especifica um objeto que contém métodos para recuperar as informações da sessão de tarefas atual.

attributeValue

Parâmetro de entrada

Especifica o valor do atributo que está sendo validado.

changedValue

Parâmetro de saída

Fornece um valor de transformação opcional que substitui o valor fornecido pelo usuário que está sendo validado. Se nenhuma transformação for necessária, null será retornado.

errorMessage

Parâmetro de saída

Se a validação falhar, uma mensagem será exibida ao usuário.

A mensagem é exibida por meio de AttributeValidationException. Se o método retornar false, o CA IdentityMinder irá gerar essa exceção.

Comentários

Os parâmetros de saída changedValue e errorMessage são do tipo de dados StringRef. StringRef é um tipo de dados predefinido que contém a referência de campo para o qual você deseja atribuir um valor, como mostrado nos exemplos a seguir:

• Adicione um prefixo 1 para um número de telefone formatado corretamente:

  changedValue.reference="+1 " + phoneNumber;
  

• Forneça uma mensagem de erro para um número formatado incorretamente:

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

Retornos

• True. A implementação leva em conta o valor em attributeValue a ser validado ou transmite de volta um valor transformado em changedValue.
• False. A implementação considera attributeValue como inválido. O CA IdentityMinder gera um AttributeValidationException que inclui errorMessage.