Armazenar uma tabela

Concluído

Nos exemplos anteriores, as tabelas serviam somente para serem usadas no contexto atual da tabela Dados ou no controle Lista Suspensa. Muitas vezes, no aplicativo, você precisará armazenar essas tabelas e usá-las em vários locais do aplicativo. Para fazer isso, o Power Apps tem uma variável de tabela chamada uma coleção.

As coleções são um tipo de variável no Power Apps

As coleções são variáveis de tabela nas quais você pode armazenar dados em um formato estruturado, como faria em uma fonte de dados tabular, sem gravações na fonte de dados. Ou seja, elas armazenam valores em linhas e colunas. É possível usar coleções com funções de tabela da mesma forma como faria com qualquer outra fonte de dados. No entanto, você não pode usar uma coleção com o controle Formulário. Se você tem experiência como desenvolvedor, pode pensar em uma coleção como uma matriz. Você não precisa inicializar ou predefinir uma coleção. Quando você cria a coleção e define valores, o Power Apps configura-a para você.

Criar uma coleção

A criação de uma coleção pode ser feita no seu aplicativo em qualquer lugar em que uma ação normalmente possa ser realizada. Por exemplo, é possível criar uma coleção ao pressionar um botão, alterando a propriedade OnSelect do botão ou até mesmo criar uma coleção sempre que chegar a uma determinada tela alterando a propriedade OnVisible dessa tela. Você pode criar uma coleção chamada collectMyFirstCollection usando essa fórmula.

Collect(collectMyFirstCollection, {Name: "Shane", FavoriteColor:"Orange"})

A coleção teria uma coluna chamada Name e outra coluna chamada FavoriteColor. A coleção teria um registro (linha) de dados com Shane como o valor de Name e Orange como o valor de FavoriteColor. Observe que a sintaxe é semelhante à função Table mostrada anteriormente neste módulo.

É possível adicionar outro registro à coleção usando esta fórmula.

Collect(collectMyFirstCollection, {Name: "Nicola", FavoriteColor:"Purple"})

Também é possível adicionar mais de um registro por vez usando esta fórmula.

Collect(collectMyFirstCollection, {Name: "Jeff", FavoriteColor:"Blue"}, {Name: "Chewy", FavoriteColor: "Red"})

Se você executasse todos esses comandos, sua coleção seria semelhante a essa tabela:

Nome	FavoriteColor
Shane	Orange
Nicola	Purple
Jeff	Blue
Chewy	Red

Também é possível usar essa coleção como uma fonte de dados para seu controle Galeria ou Lista suspensa.

Remover dados de uma coleção

Para limpar os dados existentes da coleção antes de adicionar novos dados, use a função ClearCollect. Se você usar a coleção existente do exemplo anterior, use esta fórmula:

ClearCollect(collectMyFirstCollection, {Name: "Fausto", FavoriteColor:"Green"})

Sua coleção seria semelhante a essa tabela:

Nome	FavoriteColor
Fausto	Green

Também é possível remover todos os registros de uma coleção usando a função Clear. Esta fórmula remove todos os registros da coleção, mas deixa suas colunas intactas:

Clear(collectMyFirstCollection)