Criar e atualizar uma coleção numa aplicação de tela

Utilize uma coleção para armazenar dados que os utilizadores possam gerir na sua aplicação. Uma colecção é um grupo de itens semelhantes, tais como produtos numa lista de produtos. Para mais informações sobre diferentes tipos de variáveis, tais como coleções: Compreender as variáveis de aplicações de tela.

Pré-requisitos

• Inscreva-se no Power Apps e, em seguida, inicie sessão com as mesmas credenciais que utilizou para se inscrever.
• Criar uma aplicação ou abrir uma aplicação existente no Power Apps.
• Saiba como configurar um controlo no Power Apps.

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

Criar uma coleção com várias colunas

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

2. Mude o nome do controlo selecionando as reticências no painel de navegação esquerdo, selecionando Renomear e, em seguida, escrevendo ProductName.

   

3. Adicionar um controlo Pendente.

   

4. Mude o nome das Cores do controlo Pendente e certifique-se de que 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 controlo de Botão, defina a respetiva propriedade Texto como "Adicionar" e defina a respetiva propriedade OnSelect como esta fórmula:

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

7. Prima F5 ou selecione o botão Reproduzir para pré-visualizar a aplicação. Escreva algum texto em ProductName, selecione uma opção em Cores e, em seguida, selecione Adicionar.

   

8. Repita o passo anterior, pelo menos, mais duas vezes e, em seguida, prima Esc.

9. Selecione o painel Variáveis e, em seguida, selecione Coleções para ver as coleções que criou.

   

Mostrar uma coleção

1. Selecione o controlo Inserir>Galeria vertical.

2. Defina a propriedade Items da galeria como ProductList.

3. Selecione a galeria na vista de árvore e, em seguida, selecione Campos. 1. Defina o campo de legenda como Cor e defina o campo de título como Produto.

   

4. Selecione em Esquema>Título e legenda.

   

   O ecrã é parecido com este exemplo:

   

Remover um ou todos os itens

1. Selecione a galeria e adicione um ícone de Lixo ao modelo de galeria.

   

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

   Remove(ProductList, ThisItem)

3. Fora da galeria, adicione um botão, defina a respetiva propriedade Texto como "Limpar" e defina a respetiva propriedade OnSelect como esta fórmula:

   Clear(ProductList)

4. Mantendo a tecla Alt pressionada, selecione o ícone Lixo para 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 numa coleção

1. Criar uma ligação a uma lista criada utilizando Listas Microsoft.

2. Adicione um botão e defina a respetiva propriedade OnSelect para esta função, ao substituir ListName pelo nome da sua lista:
   

   Collect(MySPCollection, ListName)

   Esta função cria uma coleção com o nome MySPCollection que contém os mesmos dados que a lista.

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

Para obter informações sobre como mostrar dados a partir de Listas Microsoft ou do SharePoint (por exemplo, datas, escolhas e pessoas) numa galeria: Mostrar colunas de listas numa galeria. Para obter informações sobre como mostrar dados num formulário (com listas pendentes, seletores de datas e seletores de pessoas): Controlos Mostrar formulário e Editar formulário.

Passos seguintes

• Consulte o tópico de referência para a função Collect.
• Obter informações sobre como formar dados numa coleção utilizando as funções AddColumns, DropColumns, RenameColumns e ShowColumns.