Validação de dados usando IsMatch e variáveis

Neste tutorial, falaremos sobre validação de dados e por que precisamos dela em nossos aplicativos.

Discutimos a criação de formulários do zero em tutoriais anteriores e é incrível como podemos permitir que os usuários finais insiram novos dados ou alterem uma informação existente perfeitamente por meio de nosso aplicativo. No entanto, haverá casos em que um usuário final pode digitar informações que não correspondem ao que o formulário exige. É aqui que entra a validação de dados.

Índice

• O que é validação de dados?
• Validação de dados usando IsMatch
• Validação de dados usando variáveis
• Garantindo um processo de validação completo
• Conclusão

O que é validação de dados?

A validação de dados evita que os usuários finais enviem dados incorretos em seus formulários.

Por exemplo, não faz sentido ter números anexados a um nome.

Alguns também podem digitar 1 em vez de I como um erro.

Sem validação de dados, clicar no botão Enviar atualizará automaticamente a fonte de dados de back-end. Isso pode causar problemas sabendo que houve erros nas informações fornecidas. A validação de dados ajuda a evitar esse problema.

A validação de dados verifica certas regras e parâmetros que ajudam a determinar se os dados do formulário podem ser enviados ou não.

Existem diferentes maneiras de configurar a validação de dados no Power Apps. Vamos ver algumas das melhores maneiras de fazer isso.

Validação de dados usando IsMatch

Anteriormente, mencionamos que a validação de dados segue um conjunto de regras. No caso dos exemplos que mostramos, o problema principal era ter números digitados em campos onde os números não fariam sentido. Em casos como esses, a função IsMatch pode nos ajudar a evitar isso.

Para entender como o IsMatch funciona, vejamos o documento do Microsoft Power Apps .

IsMatch pega um texto, um padrão e algumas opções. Basicamente, isso mostra que essa função avalia o texto com base no padrão.

O texto abrange tudo o que o usuário final digita na caixa de texto. Quanto ao padrão, há vários predeterminados diferentes, como vírgulas, dígitos ou endereços de e-mail.

Se você escolher o padrão de e-mail, por exemplo, o IsMatch garantirá que o texto digitado corresponda a esse padrão. A partir daí, retornaria True ou False.

No nosso caso, vamos usar o padrão para Digit. Isso abrange todos os dígitos únicos de 0 a 9.

Uma vez aplicado este padrão, a função IsMatch irá procurar qualquer dígito no texto e retornará um verdadeiro ou um falso dependendo do que encontrar.

Também existem parâmetros específicos que ajudam a tornar nossa fórmula mais precisa ao usar a função IsMatch. Neste caso, vamos usar o parâmetro Contém. Este parâmetro verifica se o padrão aparece no texto, mas não precisa necessariamente começar ou terminar com ele.

Vamos voltar ao nosso aplicativo e ver como podemos aplicá-lo ao nosso formulário.

Começaremos adicionando um rótulo.

Vamos colocá-lo perto do botão Enviar.

Queremos que o texto no rótulo seja produzido dinamicamente. Mas, por enquanto, vamos nos concentrar em usar o campo FirstName, que é DataCardValue16.

Faremos disso uma declaração IF. Basicamente, se esta fórmula retornar verdadeiro, queremos que o rótulo mostre “Erro de validação de dados”. Caso contrário, permanecerá em branco.

Como uma instrução IF começa com um texto lógico, inseriremos nossa função IsMatch aqui, que faz referência ao texto no campo FirstName. Isso é representado por DataCardValue16.Text.

Também seguiremos com o padrão real que queremos que essa lógica procure. Vamos adicionar Match.Digit.

Por fim, queremos adicionar algumas opções de correspondência. Não estamos realmente procurando o texto exato aqui. Em vez disso, queremos apenas corresponder a qualquer dígito que o texto contenha. Portanto, adicionaremos nosso parâmetro Contains.

Simplificando, esta fórmula pergunta: algum dígito aparece em qualquer lugar do texto? Se retornar verdadeiro, o rótulo dirá Erro de validação de dados. Caso contrário, permanece em branco.

Vamos tentar isso. Portanto, se digitarmos Lewis na caixa de texto, mas usarmos 1 em vez de I, o rótulo mostrará Erro de validação de dados.

Observe que nem precisamos terminar de digitar o nome inteiro. No momento em que digitamos 1, o rótulo imediatamente mostrou o erro.

Podemos personalizar esse rótulo para tornar o erro mais perceptível. Além de deixar o texto maior, vamos deixá-lo vermelho para indicar que há um erro.

Portanto, se o usuário final vir esse erro, ele informa que inseriu dados incorretos e deve corrigi-los.

Validação de dados usando variáveis

Embora tenhamos configurado um rótulo que notifica o usuário final sobre o erro nos dados que está tentando inserir, você notará que ainda temos um botão Enviar no qual eles podem clicar mesmo se houver um erro. O que queremos é que o botão não apareça quando for detectado um erro.

Existem duas maneiras de fazer isso. A primeira é uma rota lógica e mais fácil de seguir, enquanto a segunda abordagem será mais complicada, mas também facilitará quando você começar a adicionar mais validação de dados na tela.

Vamos começar com a primeira abordagem.

Primeiro, copie toda a fórmula usada em nosso rótulo.

Em seguida, destaque o botão, escolha a propriedade de visibilidade no menu suspenso e cole a fórmula na barra de fórmulas. Isso define dinamicamente a visibilidade do botão para essa lógica.

Portanto, se a caixa de texto contiver um dígito, o botão não ficará visível.

Vamos ver se isso funciona. Se eu alterar a letra O em Coy para zero, você verá que o erro aparece e o botão Enviar desaparece.

Se mudarmos isso de volta para um O, o botão volta.

O problema com essa abordagem é que estamos usando a mesma lógica em dois locais diferentes — o rótulo e o botão. Isso significa que, se houver algo a modificar, você também terá que fazê-lo em dois lugares diferentes. Isso pode se tornar cansativo, especialmente se você tiver mais lógica de validação adicionada posteriormente.

Para resolver esse problema, vamos adicionar outro botão. Vamos colocar o novo botão ao lado do botão Enviar.

Vamos chamá-lo de botão Validar.

Então vamos colocar a mesma lógica neste botão.

O que queremos que este botão faça é atualizar uma variável para nós, que atualiza o contexto.

Portanto, vamos remover a parte da fórmula que solicita que a lógica mostre o Erro de validação de dados e alterá-la para UpdateContext.

Precisamos disso para referenciar uma variável, então vamos criar uma variável chamada Submit . Vamos definir isso como falso caso o erro de validação realmente aconteça.

Em seguida, seguiremos imediatamente com o mesmo formato, mas desta vez, estamos definindo-o como verdadeiro caso a caixa de texto não contenha um dígito.

O que fizemos foi tornar a visibilidade dos botões dependente da variável que criamos ao invés da lógica. Portanto, também precisaremos alterar a lógica do botão Enviar e apenas tornar sua visibilidade igual a Enviar, que é a variável da qual estamos falando.

Então, vamos digitar Coy na caixa de texto e clicar em validar.

Como você pode ver, o botão Enviar aparece depois que fazemos isso.

Agora, vamos mudar o O para zero e clicar em validar. Desta vez, o botão enviar desaparece.

Agora que corrigimos os botões, vamos mudar a lógica do rótulo também. No momento, ele ainda contém a lógica original usando a função IsMatch.

Como agora estamos baseando nossa lógica na variável Submit, queremos trocar o espaço em branco pelo erro. Portanto, se Enviar for verdadeiro, queremos que o rótulo fique em branco. Mas se Enviar for falso, queremos que nosso texto de erro apareça.

Para facilitar a compreensão da mensagem de erro para os usuários finais, vamos alterá-la para “Possível erro de validação de dados – Clique em Validar para verificar”.

Para testar essa nova lógica que usamos, vamos a um registro diferente do Anitra e clique no ícone Editar.

Como você pode ver, ainda não há erro de validação nesta página.

Se eu mudar Anitra para Anitr0 e clicar em Validar, é quando a mensagem de erro aparece.

Garantindo um processo de validação completo

Devido à forma como configuramos o processo de validação de dados nesta tela, há dois problemas possíveis que ainda resultariam no envio de dados incorretos.

O primeiro problema é que é possível pular clicando no botão Validar porque o botão Enviar ainda está visível, a menos que ocorra um erro no processo de validação. Então, podemos simplesmente digitar Alons5, por exemplo, ignorar o botão Validar e clicar no botão Enviar imediatamente.

O segundo problema é que, se validarmos uma entrada correta, ainda podemos voltar à caixa de texto e digitar o que quisermos. Portanto, se o botão Enviar aparecer, qualquer pessoa poderá facilmente voltar à caixa de texto, inserir um dígito e clicar no botão Enviar.

Precisamos tornar a variável Submit false por padrão. Também precisamos garantir que, sempre que alguém clicar na caixa de texto, tudo volte ao modo padrão.

Então, vamos para o campo FirstName e escolha OnSelect no menu suspenso de propriedades. Em seguida, vamos usar UpdateContext e referenciar a variável Submit. Em seguida, definiremos isso como falso.

Agora, sempre que alguém clicar na caixa de texto, ele solicitará automaticamente que o usuário clique primeiro em Validar.

Então, se eu tentar mudar o primeiro nome para Frank e clicar em Validar, é a única vez que o botão Enviar aparece.

Mas se eu voltar para a mesma caixa de texto e tentar adicionar 1 no final de Frank, ele voltará ao estado padrão em que o erro está aparecendo e o botão Enviar desaparece.

Introdução ao Power Apps: Definição, recursos, funções e importância
Funções e fórmulas do PowerApps | Uma introdução
Formulários e cartões de dados do Power Apps na tela de detalhes

Conclusão

A validação de dados ajuda a proteger nossos dados e garante que os usuários finais não enviem os registros errados por engano. O que passamos neste tutorial são, na verdade, apenas alguns dos princípios básicos. Você pode adicionar quantos tipos de validação quiser.

Além disso, definimos a validação de dados apenas para o primeiro nome. Você pode ir em frente e fazer a mesma coisa para o sobrenome. Você pode até definir o nível VIP ou o número do passaporte para mostrar apenas dígitos. Tudo depende de quais campos você deseja aplicar diferentes processos de validação.

Tudo de bom,

henrique