Como Usar Collect, Clear e ClearCollect no Power Apps

Em Power Apps criamos variáveis para armazenar dados temporariamente na nossa aplicação. Utilizamos a expressão Set ou UpdateContext para criar uma variável.

Contudo podemos guardar vários dados, sobre a forma de uma tabela, com a expressão Collect. Através da expressão Collect podemos criar tabelas temporárias para armazenar os dados da nossa aplicação, utilizando esses dados em galerias, formulários, etc sem termos a necessidade de nos conectarmos a uma base de dados.

Neste artigo vou mostrar-te então as expressões Collect, Clear e ClearCollect.

  • A função Collect adiciona registos a uma origem de dados.
  • A função Clear elimina todos os registos de uma coleção, mantendo os campos definidos inicialmente na mesma.
  • A função ClearCollect elimina todos os registos de uma coleção adicionando de seguida um conjunto de registos diferente à mesma coleção. Com uma única função, ClearCollect combinamos as duas expressões Clear e Collect.

Definir os controlos da aplicação

Inserir etiquetas de texto

Começamos por inserir etiquetas de texto que representam os campos que vamos preencher na aplicação.

Definimos o nome a aplica à etiqueta.

E repetimos o processo mais 4 vezes, uma para cada etiqueta.

Adicionar 2 controlos de introdução de texto

Adicionamos de seguida uma caixa de entrada de texto.

Nas propriedades retiramos o texto pré-definido [Default] e na propriedade [HintText] colocamos o texto a ser apresentado na Caixa de Texto.

Repetimos o processo numa segunda Caixa de Entrada de Texto.

Introduzir um Selector de Datas

De seguida introduzimos um controlo de Seleção de Datas

Neste controlo deixamos as propriedades como estão, onde temos a data pré-definida [Default Date] como a data atual.

Inserir uma Lista Pendente

O próximo controlo será uma Lista Pendente.

Nesta lista adicionamos os Itens da lista manualmente, atravé da propriedade [Items].

[“Workshop Excel”; “Workshop Power BI”; “Workshop PowerApps”; “Workshop PowerAutomate”]

Inserir o Botão para Colecionar os Dados

Agora vamos adicionar um botão para adicionar os dados à coleção, onde vamos então criar a tabela de dados temporária.

Na propriedade [OnSelect] escrevemos a nossa expressão:

Collect(

    Dados;

        {

            Nome: txtNome.Text;

            Apelido: txtApelido.Text;

            ‘Data de Inscrição’: dpDataInscricao.SelectedDate;

            Evento: dplEvento.SelectedText.Value

        }

)

Definir a expressão ClearCollect

A expressão ClearCollect será definida num segundo botão, que quando acionado vai limpar os dados da coleção e adicionar um novo registo.

ClearCollect(

    Dados;

        {

             Nome: txtNome.Text;

             Apelido: txtApelido.Text;

             ‘Data de Inscrição’: dpDataInscricao.SelectedDate;

             Evento: dplEvento.SelectedText.Value

         }

)

Definir a expressão Clear

A expressão Clear limpa a coleção, mantendo a sua estrutura de campos.

Testar os valores adicionados na Coleção

Uma boa forma de apresentar os dados de uma coleção é através de uma galeria ou Tabela de Dados, neste exemplo vou utilizar uma Galeria Vertical em Branco.

Ao introduzir a galeria surge logo a opção para ligar aos dados, onde irei ligar-me à Coleção criada – Dados

De seguida adicionamos controlos na Galeria, que podem ser apenas etiquetas de texto para apresentar cada um dos campos da base de dados.

Em cada um dos controlos, na propriedade [Text] adicionamos a expressão ThisItem.Nome, ThisItem.Apelido, ThisItem.’Data de Inscrição e ThisItem.Evento para cada um dos controlos.

No final teremos uma galeria com 4 etiquetas de texto e um retângulo apenas para delimitar as células da Galeria

Testando a aplicação, basta preencher os campos na aplicação e pressionar o Botão Collect para iniciar o armazenamento dos dados.


Comments

Leave a Reply

Discover more from Exceldriven

Subscribe now to keep reading and get access to the full archive.

Continue reading