Saiba mais sobre como validar dados no Tulip usando widgets, botões e gatilhos.
O uso da validação de dados para as entradas do operador reduz problemas de qualidade e padroniza os formulários utilizados em seu processo. Se um usuário inserir um valor de dado que não atenda aos requisitos de validação, uma mensagem de erro será exibida. Além disso, você pode usar a lógica de gatilhos para impedir que um operador continue no aplicativo caso os dados inseridos não atendam aos requisitos.
A validação de dados torna a criação de aplicativos muito mais integrada, com as seguintes vantagens:
- Simplifique o gerenciamento de gatilhos: reduza a quantidade e a complexidade dos gatilhos para agilizar o desenvolvimento e a manutenção de aplicativos. Gaste menos tempo desenvolvendo aplicativos.
- Crie etapas dinâmicas: adicionecontrole dinâmico aos aplicativos por meio da funcionalidade de ativação/desativação de botões, permitindo maior interatividade e flexibilidade.
- Menos manutenção de aplicativos: gastemenos tempo revisando e compreendendo os aplicativos. Copie e cole widgets sem se preocupar com as implicações dos gatilhos.
Você também pode oferecer uma experiência intuitiva no aplicativo com botões ativados e desativados dinamicamente.
Regras de validação disponíveis por widget de entrada
Embora você possa usar qualquer widget de entrada para validação de dados, algumas entradas possuem regras de validação para definir parâmetros dos dados. A tabela abaixo descreve as regras de validação disponíveis para cada .
| Widget de entrada | Regras de validação |
|---|---|
| Caixa de seleção | N/A |
| Texto | Contém, Não contém, Começa com, Termina com, Limite máximo de caracteres, Limite mínimo de caracteres, É um e-mail, É uma URL (conforme indicado aqui) |
| Multilinha | Contém, Começa com, Termina com, Limite máximo de caracteres, Limite mínimo de caracteres, Não contém |
| Arquivo | N/A |
| Número | Igual, Diferente de, Maior que, Maior ou igual a, Menor que, Menor ou igual a, Dentro do intervalo (inclusive), Fora do intervalo (exclusive), Decimais exatos |
| Seleção única | N/A |
| Seleção múltipla | Mínimo selecionado, Máximo selecionado |
| Seletor de dados | É, Antes, Depois, Dentro do intervalo (inclusive), Fora do intervalo (exclusive), Até e antes, Até e depois |
| Imagem | N/A |
| Assinatura eletrônica | N/A |
Criar uma regra de validação
- Selecione um widget de entrada que tenha regras de validação disponíveis (consulte a tabela acima).
- No Painel de Contexto, clique no ícone + ao lado de “Regras de validação”.
- Selecione a regra que deseja adicionar ao widget de entrada.
- Selecione uma fonte de dados para a regra validar. Pode ser um valor estático ou uma variável.
- Clique no botão + para adicionar regras adicionais.
Reordenar regras de validação
A ordem das regras de validação corresponde à primeira mensagem de erro exibida caso o valor inserido não seja válido.
Nos exemplos abaixo, os dados inseridos não atendem a ambas as regras de validação. No entanto, a mensagem de erro exibida refere-se à primeira regra configurada.
Exemplo 1: “ContémTulipa” é a primeira regra a falhar, portanto, a mensagem de erro é exibida de acordo com isso.
Exemplo 2: “Começacom Hello” é a primeira regra a ser violada; portanto, a mensagem de erro é exibida de acordo com isso.
Isso permite que os desenvolvedores de aplicativos especifiquem a prioridade das mensagens de erro a serem exibidas ao operador. Para reordenar as regras de validação, clique no ícone de seis pontos e arraste-o para antes ou depois de uma regra.
Exigir dados de entrada
Marcar regras de validação como obrigatórias adiciona uma regra segundo a qual a entrada deve ser preenchida pelo operador para que seja considerada válida. Você pode usar isso para todos os tipos de widgets de entrada. Quando um widget de entrada é marcado como obrigatório, um asterisco vermelho aparecerá ao lado do widget no aplicativo. Para fazer isso, ative o controle deslizante “Marcar como obrigatório”, localizado abaixo do cabeçalho da seção “Regras de validação” no painel lateral.
Mensagens de erro de validação de entrada
O menu suspenso “Formatação de erros” dentro da seção “Regras de validação” do painel lateral oferece opções sobre como um erro nos dados de entrada é exibido ao operador quando o aplicativo está sendo executado no Player.
As três opções para exibir erros ao operador: 1. Mostrar mensagem de erro da regra de validação * Contorna o campo de entrada em vermelho e exibe uma mensagem de erro ao operador2. Contornar apenas o campo de entrada * Contorna o campo de entrada em vermelho3. Ocultar erro * Nenhuma indicação visual é fornecida
Ativar e desativar botões dinamicamente
Decida quando os operadores podem pressionar um botão com controles dinâmicos. Quando um botão está desativado, ele é exibido com cores opacas e o operador não poderá pressioná-lo.
Você pode até mesmo usar esse controle em widgets de Assinatura Eletrônica.
Os botões podem ser ativados ou desativados dinamicamente definindo o estado “Ativado” na seção “Interação ” do painel lateral de um botão selecionado. Por padrão, o estado “Ativado” de um botão está definido como “Sim”.
Existem algumas maneiras de adicionar um controle dinâmico para determinar o estado de ativação de um botão: 1. Especificar uma variável booleana; 2. Validade da entrada do usuário na etapa com widgets de entrada que possuem regras de validação; 3. A opção “Todos os widgets ”, que verifica se todas as entradas inseridas atendem às regras de validação
- Use uma expressão
Use expressões para ativar/desativar botões
Se você deseja ativar ou desativar um botão com base em um subconjunto de widgets, selecione “Usar expressão” para escrever uma condição personalizada.
Você deve escrever uma expressão que resulte em uma condição booleana (verdadeira ou falsa). Se você construir corretamente uma expressão válida, o editor de expressões indicará isso no canto inferior esquerdo.
Exemplo 1: Oexemplo abaixo usa a operação de módulo para determinar se o valor inserido em um widget de entrada numérica é ímpar ou par. Se o valor for ímpar, o botão será ativado. Se o valor for par, o botão será desativado.
Exemplo 2: O uso deexpressões também permite combinar condições adicionais. No exemplo abaixo, para que o botão seja ativado, o valor deve ser ímpar e atender às condições de validação definidas no widget de entrada numérica.
O valor inserido abaixo faz com que o botão fique desativado. Embora o valor inserido seja ímpar, ele não atende às regras de validação do widget de entrada.
O valor inserido abaixo faz com que o botão seja ativado, pois o valor inserido é ímpar e atende às regras de validação do widget de entrada.
Validação do widget de entrada em gatilhos
É possível usar a validação do widget de entrada como parte de uma condição “Se” em um gatilho. Isso permite que os criadores de aplicativos criem rapidamente uma lógica que não dependa dos valores específicos inseridos pelos operadores, mas da validade desses valores.
As informações de validade do widget também podem ser armazenadas em variáveis e registros de tabela por meio de gatilhos.
Você encontrou o que estava procurando?
Você também pode acessar community.tulip.co para postar sua dúvida ou ver se outras pessoas já enfrentaram uma situação semelhante!