Validadores
Validadores são regras que verificam o conteúdo de um atributo quando ele é inserido no sistema e rejeitam os dados que não as atendem. Você pode configurar validadores para cada campo de atributo. Para isso, abra as configurações do campo de atributo e role até a seção "Validation rules".
O conjunto de validadores pode variar conforme o tipo de dados.
Tipos de validadores
Cada tipo de dados (abre em uma nova aba) tem seu próprio conjunto de validadores disponíveis. Abaixo estão todos os validadores que você pode encontrar, considerando todos os tipos de dados.
Campo obrigatório (Required field)
Esta regra torna o preenchimento do campo obrigatório. Não requer configurações adicionais.
Remoção de espaços ao redor dos dados de entrada (Trimming spaces around incoming data)
Esta regra remove os espaços no início e no final da string. Não requer configurações adicionais.
Verificação da string (Checking the string)
Esta regra permite configurar os parâmetros do tipo texto. Nas configurações adicionais, você pode definir um comprimento fixo para a string ou um intervalo com valores mínimo e máximo.
Verificação de URL (URL verification)
Esta regra só aceita um valor de string se ele for um link. Não requer configurações adicionais.
Verificação de número (Checking for a number)
Esta regra verifica se o valor é um número. Nas configurações adicionais, você pode indicar se o número deve ser inteiro e definir seus valores mínimo e máximo.
Arredondamento de número (Rounding a number)
Esta regra não verifica se o valor é numérico. Em vez disso, arredonda o número segundo as regras definidas nas configurações adicionais. Nas configurações adicionais, você pode definir a ordem e a regra de arredondamento.
Verificação de e-mail (Email Verification)
Esta regra verifica se o valor é um endereço de e-mail válido. Não requer configurações adicionais.
Valor padrão (Default value)
Esta regra atribui um valor padrão ao atributo quando nenhum valor é inserido. Nas configurações adicionais, você pode definir esse valor padrão.
Verificação por lista fornecida (Given list screening)
Esta regra verifica se o valor inserido no atributo corresponde a um dos valores da lista do validador. Nas configurações adicionais, você pode informar os valores separados por vírgula e ativar a negação lógica.
Máscara de campo (Field mask)
Esta regra verifica se os dados inseridos correspondem à máscara. Nas configurações adicionais, você pode definir a máscara usando caracteres especiais.
Verificação por expressão regular (Regular expression validation)
Esta regra verifica se os dados inseridos correspondem a uma expressão regular. Nas configurações adicionais, você pode definir a expressão regular. Saiba mais sobre expressões regulares aqui.
Embora você possa adicionar vários validadores a um mesmo campo de atributo, a validação por expressão regular não é compatível com outras verificações de valor. Depois que você adiciona uma expressão regular, a lista deixa de oferecer: Checking the string, Checking for a number, Default value, Given list screening, Field mask, Comparison, Logical, Email Verification, URL verification, Rounding a number e Trimming spaces around incoming data.
O inverso também vale: se o campo já tem Trimming spaces around incoming data, a expressão regular, Field mask e Given list screening (além de Size e Checking files) não são oferecidos.
Comparação (Comparison)
Esta regra compara o valor do atributo especificado com outro para garantir que a relação entre eles corresponda à comparação descrita na propriedade. Nas configurações adicionais, você pode definir o tipo e o valor da comparação, além do operador de comparação.
Lógico (Logical)
Esta regra verifica se o valor do atributo é lógico. Nas configurações adicionais, você pode configurar como valores não booleanos são interpretados.
Tamanho (Size)
Esta regra verifica o tamanho da imagem. Nas configurações adicionais, você pode definir a largura máxima (Max X) e a altura máxima (Max Y) da imagem em pixels. Não é possível definir um tamanho mínimo.
Verificação de arquivos (Checking files)
Esta regra verifica se o arquivo enviado atende aos parâmetros definidos. Nas configurações adicionais, você pode definir os valores mínimo e máximo do tamanho do arquivo, a unidade de medida e a lista de extensões de arquivo permitidas (Extensions).
Intervalo de data e hora (Date and time range for restriction)
Esta regra limita os valores que podem ser selecionados no atributo. Está disponível para os tipos "Date and Time", "Date" e "Time". Nas configurações adicionais, defina os limites inferior e superior nos campos Minimum date and time value e Maximum date and time value. O formato desses campos segue o tipo do atributo (data, hora ou data com hora). Se o valor selecionado estiver fora dos limites, o usuário verá uma mensagem de erro.
Erros personalizados
Você pode adicionar um texto de erro a cada validador. O usuário verá esse texto quando o validador rejeitar os dados. Para isso, use o campo Custom error nas configurações do validador: o texto informado substitui a mensagem padrão de erro de validação.
Exemplos
Exemplo de validação de um campo de e-mail.
Neste exemplo, adicionamos ao valor de string:
- Remoção de possíveis espaços no início e no final da string
- Verificação de que a string é um e-mail
Exemplo de validação de um campo de senha.
Neste exemplo, adicionamos ao valor de string:
- Verificação do comprimento e da composição da string com uma expressão regular
Exemplo de validação de um campo de imagem.
Neste exemplo, adicionamos ao valor de string:
- Verificação das dimensões da imagem
- Verificação do tamanho do arquivo da imagem
- Erro personalizado