Funktionerna AddColumns, DropColumns, RenameColumns och ShowColumns i PowerAppsAddColumns, DropColumns, RenameColumns, and ShowColumns functions in PowerApps

Utformar en tabell genom att lägga till, släppa, byta namn på och markera dess kolumner.Shapes a table by adding, dropping, renaming, and selecting its columns.

ÖversiktOverview

Dessa funktioner utformar en tabell genom att justera dess kolumner:These functions shape a table by adjusting its columns:

  • Reducera en tabell som innehåller flera kolumner till en kolumn för användning med funktioner för en enda kolumn, exempelvis Lower eller Abs.Reduce a table that contains multiple columns down to a single column for use with single-column functions, such as Lower or Abs.
  • Lägg till en beräknad kolumn i en tabell (till exempel en kolumn för Totalpris som visar resultatet av att multiplicera Kvantitet med Enhetspris).Add a calculated column to a table (for example, a Total Price column that shows the results of multiplying Quantity by Unit Price).
  • Byt namn på en kolumn till ett mer beskrivande, för att visa för användare eller för användning i formler.Rename a column to something more meaningful, for display to users or for use in formulas.

En tabell är ett värde i PowerApps, precis som en sträng eller ett tal.A table is a value in PowerApps, just like a string or a number. Du kan ange en tabell som ett argument i en formel och funktioner kan returnera en tabell som ett resultat.You can specify a table as an argument in a formula, and functions can return a table as a result. De funktioner som beskrivs i det här avsnittet ändrar inte en tabell.The functions that this topic describes don't modify a table. I stället tar de en tabell som argument och returnerar en ny tabell med en transformering tillämpad.Instead they take a table as an argument and return a new table with a transform applied. Mer information finns i Arbeta med tabeller.See working with tables for more details.

Du kan inte ändra kolumner i en datakälla genom att använda dessa funktioner.You can't modify the columns of a data source by using these functions. Du måste ändra data vid dess källa.You must modify the data at its source. Du kan lägga till kolumner i en samling med funktionen Collect.You can add columns to a collection with the Collect function. Du hittar mer information i arbeta med datakällor.See working with data sources for more details.

BeskrivningDescription

Funktionen AddColumns lägger till en kolumn i en tabell, och en formel definierar värdena i kolumnen.The AddColumns function adds a column to a table, and a formula defines the values in that column. Befintliga kolumner förblir oförändrade.Existing columns remain unmodified.

Formeln utvärderas för varje post i tabellen.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.

Funktionen DropColumns utesluter kolumner från en tabell.The DropColumns function excludes columns from a table. Alla andra kolumner förblir oförändrade.All other columns remain unmodified. DropColumns utesluter kolumner och ShowColumns inkluderar kolumner.DropColumns excludes columns, and ShowColumns includes columns.

Funktionen RenameColumns byter namn på kolumnerna i en tabell.The RenameColumns function renames columns of a table. Alla kolumner bibehåller sina ursprungliga namn.All other columns retain their original names.

Funktionen ShowColumns innehåller kolumner för en tabell och släpper alla andra kolumner.The ShowColumns function includes columns of a table and drops all other columns. Du kan använda ShowColumns för att skapa en tabell med en kolumn från en tabell med flera kolumner.You can use ShowColumns to create a single-column table from a multi-column table. ShowColumns inkluderar kolumner, och DropColumns utesluter kolumner.ShowColumns includes columns, and DropColumns excludes columns.

För alla dessa funktioner är resultatet en ny tabell med transformering tillämpad.For all these functions, the result is a new table with the transform applied. Den ursprungliga tabellen ändras inte.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.

SyntaxSyntax

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

  • Table – obligatoriskt.Table - Required. Tabell som ska användas.Table to operate on.
  • ColumnName(s) – obligatoriskt.ColumnName(s) - Required. Namnen på kolumnerna som du lägger till.Name(s) of the column(s) to add. Du måste ange en sträng (till exempel "Namn" med dubbla citattecken inkluderade) för det här argumentet.You must specify a string (for example, "Name" with double quotes included) for this argument.
  • Formula(s) – obligatoriskt.Formula(s) - Required. Formler ska utvärderas för varje post.Formula(s) to evaluate for each record. Resultatet läggs till som värdet för den nya motsvarande kolumnen.The result is added as the value of the corresponding new column. Du kan referera till andra kolumner i tabellen i den här formeln.You can reference other columns of the table in this formula.

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

  • Table – obligatoriskt.Table - Required. Tabell som ska användas.Table to operate on.
  • ColumnName(s) – obligatoriskt.ColumnName(s) - Required. Namnen på kolumnerna som du släpper.Name(s) of the column(s) to drop. Du måste ange en sträng (till exempel "Namn" med dubbla citattecken inkluderade) för det här argumentet.You must specify a string (for example, "Name" with double quotes included) for this argument.

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

  • Table – obligatoriskt.Table - Required. Tabell som ska användas.Table to operate on.
  • OldColumnName – obligatoriskt.OldColumnName - Required. Namnet på kolumnen som ska byta namn.Name of the column to rename. Det här namnet måste vara en sträng (till exempel "Namn" med dubbla citattecken inkluderade).This name must be a string (for example "Name" with double quotes included).
  • NewColumnName – obligatoriskt.NewColumnName - Required. Ersättningsnamn.Replacement name. Du måste ange en sträng (till exempel "Kundnamn" med dubbla citattecken inkluderade) för det här argumentet.You must specify a string (for example, "Customer Name" with double quotes included) for this argument.

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

  • Table – obligatoriskt.Table - Required. Tabell som ska användas.Table to operate on.
  • ColumnName(s) – obligatoriskt.ColumnName(s) - Required. Namnen på kolumnerna som ska ingå.Name(s) of the column(s) to include. Du måste ange en sträng (till exempel "Namn" med dubbla citattecken inkluderade) för det här argumentet.You must specify a string (for example, "Name" with double quotes included) for this argument.

ExempelExamples

Exemplen i det här avsnittet använder datakällan IceCreamSales som innehåller data i den här tabellen:The examples in this section use the IceCreamSales data source, which contains the data in this table:

Inget av de här exemplen ändrar datakällan IceCreamSales.None of these examples modify the IceCreamSales data source. Varje funktion transformerar värdet för datakällan som en tabell och returnerar värdet som ett resultat.Each function transforms the value of the data source as a table and returns that value as the result.

FormelFormula BeskrivningDescription ResultatResult
AddColumns( IceCreamSales, "Intäkt", UnitPrice * QuantitySold )AddColumns( IceCreamSales, "Revenue", UnitPrice * QuantitySold ) Lägger till en kolumn med Intäkter till resultatet.Adds a Revenue column to the result. För varje post utvärderas UnitPrice * QuantitySold och resultatet placeras i den nya kolumnen.For each record, UnitPrice * QuantitySold is evaluated, and the result is placed in the new column.
DropColumns (IceCreamSales, "Enhetspris")DropColumns( IceCreamSales, "UnitPrice" ) Omfattar inte kolumnen Enhetspris från resultatet.Excludes the UnitPrice column from the result. Använd den här funktionen för att utesluta kolumner och använd ShowColumns för att inkludera dem.Use this function to exclude columns, and use ShowColumns to include them.
ShowColumns (IceCreamSales "Flavor")ShowColumns( IceCreamSales, "Flavor" ) Innehåller endast kolumnen Flavor i resultatet.Includes only the Flavor column in the result. Använd den här funktionen för att inkludera kolumner och använd DropColumns för att exkludera dem.Use this function include columns, and use DropColumns to exclude them.
RenameColumns (IceCreamSales, "Enhetspris", "Pris")RenameColumns( IceCreamSales, "UnitPrice", "Price") Byter namn på kolumnen Enhetspris i resultatet.Renames the UnitPrice colum in the result.
DropColumns(
RenameColumns(
AddColumns( IceCreamSales, "Intäkt",
UnitPrice * QuantitySold ),
"Enhetspris", "Pris" ),
"Kvantitet" )
DropColumns(
RenameColumns(
AddColumns( IceCreamSales, "Revenue",
UnitPrice * QuantitySold ),
"UnitPrice", "Price" ),
"Quantity" )
Utför följande tabelltransformeringar i ordning. Starta inuti formeln:Performs the following table transforms in order, starting from the inside of the formula:
  1. Lägger till en kolumn med Intäkter baserat på beräkning per post av UnitPrice * Antal.Adds a Revenue column based on the per-record calculation of UnitPrice * Quantity.
  2. Byter namn på Enhetspris till Pris.Renames UnitPrice to Price.
  3. Omfattar inte kolumnen Kvantitet.Excludes the Quantity column.
Observera att ordningen är viktig.Note that order is important. Vi kan till exempel inte beräkna med Enhetspris när den har bytt namn.For example, we can't calculate with UnitPrice after it has been renamed.

Steg för stegStep by step

  1. Importera eller skapa en samling med namnet Inventory, som den första delproceduren Visa test och bilder i ett galleri beskriver.Import or create a collection named Inventory as the first subprocedure in Show text and images in a gallery describes.
  2. Lägg till en knapp och ge dess egenskap OnSelect egenskapen följande formel:Add a button, and set its OnSelect property to this formula:

    ClearCollect(Inventory2, RenameColumns(Inventory, "ProductName", "JacketID"))ClearCollect(Inventory2, RenameColumns(Inventory, "ProductName", "JacketID"))

  3. Tryck på F5, klicka på knappen som du nyss skapade och tryck på Esc för att återgå till designarbetsytan.Press F5, select the button that you just created, and then press Esc to return to the design workspace.
  4. På menyn Arkiv väljer du Samlingar.On the File menu, select Collections.
  5. Bekräfta att du har skapat en samling med namnet Inventory2.Confirm that you've created a collection, named Inventory2. Den nya samlingen innehåller samma information som Inventory förutom att kolumnen med namnet ProductName i Inventory heter JacketID i Inventory2.The new collection contains the same information as Inventory except that the column named ProductName in Inventory is named JacketID in Inventory2.