Funções para validar dados

  • 7 minutos

Outra maneira de tornar o aplicativo mais dinâmico e intuitivo para o usuário é usar funções de validação como IsBlank, IsBlankOrError, IsEmpty, IsNumeric, IsToday e IsMatch. Essas funções permitem a validação da condição de um campo, um controle, uma variável ou uma tabela. Todas essas funções retornam valores Boolianos (true ou false) com base nos resultados da respectiva avaliação. Geralmente, essas funções são usadas com as funções If ou Switch para gerar mensagens/opções para os usuários.

Por exemplo, você pode usar essas funções em que não deseja permitir que o usuário envie um formulário se um campo estiver em branco ou se os dados do campo não corresponderem a um formato específico.

Introdução com validação de entrada numérica

Vamos ver um exemplo. Suponha que temos dois controles: um Entrada de texto em que o valor Default está em branco e outro Text label logo abaixo dele onde inserimos uma fórmula na propriedade Text. Vamos usar um teste IsNumeric com uma instrução If na propriedade Text do rótulo. Ao modificarmos a propriedade Text do controle de rótulo, podemos produzir saídas diferentes.

Observe atentamente a instrução If na propriedade Text na imagem a seguir. Ele está instruindo nosso controle de rótulo a exibir uma saída de texto diferente, dependendo da validação de IsNumeric de tudo o que for inserido no campo de entrada de texto.

Captura de tela da propriedade Text do rótulo com a condição If(IsNumeric).

Se colocarmos o aplicativo no modo de visualização, vamos poder inserir qualquer texto em nosso campo de entrada, e nosso rótulo abaixo continua solicitando um número:

Captura de tela do texto inserido no campo de entrada de texto e a exibição do texto mostrando

No entanto, se inserirmos qualquer número, a mensagem do rótulo vai mudar:

Captura de tela do número 45.7 inserido no campo de entrada de texto e o texto exibido mostrando 'Você inseriu um número!'.

Dica

Você também pode empregar o operador Not (ou !) com qualquer uma dessas funções. Por exemplo, IsBlank testa uma condição em branco, enquanto !IsBlank testa uma condição que não está em branco.

Usar funções de validação em seu aplicativo pode ajudar você a influenciar a entrada do usuário e a interação geral com o aplicativo.

Funções de validação disponíveis

Veja aqui uma visão geral de algumas das funções de validação que podem ser usadas no Power Apps (lembre-se de que a saída é sempre true ou false):

  • IsBlank: verifica um campo, uma propriedade ou uma variável para ver se o resultado está em branco ou é uma cadeia de caracteres vazia.

  • IsBlankOrError: verifica se uma expressão está em branco ou resulta em um erro.

  • IsEmpty: verifica uma tabela de dados para ver se ela contém algum registro.

  • IsError: testa um valor de erro.

  • IsMatch: verifica uma cadeia de caracteres de texto para determinar se o resultado corresponde ao padrão especificado. Por exemplo, você pode usar essa função para testar as entradas de emails ou números de telefone válidos.

  • IsNumeric: verifica um campo, propriedade ou variável para determinar se o valor é numérico (como no exemplo anterior).

  • IsToday: verifica um valor de data ou hora para ver se está entre a meia-noite de hoje e a meia-noite de amanhã no horário local.

  • IsUTCToday: semelhante a IsToday; no entanto, usa o Tempo Universal Coordenado (UTC) em vez da hora local e é independente de fuso horário.

  • A função Not() ou ! pode ser usada antes de qualquer uma dessas validações para validar o oposto. Por exemplo, !IsBlank verifica se o valor não está em branco. (Not retorna true se seu argumento é false.)

Exemplo de IsMatch

Vamos dar uma olhada em mais um exemplo sobre a função IsMatch. Vamos usar essa funcionalidade para desativar um botão se o controle Entrada de texto não tiver um endereço de email válido inserido. Email é um padrão predefinido que podemos usar com facilidade. No entanto, lembre-se de que ele está procurando apenas um padrão; ele não valida se o endereço de email realmente funciona ou não. Então, usando seu aplicativo de demonstração, vamos fazer o seguinte:

  1. Insira um controle Entrada de texto em sua tela. Deixe a propriedade Default em branco excluindo "Text Input". Renomeie o controle: tiEmailEntry

  2. Adicione um controle Botão logo abaixo do campo de entrada de texto.

  3. Modifique a propriedade DisplayMode do controle Botão para a fórmula a seguir:

    If(IsMatch(tiEmailEntry.Text, Match.Email), DisplayMode.Edit, DisplayMode.Disabled)

    Usando a fórmula de correspondência Email, o Power Apps vai testar um valor de texto no campo de entrada com este padrão: uma cadeia de caracteres alfanumérica, seguida pelo símbolo @, seguido por outra cadeia de caracteres alfanumérica, seguida por um ponto (.) e terminando com uma cadeia de caracteres com várias letras. Se a cadeia de caracteres de entrada não corresponder ao padrão especificado, o botão permanecerá no modo "desabilitado" e o usuário não poderá interagir com ele. Vamos testar a funcionalidade.

  4. Para visualizar o aplicativo, selecione o botão Reproduzir no canto superior direito.

  5. Se o campo estiver em branco ou tiver um endereço de email incompleto, o botão será desabilitado e exibido na cor cinza. Tente alguns exemplos diferentes sem a @ ou sem o ponto (.).

    Captura de tela de um endereço de email inválido em um campo de entrada de texto sem o símbolo @ e o botão desabilitado abaixo dele.

    Quando você insere um endereço de email formatado corretamente, o botão fica azul e pode ser selecionado.

    Captura de tela de um endereço de email válido no campo de entrada de texto com o botão abaixo no modo de edição.

As funções de validação de dados são ferramentas úteis para moldar os dados inseridos pelos usuários. A utilização delas pode ajudar a eliminar erros de entrada de dados e melhorar ainda mais a experiência do usuário.