Funções AddColumns, DropColumns, RenameColumns e ShowColumns no PowerAppsAddColumns, DropColumns, RenameColumns, and ShowColumns functions in PowerApps

Forma uma tabela ao adicionar, remover, renomear e selecionar as suas colunas.Shapes a table by adding, dropping, renaming, and selecting its columns.

Visão geralOverview

Essas funções formam uma tabela ajustando suas colunas:These functions shape a table by adjusting its columns:

  • 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.Reduce a table that contains multiple columns down to a single column for use with single-column functions, such as Lower or 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).Add a calculated column to a table (for example, a Total Price column that shows the results of multiplying Quantity by Unit Price).
  • Renomeie uma coluna para algo mais significativo, para exibir aos usuários ou para uso em fórmulas.Rename a column to something more meaningful, for display to users or for use in formulas.

Uma tabela é um valor no PowerApps, assim como uma cadeia de caracteres ou um número.A table is a value in PowerApps, just like a string or a number. Você pode especificar uma tabela como um argumento em uma fórmula e funções podem retornar uma tabela como resultado.You can specify a table as an argument in a formula, and functions can return a table as a result. As funções descritas neste tópico não modificam uma tabela.The functions that this topic describes don't modify a table. Em vez disso, eles consideram uma tabela como um argumento e retornam uma nova tabela com uma transformação aplicada.Instead they take a table as an argument and return a new table with a transform applied. Consulte Trabalhando com tabelas para obter mais detalhes.See working with tables for more details.

Você não pode modificar as colunas de uma fonte de dados usando essas funções.You can't modify the columns of a data source by using these functions. Você deve modificar os dados em sua origem.You must modify the data at its source. Você pode adicionar colunas a uma coleção com a função Collect.You can add columns to a collection with the Collect function. Confira Como trabalhar com fontes de dados para obter mais detalhes.See working with data sources for more details.

DescriçãoDescription

A função AddColumns adiciona uma coluna a uma tabela, e uma fórmula define os valores dessa coluna.The AddColumns function adds a column to a table, and a formula defines the values in that column. As colunas existentes permanecem inalteradas.Existing columns remain unmodified.

A fórmula é avaliada para cada registro da tabela.The formula is evaluated for each record of the table.

Fields of the record currently being processed are available within the formula. You simply reference them by name as you would any other value. You can also reference control properties and other values from throughout your app. For more details, see the examples below and working with record scope.

A função DropColumns remove colunas de uma tabela.The DropColumns function excludes columns from a table. Todas as outras colunas permanecem inalteradas.All other columns remain unmodified. DropColumns remove colunas, e ShowColumns inclui colunas.DropColumns excludes columns, and ShowColumns includes columns.

A função RenameColumns renomeia as colunas de uma tabela.The RenameColumns function renames columns of a table. Todas as outras colunas permanecem com seus nomes originais.All other columns retain their original names.

A função ShowColumns inclui colunas de uma tabela e remove todas as outras colunas.The ShowColumns function includes columns of a table and drops all other columns. Você pode usar aShowColumns para criar uma tabela de coluna única a partir de uma tabela de várias colunas.You can use ShowColumns to create a single-column table from a multi-column table. ShowColumns inclui colunas, e DropColumns remove colunas.ShowColumns includes columns, and DropColumns excludes columns.

Para todas essas funções, o resultado é uma nova tabela com uma transformação aplicada.For all these functions, the result is a new table with the transform applied. A tabela original não é modificada.The original table isn't modified.

When used with a data source, these functions can't be delegated. Only the first portion of the data source will be retrieved and then the function applied. The result may not represent the complete story. A blue dot will appear at authoring time to remind you of this limitation and to suggest switching to delegable alternatives where possible. For more information, see the delegation overview.

SintaxeSyntax

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

  • Table – Obrigatório.Table - Required. Tabela na qual operar.Table to operate on.
  • ColumnName(s) – Obrigatório.ColumnName(s) - Required. Nomes de colunas para adicionar.Name(s) of the column(s) to add. Você deve especificar uma cadeia de caracteres (por exemplo, "Nome" com aspas duplas incluídas) para esse argumento.You must specify a string (for example, "Name" with double quotes included) for this argument.
  • Fórmulas - obrigatório.Formula(s) - Required. Fórmulas para avaliar cada registro.Formula(s) to evaluate for each record. O resultado é adicionado como o valor da nova coluna correspondente.The result is added as the value of the corresponding new column. Você pode fazer referência a outras colunas da tabela nesta fórmula.You can reference other columns of the table in this formula.

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

  • Table – Obrigatório.Table - Required. Tabela na qual operar.Table to operate on.
  • ColumnName(s) – Obrigatório.ColumnName(s) - Required. Nomes de colunas para remover.Name(s) of the column(s) to drop. Você deve especificar uma cadeia de caracteres (por exemplo, "Nome" com aspas duplas incluídas) para esse argumento.You must specify a string (for example, "Name" with double quotes included) for this argument.

RenameColumns( Tabela, OldColumneName, NewColumnName )RenameColumns( Table, OldColumneName, NewColumnName )

  • Table – Obrigatório.Table - Required. Tabela na qual operar.Table to operate on.
  • OldColumnName – Obrigatório.OldColumnName - Required. Nome da coluna para renomear.Name of the column to rename. Esse nome deve ser uma cadeia de caracteres (por exemplo "Nome" com aspas duplas incluídas).This name must be a string (for example "Name" with double quotes included).
  • NewColumnName – Obrigatório.NewColumnName - Required. Nome de substituição.Replacement name. Você deve especificar uma cadeia de caracteres (por exemplo, "Nome do Cliente" com aspas duplas incluídas) para esse argumento.You must specify a string (for example, "Customer Name" with double quotes included) for this argument.

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

  • Table – Obrigatório.Table - Required. Tabela na qual operar.Table to operate on.
  • ColumnName(s) – Obrigatório.ColumnName(s) - Required. Nomes de colunas a serem incluídas.Name(s) of the column(s) to include. Você deve especificar uma cadeia de caracteres (por exemplo, "Nome" com aspas duplas incluídas) para esse argumento.You must specify a string (for example, "Name" with double quotes included) for this argument.

ExemplosExamples

Os exemplos desta seção usam a fonte de dados VendasdeSorvete que contém os seguintes dados nesta tabela:The examples in this section use the IceCreamSales data source, which contains the data in this table:

Nenhum desses exemplos modificam a fonte de dados VendasdeSorvete.None of these examples modify the IceCreamSales data source. Cada função transforma o valor da fonte de dados em uma tabela e retorna esse valor como resultado.Each function transforms the value of the data source as a table and returns that value as the result.

FórmulaFormula DescriçãoDescription ResultadoResult
AddColumns( VendasdeSorvete, "Receita", PreçoUnitário * QuantidadeVendida )AddColumns( IceCreamSales, "Revenue", UnitPrice * QuantitySold ) Adiciona uma coluna Receita no resultado.Adds a Revenue column to the result. Para cada registro, PreçoUnitário * QuantidadeVendida são avaliados e o resultado é colocado na nova coluna.For each record, UnitPrice * QuantitySold is evaluated, and the result is placed in the new column.
DropColumns( VendasdeSorvete, "PreçoUnitário")DropColumns( IceCreamSales, "UnitPrice" ) Exclui a coluna PreçoUnitário do resultado.Excludes the UnitPrice column from the result. Use esta função para excluir colunas e use ShowColumns para incluí-las.Use this function to exclude columns, and use ShowColumns to include them.
ShowColumns( VendasdeSorvete, "Sabor")ShowColumns( IceCreamSales, "Flavor" ) Inclui somente a coluna Sabor no resultado.Includes only the Flavor column in the result. Use essa função para incluir colunas, e a função DropColumns para removê-las.Use this function include columns, and use DropColumns to exclude them.
RenameColumns ("VendasdeSorvete "PreçoUnitário", "Preço")RenameColumns( IceCreamSales, "UnitPrice", "Price") Renomeie a coluna PreçoUnitário no resultado.Renames the UnitPrice colum in the result.
DropColumns(
RenameColumns(
AddColumns( VendasdeSorvete, "Receita",
PreçoUnitário * QuantidadeVendida ),
"PreçoUnitário", "Preço" ),
"Quantidade" )
DropColumns(
RenameColumns(
AddColumns( IceCreamSales, "Revenue",
UnitPrice * QuantitySold ),
"UnitPrice", "Price" ),
"Quantity" )
Executa as seguintes transformações de tabela em ordem, começando por essa fórmula:Performs the following table transforms in order, starting from the inside of the formula:
  1. Adiciona uma coluna Receita com base no cálculo por registro de PreçoUnitário * Quantidade.Adds a Revenue column based on the per-record calculation of UnitPrice * Quantity.
  2. Renomeia PreçoUnitário para Preço.Renames UnitPrice to Price.
  3. Exclui a coluna Quantidade.Excludes the Quantity column.
Observe que a ordem é importante.Note that order is important. Por exemplo, não podemos calcular com PreçoUnitário depois que ela foi renomeada.For example, we can't calculate with UnitPrice after it has been renamed.

Passo a passoStep by step

  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.Import or create a collection named Inventory as the first subprocedure in Show text and images in a gallery describes.
  2. Adicione um botão e defina a propriedade OnSelect para esta fórmula:Add a button, and set its OnSelect property to this formula:

    ClearCollect(Inventário2, RenameColumns(Inventário, "NomedoProduto", "JacketID"))ClearCollect(Inventory2, RenameColumns(Inventory, "ProductName", "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.Press F5, select the button that you just created, and then press Esc to return to the design workspace.
  4. No menu Arquivo, selecione Coleções.On the File menu, select Collections.
  5. Confirme que você criou uma coleção, chamada Inventário2.Confirm that you've created a collection, named Inventory2. 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.The new collection contains the same information as Inventory except that the column named ProductName in Inventory is named JacketID in Inventory2.