Coleções

Concluído

Nas duas unidades anteriores, você aprendeu como as variáveis globais e contextuais armazenam valores únicos. O terceiro tipo de variável, coleções, permite que você armazene uma tabela de dados. Isso é ideal quando você precisa armazenar grandes quantidades de dados estruturados para reutilização em seu aplicativo. Esses dados podem vir diretamente de uma fonte de dados, ser criados no aplicativo ou ser uma combinação de ambos.

Como usar coleções para aumentar o desempenho

O motivo mais comum para usar coleções é otimizar o desempenho reduzindo as chamadas à mesma tabela em uma fonte de dados. Por exemplo, se você tiver uma tabela que armazena todos os seus projetos ativos e desejar referenciar essa lista várias vezes em seu aplicativo, você deverá considerar a consulta desses dados uma vez e seu armazenamento em uma coleção. Para armazenar uma cópia da tabela Projetos da fonte de dados em uma coleção chamada collectProjects, use a fórmula a seguir.

Collect(collectProjects, Projects)

Isso criará uma coleção chamada collectProjects que terá as mesmas linhas e colunas da tabela Projetos da fonte de dados. Estas são algumas considerações que você precisa entender sobre o uso de coleções:

  • A função Coleção não é delegável. Isso significa que, por padrão, somente os 500 primeiros registros da fonte de dados serão recuperados e armazenados na coleção. Para obter mais informações sobre como trabalhar com a delegação, consulte Trabalhar com limites de fonte de dados (limites de delegação) em um aplicativo de tela do Power Apps

  • As coleções não são vinculadas à fonte de dados após a sua criação. Isso significa que as alterações nos dados na coleção não são salvas automaticamente na fonte de dados. Isso inclui as alterações feitas nos dados. Caso deseje atualizar a fonte de dados com base nas alterações na coleção, você precisará criar fórmulas para fazer isso, como coletar novamente da fonte de dados.

  • As coleções são temporárias. Quando você fecha o aplicativo, a coleção e todo o seu conteúdo são removidos. Caso precise armazenar dados da coleção, você precisará gravá-los em uma fonte de dados antes de fechar o aplicativo.

Como usar coleções dinâmicas

As coleções não precisam vir de uma fonte de dados. Você também pode criar uma coleção com base nas informações diretamente em seu aplicativo. Isso geralmente é feito para fornecer valores para um menu suspenso ou uma caixa de combinação e armazenar grandes quantidades de dados antes da gravação em uma fonte de dados.

A criação de uma coleção com seus próprios dados é semelhante ao trabalho com os outros tipos de variáveis. A fórmula a seguir criará uma coleção chamada collectColors que corresponde à estrutura mostrada na tabela a seguir.

Collect(collectColors, {Name: "Shane", FavoriteColor: "Orange"},
{Name: "Mary", FavoriteColor: "Blue"}, {Name: "Oscar", FavoriteColor:
"Yellow"})
Nome Cor Favorita
Shane Laranja
Mary Azul
Oscar Amarelo

Depois de criar a coleção, você poderá reutilizá-la em todo o aplicativo. Isso também significa que todas as funções de tabela estão disponíveis para serem usadas. A única exceção em que as coleções são diferentes de fontes de dados de tabela é que não é possível usá-las com o controle Formulário.

Para obter mais informações sobre como trabalhar com coleções e com os dados de tabela que elas armazenam, confira Criar uma fórmula básica que usa tabelas e registros em um aplicativo de tela do Power Apps.

Além disso, as coleções armazenam dados de tabela sem diferenças em relação a fontes de dados de tabela. O roteiro de aprendizagem Trabalhar com os dados em um aplicativo de tela do Power Apps apresenta muitos conceitos que permitem que você trabalhe com coleções e estenda o poder delas.

Na unidade final deste módulo, você aprenderá mais alguns conceitos sobre variáveis e como aplicá-los aos seus aplicativos.