Forma uma tabela ao adicionar, remover, renomear e selecionar as suas colunas.

Visão geral

Essas funções formam uma tabela ajustando suas colunas:

  • Reduza uma tabela que contenha várias colunas para uma única coluna para usá-la com funções de coluna única, como Lower ou Abs.
  • Adicione uma coluna calculada a uma tabela (por exemplo, uma coluna Preço total que mostra os resultados da multiplicação de Quantidade por Preço unitário).
  • Renomeie uma coluna para algo mais significativo, para exibir aos usuários ou para uso em fórmulas.

Uma tabela é um valor no PowerApps, assim como uma cadeia de caracteres ou um número. Você pode especificar uma tabela como um argumento em uma fórmula e funções podem retornar uma tabela como resultado. As funções descritas neste tópico não modificam uma tabela. Em vez disso, eles consideram uma tabela como um argumento e retornam uma nova tabela com uma transformação aplicada. Consulte Trabalhando com tabelas para obter mais detalhes.

Você não pode modificar as colunas de uma fonte de dados usando essas funções. Você deve modificar os dados em sua origem. Você pode adicionar colunas a uma coleção com a função Collect. Confira Como trabalhar com fontes de dados para obter mais detalhes.

Descrição

A função AddColumns adiciona uma coluna a uma tabela, e uma fórmula define os valores dessa coluna. As colunas existentes permanecem inalteradas.

A fórmula é avaliada para cada registro da tabela.

Os campos do registro que estão sendo atualmente processados estão disponíveis dentro da fórmula. Basta referenciá-los por nome como você faria com qualquer outro valor. Também é possível fazer referência a propriedades de controle e a outros valores de todo o seu aplicativo. Para obter mais detalhes, consulte os exemplos abaixo e trabalhando com escopo de registro.

A função DropColumns remove colunas de uma tabela. Todas as outras colunas permanecem inalteradas. DropColumns remove colunas, e ShowColumns inclui colunas.

A função RenameColumns renomeia as colunas de uma tabela. Todas as outras colunas permanecem com seus nomes originais.

A função ShowColumns inclui colunas de uma tabela e remove todas as outras colunas. Você pode usar aShowColumns para criar uma tabela de coluna única a partir de uma tabela de várias colunas. ShowColumns inclui colunas, e DropColumns remove colunas.

Para todas essas funções, o resultado é uma nova tabela com uma transformação aplicada. A tabela original não é modificada.

Quando usadas com uma fonte de dados, essas funções não podem ser delegadas. Somente a primeira parte da fonte de dados será recuperada, em seguida, a função é aplicada. O resultado pode não representar a história completa. Um ponto azul aparecerá no momento da criação para lembrá-lo sobre essa limitação e sugerir mudar para alternativas delegáveis onde for possível. Para obter mais informações, consulte a visão geral da delegação.

Sintaxe

AddColumns( Tabela, ColumnName1, Formula1 [, ColumnName2, Formula2, ... ] )

  • Table – Obrigatório. Tabela na qual operar.
  • ColumnName(s) – Obrigatório. Nomes de colunas para adicionar. Você deve especificar uma cadeia de caracteres (por exemplo, "Nome" com aspas duplas incluídas) para esse argumento.
  • Fórmulas - obrigatório. Fórmulas para avaliar cada registro. O resultado é adicionado como o valor da nova coluna correspondente. Você pode fazer referência a outras colunas da tabela nesta fórmula.

DropColumns( Tabela, ColumnName1 [, ColumnName2, ... ] )

  • Table – Obrigatório. Tabela na qual operar.
  • ColumnName(s) – Obrigatório. Nomes de colunas para remover. Você deve especificar uma cadeia de caracteres (por exemplo, "Nome" com aspas duplas incluídas) para esse argumento.

RenameColumns( Tabela, OldColumneName, NewColumnName )

  • Table – Obrigatório. Tabela na qual operar.
  • OldColumnName – Obrigatório. Nome da coluna para renomear. Esse nome deve ser uma cadeia de caracteres (por exemplo "Nome" com aspas duplas incluídas).
  • NewColumnName – Obrigatório. Nome de substituição. Você deve especificar uma cadeia de caracteres (por exemplo, "Nome do Cliente" com aspas duplas incluídas) para esse argumento.

ShowColumns( Tabela, ColumnName1 [, ColumnName2, ... ] )

  • Table – Obrigatório. Tabela na qual operar.
  • ColumnName(s) – Obrigatório. Nomes de colunas a serem incluídas. Você deve especificar uma cadeia de caracteres (por exemplo, "Nome" com aspas duplas incluídas) para esse argumento.

Exemplos

Os exemplos desta seção usam a fonte de dados VendasdeSorvete que contém os seguintes dados nesta tabela:

Nenhum desses exemplos modificam a fonte de dados VendasdeSorvete. Cada função transforma o valor da fonte de dados em uma tabela e retorna esse valor como resultado.

Fórmula Descrição Resultado
AddColumns( VendasdeSorvete, "Receita", PreçoUnitário * QuantidadeVendida ) Adiciona uma coluna Receita no resultado. Para cada registro, PreçoUnitário * QuantidadeVendida são avaliados e o resultado é colocado na nova coluna.
DropColumns( VendasdeSorvete, "PreçoUnitário") Exclui a coluna PreçoUnitário do resultado. Use esta função para excluir colunas e use ShowColumns para incluí-las.
ShowColumns( VendasdeSorvete, "Sabor") Inclui somente a coluna Sabor no resultado. Use essa função para incluir colunas, e a função DropColumns para removê-las.
RenameColumns ("VendasdeSorvete "PreçoUnitário", "Preço") Renomeie a coluna PreçoUnitário no resultado.
DropColumns(
RenameColumns(
AddColumns( VendasdeSorvete, "Receita",
PreçoUnitário * QuantidadeVendida ),
"PreçoUnitário", "Preço" ),
"Quantidade" )
Executa as seguintes transformações de tabela em ordem, começando por essa fórmula:
  1. Adiciona uma coluna Receita com base no cálculo por registro de PreçoUnitário * Quantidade.
  2. Renomeia PreçoUnitário para Preço.
  3. Exclui a coluna Quantidade.
Observe que a ordem é importante. Por exemplo, não podemos calcular com PreçoUnitário depois que ela foi renomeada.

Passo a passo

  1. Importe ou crie uma coleção chamada Inventário como o primeiro subprocedimento, para isso, leia o artigo Como mostrar texto e imagens em uma galeria.

  2. Adicione um botão e defina a propriedade OnSelect para esta fórmula:

    ClearCollect(Inventário2, RenameColumns(Inventário, "NomedoProduto", "JacketID"))

  3. Pressione F5, selecione o botão que você acabou de criar e, em seguida, pressione Esc para retornar ao espaço de trabalho de design.

  4. No menu Arquivo, selecione Coleções.

  5. Confirme que você criou uma coleção, chamada Inventário2. A nova coleção contém as mesmas informações que o Inventário, exceto a coluna nomeada NomedoProduto, que no Inventário é nomeada como JacketID no Inventário2.