Validando entrada de campo em cenários complexos

Crie regras de validação para verificar se os valores dos dados que os usuários inserem atendem aos critérios especificados e se o sistema consegue processar as informações corretamente.

Embora a validação de etapa seja compatível com comparações relativamente simples, as regras de validação ajudam você a criar operações mais complexas que incluem funções e processamento condicional. Por exemplo, uma solicitação de empréstimo pode exigir condições de validação diferentes dependendo da classificação de risco do candidato. Você pode configurar uma propriedade de Nível de risco (RiskLevel) com um valor de Alto (High), Médio (Medium) e Baixo (Low) e definir um conjunto de condições de validação para clientes que representam níveis de risco Alto (High), Médio (Medium) e Baixo (Low).

Observação: você define as condições de validação que verificam se a entrada do usuário em um formulário está incorreta. Se a informação do usuário corresponder aos parâmetros de validação, uma mensagem de erro aparece quando o usuário tenta enviar o formulário.

1. No cabeçalho do Dev Studio, clique em Criar validação de processo (Create Process Validation).
2. Na guia Novo (New), defina o rótulo, o contexto e o ruleset da nova regra de validação, depois clique em Criar e abrir (Create and open).
3. Na guia Entrada (Input), defina as informações que o aplicativo usa para determinar qual conjunto de condições de validação deve ser aplicado no momento da execução:
   • Para definir apenas um conjunto de validação, selecione Nenhum (None).
   • Para definir um conjunto de validação separado para cada valor de propriedade, selecione Propriedade de entrada (Input property) e depois selecione a propriedade de destino.
   • Para definir um conjunto de validação separado para cada status do caso, selecione Status do caso proposto (Proposed work status).
   • Para definir um conjunto de validação separado para cada flow action, selecione Nome da flow action (Flow Action Name).
   • Para definir um conjunto de validação separado para cada estágio, selecione Estágios (Stages).
   Por exemplo: para definir conjuntos de validação separados para clientes com níveis de risco Alto (High), Médio (Medium) e Baixo (Low), selecione Propriedade de entrada (Input property) e depois insira Nível de risco (RiskLevel) como propriedade de destino.
4. Na guia Validar (Validate), no campo Propriedade (Property), insira a propriedade que você deseja testar. Por exemplo: para testar se um valor de pagamento de entrada é suficiente, no campo Propriedade (Property), insira Pagamento de entrada (DownPayment).
5. Na seção Condições (Conditions), crie um conjunto de validação clicando em Adicionar (Add).
6. Na janela Condições de validação (Validation conditions), defina o conjunto de validação:
   1. Verifique se a checkbox Habilitar condições (Enable conditions) está marcada.
   2. Opcional: para indicar que o usuário deve preencher um campo, marque a caixa de seleção Obrigatório (Required).
   3. Opcional: para forçar o sistema a avaliar propriedades subsequentes mesmo se a avaliação atual falhar, marque a caixa de seleção Continuar validação (Continue validation).
   4. Em Selecionar uma função (Select a function), escolha a função que você deseja usar para avaliar a propriedade.
   5. Nos campos abaixo, insira a expressão para a função.
   6. No campo Mensagem (Message), insira o texto que você deseja exibir quando a condição for verdadeira.
   7. Opcional: para adicionar uma função de validação adicional, clique em Adicionar uma linha (Add a row) e depois selecione um operador lógico para vincular as funções.
   8. Clique em Enviar (Submit).
   Por exemplo: para testar se o pagamento de entrada atende ao requisito mínimo, na lista Selecionar uma função (Select a function), selecione Comparar dois números (CompareTwoNumbers). A seguir, nos campos abaixo, insira .DownPayment IS LESS THAN 1000 (Pagamento de entrada é menor que 1000). Em Mensagem (Message), insira Pagamento de entrada insuficiente (Down payment not sufficient). Agora, se o valor do pagamento de entrada for inferior a 1.000, uma mensagem de erro será exibida.
7. Se a sua regra de validação incluir conjuntos de validação múltiplos para diferentes valores de entrada, você pode definir conjuntos de validação adicionais:
   1. No canto superior direito da guia Validar (Validate), clique em Adicionar uma nova condição (Add a new condition).
   2. Na linha Entrada (Input), insira o valor de entrada para o qual você deseja criar um conjunto de validação.
   3. Configure o conjunto de validação concluindo as etapas 6.b a 6.h.
   4. Opcional: para executar outro conjunto de validação após a conclusão da validação atual, na linha Executar também (Also execute), especifique o conjunto de validação de destino.
   Por exemplo: para criar um conjunto de validação para clientes de alto risco, na linha Entrada (Input), insira Alto (High). A seguir, adicione uma mensagem de erro e um conjunto de validação que avalia se a propriedade .DownPayment é inferior a 1.500. Agora, se um cliente de alto risco oferecer um pagamento de entrada de 1.200, uma mensagem de erro será exibida, mesmo que o valor seja suficiente para outros clientes.

   

   

8. Opcional: para executar regras de validação adicionais após a conclusão da validação atual, na linha Validação adicional (Additional validation), selecione a regra de validação de destino.
9. Clique em Salvar (Save).

O que fazer a seguir: associe uma regra de validação a uma flow action. Para obter mais informações, consulte Adicionando uma regra de validação a uma flow action.