Validação de dados
Nota: Em versões que não sejam em inglês, alguns elementos interativos desta missão podem apresentar comportamento inesperado. Eles não impactam os objetivos de aprendizagem ou a conclusão da missão.
Quando os desenvolvedores projetam uma visualização, todos os campos e controles que a tarefa requisita são adicionados. Como Business Architect (BA) da Pega, você deseja garantir que os valores de dados inseridos pelos usuários sejam válidos. Dados válidos são necessários para que o sistema processe as informações sem erros.
Neste tópico, veja várias maneiras de garantir que o sistema valide os dados inseridos pelos usuários para o processamento correto do fluxo de trabalho.
Requisitos de validação de dados
A confirmação de que os dados inseridos pelos usuários são válidos ajuda a garantir que o fluxo de trabalho possa ser concluído de ponta a ponta sem problemas ou erros.
A tabela a seguir descreve exemplos de requisitos de validação de dados:
| Requisitos de dados | Exemplos |
|---|---|
| Use apenas o tipo correto de dados. | Por exemplo, os usuários devem inserir um número em um campo de Total purchase units. |
| Restrinja os dados a valores possíveis. | Por exemplo, os usuários podem escolher apenas um tipo válido de empréstimo em uma lista de opções. |
| Verifique se os dados se encaixam na lógica do negócio. | Por exemplo, um campo Date of birth deve estar no passado. |
Para evitar erros de processamento, a Pega Platform™ fornece tipos de campos e controles para atender aos requisitos de validação. A escolha do controle correto pode ser suficiente para atender a um requisito de validação. Nos casos em que um controle ou tipo de campo é insuficiente para executar a validação de dados, a Pega Platform fornece a validação de dados usando lógica de negócio para testar os campos com condições.
Por exemplo, você pode usar um tipo de campo Date only para garantir que o usuário digite uma data, qualquer que seja o formato, dd/mm/aaaa ou mm/dd/aaaa. Mas o tipo de campo Date only não garante que um campo Data de início no formulário de histórico de emprego seja uma data no passado. Para isso, é possível validar a data no passado utilizando a lógica de negócio.
Validação de dados com controles
Os controles representam a abordagem mais comum de validação. É possível validar a entrada do usuário com os controles usando tipos de controle, campos requisitados e configurações editáveis.
Tipos de controle
O uso do tipo de controle correto para um propósito específico garante que os usuários insiram valores válidos. A tabela a seguir mostra o exemplo de casos de uso para diferentes tipos de controle:
| Tipo de controle | Como o controle ajuda na validação | Caso de uso |
|---|---|---|
| Data e Hora | A seleção de uma data a partir de um ícone de calendário garante que os usuários insiram uma data em formato válido. | Os usuários devem inserir uma data que inclua dia, mês e ano. |
| Radio buttons | Restringe as escolhas a um conjunto de valores válidos e permite aos usuários selecionar somente um valor. É possível usar radio buttons (botões de opção) quando somente um pequeno número de opções (por exemplo, menos do que cinco) está disponível. | Os usuários devem selecionar um dos três tipos possíveis de empréstimo. O usuário deve ver todos os tipos no formulário. |
| Dropdown | Restringe os valores válidos aos que aparecem na lista. Uma lista do dropdown apresenta as opções somente quando os usuários clicam no controle. Isso ajuda a reduzir a quantidade de informações no formulário. | Os usuários devem selecionar um dos 10 tipos de cadeiras de escritório em uma lista. As opções não precisam ser exibidas no formulário. |
| Autocompletar | Quando os usuários inserem um ou mais valores no controle, o controle filtra as opções disponíveis. Isto ajuda os usuários a encontrar uma opção em uma lista caso haja um grande número (por exemplo, mais de 20) de opções possíveis. | Os usuários devem selecionar o país no qual residem em uma lista. O usuário pode inserir texto no controle para ajudar a encontrar o país correto. |
| Checkbox | Os usuários podem marcar a caixa de seleção ou deixá-la em branco. Essa opção assegura que uma propriedade verdadeira/falsa seja verdadeira (selecionada) ou falsa (não selecionada). | Os usuários selecionam uma opção para adquirir seguro de viagem adicional. |
Campos obrigatórios
Configurar um controle como um campo obrigatório garante que o usuário insira um valor. Caso não haja valor, os usuários recebem uma mensagem de erro quando tentam enviar um formulário. No exemplo do perfil do programa de prêmios, você decide configurar a data de nascimento como um campo obrigatório. Caso os usuários não insiram uma data no campo, uma mensagem de erro aparece quando os usuários tentam enviar o formulário. A mensagem de erro não aparece caso haja uma data no campo.
Validação de dados pela lógica de negócio
Use o App Studio para executar validações simples pela lógica de negócio, que comparam o valor de um campo a um valor constante, quando o usuário envia um formulário. Você cria condições que definem valores inválidos entre os dados, para que uma mensagem de erro seja exibida quando a condição é atendida. O sistema exibe uma mensagem de erro se os usuários gerarem um valor que atenda à condição de valor inválido. Ele impede que o usuário continue o Caso até a resolução do problema.
Associe os números à imagem a seguir para aprender a configurar uma condição de validação que garanta que os usuários informem um valor superior a 100,00 no campo Loan amount :
- Configuração de condição da validação: Para configurar a validação, você cria a seguinte condição: O campo do valor do empréstimo é menor ou igual a 100,00.
- Diretriz de mensagens de erro: Sua mensagem de erro deve informar ao usuário o que é necessário para identificar e solucionar o erro na validação dos dados.
- Validação em tempo de execução: Quando o usuário envia o formulário, o sistema avalia a condição com base no valor do campo. Se a condição for avaliada como verdadeira, ou seja, o valor no campo for menor ou igual a 100,00, a mensagem aparece no formulário.
As validações da lógica de negócio muitas vezes são associadas a processos do ciclo de vida do caso, o que permite a validação de cada instância dos campos com base nas validações distintas conforme a lógica de negócio. As validações conforme a lógica de negócio que definem os valores aceitáveis são separadas dos campos que capturam os dados. Por exemplo, o sistema valida um campo Data de nascimento quando os usuários inserem a data no campo. A validação não será feita novamente se o campo for utilizado posteriormente durante o processamento do caso.
Muitos formulários podem utilizar o mesmo campo e aplicar diferentes condições de validação para cada instância do campo. Por exemplo, no Aplicativo de RH, os representantes de RH digitam informações em dois formulários, o formulário Histórico profissional e o formulário Recém-contratado. No formulário Histórico profissional, um representante de RH digita a data de admissão de um funcionário que já trabalha na empresa. O representante de RH deve digitar uma data anterior à data atual. No formulário Recém-contratado, um representante de RH digita uma data de admissão para um funcionário que ainda não foi contratado. O representante de RH deve digitar uma data de admissão posterior à data atual. Com duas validações por lógica de negócio, uma para cada condição de negócio, você garante que os usuários insiram as datas corretas nos dois formulários.
Dica: No App Studio, você pode validar o valor de um campo quando um usuário enviar um formulário ou quando o caso entrar em um Estágio.
Verifique seu conhecimento com a seguinte interação:
Validação em um estágio
Também é possível utilizar a validação conforme a lógica de negócio em um estágio. Use a validação pela lógica de negócio em um estágio para assegurar que o aplicativo gere os dados corretos e que os usuários digitem os dados corretos ou executem as ações adequadas antes que o caso entre em um estágio específico. Você configura validações conforme a lógica de negócio em um estágio no modelo de dados do tipo de caso, e a validação é acionada antes que o caso entre em um estágio especificado. Em uma validação de entrada em um estágio, se o valor de um dado atender à condição de dados inválidos, o caso não poderá entrar no estágio e uma mensagem de erro será exibida.
Nota: Quando a validação em um estágio dispara uma mensagem de erro, os usuários devem poder atualizar os dados inválidos ou executar uma ação, como voltar a um estágio anterior ou fechar o caso. Cabe ao desenvolvedor configurar uma funcionalidade que permita ao usuário final solucionar o erro de validação.
Por exemplo, em um aplicativo de empréstimo imobiliário, um score de crédito válido deve estar disponível antes que o caso possa entrar no estágio de subscrição. O aplicativo informa ao usuário que o score de crédito é inválido e o usuário pode verificar o histórico de crédito cadastrado ou cancelar o processo.
Associe os números à imagem a seguir para aprender a configurar validações no modelo de dados do tipo de caso:
- Campos reutilizáveis: Assim como nas validações de etapa, você pode configurar as validações de entradas em um estágio com campos reutilizáveis, como ID do caso e Status do caso.
- Grade de validações: As validações de entradas do estágio são exibidas numa grade em que uma propriedade identifica cada linha e um estágio identifica cada coluna. A grade permite gerenciar todas as validações de entrada em um estágio para um tipo específico de caso.
- Condições de validação: Você define as condições para a validação dos estágios de forma muito semelhante às condições definidas na validação das etapas. É possível adicionar várias expressões utilizando agrupamentos AND/OR para configurar uma condição. Por exemplo, no aplicativo de empréstimo imobiliário, se o score de crédito for inferior a 300 ou superior a 850, o usuário receberá uma mensagem de erro.
- Validação em múltiplos estágios: Ao iniciar um processo de validação pela lógica de negócio no modelo de dados, você pode configurar uma validação de entrada em um estágio que se aplique a vários estágios.
Validação em um formulário
As validações conforme a lógica de negócio são usadas em um formulário quando não é possível prever ou controlar os valores que os usuários podem digitar. Você configura validações conforme a lógica de negócio em um formulário, e a validação é acionada quando o usuário envia o formulário. Se os usuários enviarem um formulário com um valor que atenda à condição de dados inválidos, o formulário exibirá um erro. O sistema impede que os usuários continuem o Caso enquanto não enviarem dados que atendam à condição. Use a validação em um formulário quando o usuário puder executar uma ação imediata para solucionar os dados inválidos, por exemplo, digitando um novo valor em um campo.
Por exemplo, suponha que um formulário contenha um campo Date of birth. O tipo de campo não pode impedir que os usuários insiram e enviem uma data que esteja no futuro. Mas você pode programar uma validação conforme a lógica de negócio para exibir uma mensagem de erro se o usuário enviar uma data no futuro. O sistema permite que os usuários enviem o formulário depois de inserir uma data no passado.
No centro da imagem abaixo, deslize a linha vertical para ver a configuração da etapa para validar o campo Date of birth à esquerda e a mensagem de erro que será exibida no formulário à direita.
Verifique seu conhecimento com a seguinte interação:
This Topic is available in the following Module:
If you are having problems with your training, please review the Pega Academy Support FAQs.
Quer nos ajudar a melhorar esse conteúdo?