Validação de dados no Dev Studio

No App Studio, é possível configurar as condições de validação que realizam a comparação verdadeiro/falso para o valor de um campo em relação a um valor constante ou o valor de outro campo. Situações de validação mais complexas podem exigir habilidades adicionais que são fornecidas pelas regras de validação no Dev Studio.

Considere os seguintes cenários, cada um exigindo um comportamento que você pode configurar apenas no Dev Studio:

• Quando um cliente canadense insere seu endereço, a entrada de código postal precisa obedecer ao formato padrão dos códigos postais canadenses.
• Quando um investidor abre uma conta de investimento, ele preenche um questionário para determinar seu nível de experiência. Apenas indivíduos com uma experiência de investimento ampla podem adicionar negociação com margem às suas contas.
• Quando uma pessoa se cadastra em um plano de saúde, o candidato deve enviar um formulário de consentimento para permitir a divulgação de informações médicas a terceiros.

Regras de validação

As regras de validação (Validate)  garantem que os dados que os seus usuários fornecem atendem às condições que um caso exige para avançar. Ao atribuir regras de validação a flow actions, você pode evitar que os usuários insiram informações que o seu aplicativo não pode processar e reduz o número de erros de processamento.

No Dev Studio, você pode ampliar as regras de validação que são criadas automaticamente no App Studio. Também é possível criar novas regras de validação na categoria Processo (Process).

Regras de validação de edição

As regras de validação de edição (Edit validate) são geralmente aplicadas a propriedades e consistem em um código Java que compara o valor de uma propriedade com um padrão definido. Por exemplo, uma regra edit validate pode verificar se um valor da propriedade é composto por sete números com um espaço separando o terceiro e quarto números. Se os padrões corresponderem, a entrada é considerada válida. Caso contrário, o sistema sinaliza a entrada com um erro.

As regras edit validate são usadas para validação do lado do cliente, o que significa que o valor que os usuários inserem é validado imediatamente sem consultar o servidor. A validação ocorre quando os usuários fazem uma mudança no valor inserido. Para aplicar uma regra edit validate a uma propriedade, faça uma referência à regra edit validate na guia Avançado (Advanced) do formulário de regras da propriedade, no campo Use validate.

A lógica de negócio pode exigir que a entrada do usuário atenda a determinados padrões. Por exemplo, para capturar as informações de contato de um usuário, uma organização precisa garantir que as informações sejam válidas. Antes que um aplicativo possa confirmar que um código postal, endereço de e-mail ou número de telefone de um usuário estejam corretos, o aplicativo deve confirmar que a entrada do usuário esteja de acordo com um formato específico, que varia de acordo com o local.

O exemplo a seguir demonstra a aplicação de uma regra edit validate a partir da regra validate para garantir que o usuário insira um código postal de acordo com o formato aceito nos EUA, que exige cinco dígitos numéricos.

Verifique seus conhecimentos com a interação a seguir.

A lógica de negócio pode exigir que um aplicativo valide dados de forma diferente, com base em determinadas condições, como entrada do usuário, status do caso ou estágio, ou ainda uma ação do usuário. Isso pode ser realizando uma regra de validação (validate).

Considere um tipo de caso de abertura de uma nova conta de investimento. Uma firma de serviços financeiros pode oferecer a opção de negociar títulos em margem emprestando fundos para um cliente comprar ações ou fazer outros investimentos permitidos. Esse empréstimo, conhecido como empréstimo com margem, exige que o cliente mantenha uma certa proporção entre o saldo de empréstimo e o valor da conta, como 30%. A firma quer garantir que os clientes usem a margem com sabedoria e limitem a necessidade de uma chamada de margem, uma solicitação para fornecer fundos adicionais ou vender um investimento automaticamente para restaurar a proporção entre saldo de empréstimo e valor da conta. Investidores com ampla experiência em investimentos apresentam um risco baixo de chamada de margem, enquanto investidores com experiência limitada apresentam um risco muito mais alto. Além disso, as contas que limitam contribuições anuais, como contas de aposentadoria, proíbem a negociação com margem de forma absoluta. Para atender a esse requisito, você pode condicionar a lógica da validação com base no tipo de conta e nível de experiência.

Para qualificar a lógica de validação, use a guia Entrada (Input) da regra validate para identificar o tipo de qualificação a ser aplicada selecionando uma das opções.

• Propriedade de entrada (Input property) – Qualificar a validação com base nos dados fornecidos pelo usuário. No exemplo da nova conta de investimento, os campos do nível de experiência e do tipo de conta são usados para especializar a lógica de validação.
• Status de trabalho proposto (Proposed work status) – Qualificar a validação com base no status que o aplicativo aplica ao caso. Por exemplo, uma solicitação de cartão de crédito é baseada, parcialmente, no score de crédito do cliente. Para o status Pendente-Qualificação (Pending-Qualification), o score de crédito mínimo pode ser 600, enquanto a mudança do status para Aprovado (Approved) exige um score de crédito mínimo de 725.
• Flow action – Qualificar a validação com base na ação que é realizada por um usuário. Por exemplo, um formulário contendo informações de funcionários exige a data de início do emprego. Se o usuário quiser executar o onboarding de um novo funcionário, a data de início deve estar no futuro. Se o usuário quiser realizar a análise anual de um funcionário, a data de início deve estar no passado.
• Estágios (Stages) – Qualificar a validação com base no estágio atual do caso. Por exemplo, para solicitar uma hipoteca ou empréstimo imobiliário, o cliente deve indicar sua renda anual. Durante o estágio Envio (Submission), o aplicativo exige que o usuário forneça a renda estimada. Durante o estágio Aprovação (Approval), a estimativa deve ser substituída por um valor concreto e confirmado.

O exemplo a seguir demonstra a validação qualificada pela entrada. O valor selecionado na lista Nível de experiência (Experience level) determina a condição de validação que é aplicada ao enviar o formulário. Se o usuário seleciona Experiente (Experienced) ou Profissional (Professional), a negociação com margem é permitida e a checkbox para habilitar a negociação com margem não é validada. Se o usuário seleciona Limitado (Limited), um erro é exibido se o usuário marca a checkbox para habilitar a negociação com margem.

No centro da imagem a seguir, deslize a linha vertical para ver a configuração da validação qualificada por entrada e o resultado.

O App Studio é compatível com comparações verdadeiro/falso entre dois valores de propriedade ou um valor de propriedade e uma constante. Quando não é possível configurar esse tipo de comparação, você pode acessar uma biblioteca de funções de validação no formulário da regra de validação no Dev Studio. Por exemplo, você pode usar uma função para verificar se uma data está entre as últimas quatro ou oito semanas ou verificar se um usuário carregou um tipo específico de anexo no caso. Cada função apresenta um conjunto personalizado de campos para configurar o comportamento de validação.

O exemplo a seguir demonstra o uso de uma função para configurar a validação. A regra validate usa a função Uma [categoria de anexo] [está anexada/não está anexada] ao caso atual (A [attachment category] is [attached/not attached] to the current case) para garantir que o usuário anexe um documento que comprove sua identidade como parte do processo de onboarding de um novo funcionário.

No centro da imagem a seguir, deslize a linha vertical para ver a configuração da validação de anexo e o resultado.