Às vezes, você precisa de outras coisas além de formulários

  • 6 minutos

Quando estiver criando aplicativos de tela no Power Apps, acesse Galerias para exibir registros da sua fonte de dados e Formulários para visualizar, criar e editar um registro individual. Contudo, algumas vezes, formulários não são suficientes. Nesses cenários, o Power Apps tem funções para atualizar as fontes de dados de tabela diretamente.

Criar e editar um registro diretamente

Neste módulo, você aprenderá a usar a função Patch para atualizar suas fontes de dados sem o uso direto de formulários.

A função Patch é usada geralmente quando você precisa executar uma ação nos dados sem interação do usuário, de maneira repetitiva, ou se o design do app não permite o uso de formulários. Por exemplo, caso deseje atualizar uma fonte de dados de log sempre que um usuário clicar em um botão para navegar para outra tela, você poderá usar a fórmula para a propriedade OnSelect do botão.

Patch(LoggingTable, Defaults(LoggingTable), {WhoClicked:
User().FullName, WhenClicked: Now()}); Navigate(NextScreen,
ScreenTransition.Cover)

Essa fórmula criará um registro na fonte de dados chamado LoggingTable. A coluna WhoClicked é definida como a propriedade FullName do usuário que está conectado, e a coluna WhenClicked é definida como a Data e a Hora em que ele clicou no botão. Isso abrirá a tela chamada NextScreen usando a transição de tela de Capa.

Excluir um registro

Também há funções disponíveis para a exclusão de um ou mais registros da fonte de dados. Essas funções são:

  • Remove e RemoveIf – Essas funções são usadas para remover ou excluir registros da fonte de dados.

  • Clear – Use a função Clear para remover todos os registros de uma coleção.

Por exemplo, caso você deseje oferecer ao usuário a capacidade de excluir um registro de um controle de Galeria, adicione um ícone de Lixeira à Galeria exibindo a fonte de dados CustomerOrders e, em seguida, defina a propriedade OnSelect do ícone com a fórmula mostrada a seguir.

Remove(CustomerOrders, ThisItem)

Essa fórmula excluirá o registro do item que exibia o ícone de Lixeira da fonte de dados CustomerOrders. Não haverá nenhuma confirmação e, portanto, você pode considerar a implementação de uma caixa de diálogo pop-up ou de seleção para confirmar que o usuário realmente deseja excluir o registro.

Alterações em massa nos registros

Patch e Remove são funções usadas para afetar um registro. Caso você precise afetar a alteração em mais de um registro, haverá duas opções:

  • Use a função ForAll, da qual tratamos no módulo anterior, para executar um loop em uma tabela de dados e execute uma função Patch ou Remove para cada registro na tabela.

  • Use a função Collect para fazer uma gravação de uma tabela para outra. Cada registro da tabela de origem é adicionado como um registro separado na tabela de destino.

Esses tópicos são abordados em outros roteiros de aprendizagem do Power Apps e não são abordados aqui.

As coleções são fontes de dados

É importante se lembrar de que essas funções podem usar uma coleção como seu destino. Patch, Remove e RemoveIf podem ser usadas para modificar fontes de dados de tabela e coleções. Conforme você criar aplicativos mais complexos, o armazenamento de dados em coleções e o trabalho com esses itens serão muito comuns, essas funções serão uma grande parte dessa manipulação.

O restante deste módulo abordará a atualização de uma fonte de dados. Lembre-se de que uma fonte de dados pode ser uma fonte de dados tabular ou uma coleção, a menos que indicado de outra forma.

Na próxima unidade, você aprenderá a criar e editar registros.