Criar e atualizar uma coleção em um aplicativo de tela

Use uma coleção para armazenar dados que os usuários podem gerenciar em seu aplicativo. Uma coleção é um grupo de itens semelhantes, como produtos em uma lista de produtos. Para mais informações sobre diferentes tipos de variáveis, como coleções: Noções básicas sobre variáveis de aplicativo de tela.

Pré-requisitos

• Inscreva-se no Power Apps e depois entre fornecendo as mesmas credenciais que usou para se inscrever.
• Crie um aplicativo ou abra um aplicativo existente no Power Apps.
• Saiba como configurar um controle no Power Apps.

Assista a este vídeo para aprender como criar e atualizar uma coleção:

Criar uma coleção de várias colunas

1. No Power Apps Studio, adicione um controle Entrada de texto.

   

2. Renomeie o controle selecionando suas reticências no painel de navegação esquerdo, selecionando Renomear e, em seguida, digitando ProductName.

   

3. Adicione um controle Lista suspensa.

   

4. Renomeie o controle Lista suspensa para Colors e verifique se a propriedade Items está selecionada na lista de propriedades.

   

5. Na barra de fórmulas, substitua DropDownSample por esta expressão:

   ["Red","Green","Blue"]

6. Adicione um controle Botão, defina sua propriedade Text como "Add" e defina sua propriedade OnSelect como esta fórmula:

   Collect(
       ProductList,
       {
           Product: ProductName.Text,
           Color: Colors.Selected.Value
       }
   )
   

7. Pressione F5, digite algum texto em ProductName, selecione uma opção em Colors e selecione Add.

   

8. Repita a etapa anterior pelo menos mais duas vezes e pressione Esc.

9. Se estiver usando a versão preliminar do Power Apps Studio, selecione o painel Variáveis e Coleções para ver as coleções que você criou.

   

   Se estiver usando a versão clássica do Power Apps Studio, no menu Arquivo , selecione Coleções.

   

Mostrar uma coleção

1. Adicionar um controle Galeria vertical.

   

2. Defina a propriedade Items da galeria como ProductList.

3. No painel Dados, defina o campo de subtítulo como Color e defina o campo de título como Product.

   

4. Feche o painel Dados, selecione a galeria e defina o campo Layout como Title and subtitle.

   

   Sua tela deverá ser semelhante a este exemplo:

   

Remover um ou todos os itens

1. Selecione o modelo de galeria clicando ou tocando próximo à parte inferior da galeria e, depois, clicando ou tocando no ícone de lápis próximo ao canto superior esquerdo.

   

2. Adicione um ícone da Lixeira ao modelo da galeria.

   

3. Defina a propriedade OnSelect do ícone como esta fórmula:

   Remove(ProductList, ThisItem)

4. Fora da galeria, adicione um botão, defina sua propriedade Text como "Clear" e defina sua propriedade OnSelect como esta fórmula:

   Clear(ProductList)

5. Enquanto pressiona a tecla Alt, selecione o ícone da Lixeira de um item para remover esse item da coleção ou selecione o botão Limpar para remover todos os itens da coleção.

Colocar uma lista em uma coleção

1. Cria uma conexão a uma lista criada usando Listas da Microsoft.

2. Adicione um botão e defina sua propriedade OnSelect para essa função, substituindo ListName pelo nome da lista:
   

   Collect(MySPCollection, ListName)

   Essa função cria uma coleção denominada MySPCollection que contém os mesmos dados do que a lista.

3. Mantendo a tecla Alt pressionada, selecione o botão.

4. (opcional) Para visualizar a coleção que você criou, selecione Coleções no menu Arquivo.

Para obter informações de como mostrar dados das Listas da Microsoft ou do SharePoint (por exemplo, datas, opções e pessoas) em uma galeria: Mostrar dados em uma galeria. Para obter informações de como mostrar dados em um formulário (com listas suspensas, seletores de data e seletores de pessoas): Controles Editar formulário e Exibir formulário.

Próximas etapas

• Analise o tópico de referência para a função Collect.
• Saiba como modelar dados em uma coleção usando as funções AddColumns, DropColumns, RenameColumns e ShowColumns.