Funkcie AddColumns, DropColumns, RenameColumns a ShowColumns v službe PowerAppsAddColumns, DropColumns, RenameColumns, and ShowColumns functions in PowerApps

Tieto funkcie tvarujú tabuľku pridaním, vylúčením, premenovaním alebo zahrnutím jej stĺpcov.Shapes a table by adding, dropping, renaming, and selecting its columns.

PrehľadOverview

Tieto funkcie tvarujú tabuľku upravovaním jej stĺpcov:These functions shape a table by adjusting its columns:

  • Zmenšenie tabuľky, ktorá obsahuje viacero stĺpcov, na jednostĺpcovú tabuľku, aby sa dala použiť s jednostĺpcovými funkciami, ako je Lower alebo Abs.Reduce a table that contains multiple columns down to a single column for use with single-column functions, such as Lower or Abs.
  • Pridanie vypočítaného stĺpca do tabuľky (napríklad stĺpca Celková cena, ktorý ukazuje výsledky násobenia stĺpcov Množstvo a Jednotková cena).Add a calculated column to a table (for example, a Total Price column that shows the results of multiplying Quantity by Unit Price).
  • Premenovanie stĺpca na niečo zmysluplnejšie, ak sa má zobraziť používateľom alebo použiť vo vzorcoch.Rename a column to something more meaningful, for display to users or for use in formulas.

Tabuľka je v PowerApps hodnotou, rovnako ako napríklad reťazec alebo číslo.A table is a value in PowerApps, just like a string or a number. Tabuľku môžete zadať ako argument vo vzorci a funkcie môžu ako výsledok vrátiť tabuľku.You can specify a table as an argument in a formula, and functions can return a table as a result. Funkcie, ktoré táto téma popisuje, neupravujú tabuľku.The functions that this topic describes don't modify a table. Namiesto toho používajú tabuľku ako argument a vracajú novú tabuľku s použitou transformáciou.Instead they take a table as an argument and return a new table with a transform applied. Ďalšie podrobnosti nájdete v časti venovanej práci s tabuľkami.See working with tables for more details.

Pomocou týchto funkcií nie je možné upravovať stĺpce zdroja údajov.You can't modify the columns of a data source by using these functions. Musíte upraviť údaje v ich zdroji.You must modify the data at its source. Môžete pridať stĺpce do kolekciepomocou funkcie Collect.You can add columns to a collection with the Collect function. Ďalšie podrobnosti nájdete v časti venovanej práci so zdrojmi údajov.See working with data sources for more details.

PopisDescription

Funkcia AddColumns pridá stĺpec do tabuľky a vzorec zadefinuje hodnoty v tomto stĺpci.The AddColumns function adds a column to a table, and a formula defines the values in that column. Existujúce stĺpce zostanú nezmenené.Existing columns remain unmodified.

Vzorec sa vyhodnotí pre každý záznam tabuľky.The formula is evaluated for each record of the table.

Polia záznamu, ktorý sa momentálne spracúva, sú k dispozícii v rámci vzorca. Jednoducho môžete na ne odkázať pomocou názvu, rovnako ako v prípade hociktorej inej hodnoty. V rámci aplikácie môžete tiež odkázať na vlastnosti ovládacích prvkov a ďalšie hodnoty. Ďalšie podrobnosti nájdete v príkladoch nižšie a v téme, ako pracovať s rozsahom záznamu.

Funkcia DropColumns vylúči stĺpce z tabuľky.The DropColumns function excludes columns from a table. Všetky ostatné stĺpce zostanú nezmenené.All other columns remain unmodified. Funkcia DropColumns vylúči stĺpce a funkcia ShowColumns zahrnie stĺpce.DropColumns excludes columns, and ShowColumns includes columns.

Ak chcete v tabuľke premenovať jeden alebo viac stĺpcov, použite funkciu RenameColumns. Zadajte aspoň jeden pár argumentov udávajúci názov stĺpca, ktorý tabuľka obsahuje (starý názov, ktorý chcete zmeniť), a názov stĺpca, ktorý tabuľka neobsahuje (nový názov, ktorý chcete použiť).Use the RenameColumns function to rename one or more columns of a table by providing at least one argument pair that specifies the name of a column that the table contains (the old name, which you want to replace) and the name of a column that the table doesn't contain (the new name, which you want to use). Starý názov musí v tabuľke existovať a nový naopak nesmie.The old name must already exist in the table, and the new name must not exist. Názov každého stĺpca môže byť v zozname argumentov uvedený iba raz, a to buď ako starý názov, alebo nový názov.Each column name may appear only once in the argument list as either an old column name or a new column name. Ak chcete stĺpec pomenovať názvom už existujúceho stĺpca, najprv existujúci stĺpec vylúčte pomocou funkcie DropColumns alebo ho premenujte vnorením jednej funkcie RenameColumns do druhej.To rename a column to an existing column name, first drop the existing column with DropColumns, or rename the existing column out of the way by nesting one RenameColumns function within another.

Funkcia ShowColumns zahrnie stĺpce tabuľky a vylúči všetky ostatné stĺpce.The ShowColumns function includes columns of a table and drops all other columns. Funkciu ShowColumns môžete použiť na to, aby ste vytvorili jednostĺpcovú tabuľku z tabuľky s viacerými stĺpcami.You can use ShowColumns to create a single-column table from a multi-column table. Funkcia ShowColumns zahrnie stĺpce a funkcia DropColumns vylúči stĺpce.ShowColumns includes columns, and DropColumns excludes columns.

Výsledkom všetkých týchto funkcií je tabuľka s použitou transformáciou.For all these functions, the result is a new table with the transform applied. Pôvodná tabuľka sa neupraví.The original table isn't modified.

Tieto funkcie nemožno delegovať, keď sa používajú so zdrojom údajov. Načíta sa iba prvá časť zdroja údajov a potom sa použije príslušná funkcia. Výsledok nemusí predstavovať úplný obsah. V čase vytvárania sa zobrazí modrá bodka, ktorá vám pripomenie toto obmedzenie a navrhne vám prepnúť na alternatívy, ktoré možno delegovať (ak je to možné). Ďalšie informácie nájdete v prehľade delegovania.

SyntaxSyntax

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

  • Table – povinné.Table - Required. Tabuľka, s ktorou sa má urobiť výpočet.Table to operate on.
  • ColumnName(s) – povinné.ColumnName(s) - Required. Názov stĺpca, ktorý sa má pridať.Name(s) of the column(s) to add. Pre tento argument musíte zadať reťazec (napríklad "Názov", vrátane úvodzoviek).You must specify a string (for example, "Name" with double quotes included) for this argument.
  • Formula(s) - povinné.Formula(s) - Required. Vzorec, ktorý sa má vyhodnotiť pre každý záznam.Formula(s) to evaluate for each record. Výsledok sa pridá ako hodnota príslušného nového stĺpca.The result is added as the value of the corresponding new column. V tomto vzorci môžete odkazovať na iné stĺpce tabuľky.You can reference other columns of the table in this formula.

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

  • Table – povinné.Table - Required. Tabuľka, s ktorou sa má urobiť výpočet.Table to operate on.
  • ColumnName(s) – povinné.ColumnName(s) - Required. Názov stĺpca, ktorý sa má vylúčiť.Name(s) of the column(s) to drop. Pre tento argument musíte zadať reťazec (napríklad "Názov", vrátane úvodzoviek).You must specify a string (for example, "Name" with double quotes included) for this argument.

RenameColumns( Table, OldColumneName1, NewColumnName1 [, OldColumneName2, NewColumnName2, ... ] )RenameColumns( Table, OldColumneName1, NewColumnName1 [, OldColumnName2, NewColumnName2, ... ] )

  • Table – povinné.Table - Required. Tabuľka, s ktorou sa má urobiť výpočet.Table to operate on.
  • OldColumnName – povinné.OldColumnName - Required. Názov stĺpca v pôvodnej tabuľke, ktorý sa má premenovať.Name of a column to rename from the original table. Tento prvok sa v páre argumentov uvádza ako prvý (ak vzorec obsahuje viac než jeden pár argumentov, uvádza sa ako prvý v každom páre).This element appears first in the argument pair (or first in each argument pair if the formula includes more than one pair). Názov sa musí uviesť v podobe reťazca (napríklad "Názov" vrátane úvodzoviek).This name must be a string (for example "Name" with double quotation marks included).
  • NewColumnName – povinné.NewColumnName - Required. Náhradný názov.Replacement name. Tento prvok sa v páre argumentov uvádza ako posledný (ak vzorec obsahuje viac než jeden pár argumentov, uvádza sa ako posledný v každom páre).This element appears last in the argument pair (or last in each argument pair if the formula includes more than one pair). Pre tento argument musíte zadať reťazec (napríklad "Meno zákazníka" vrátane úvodzoviek).You must specify a string (for example, "Customer Name" with double quotation marks included) for this argument.

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

  • Table – povinné.Table - Required. Tabuľka, s ktorou sa má urobiť výpočet.Table to operate on.
  • ColumnName(s) – povinné.ColumnName(s) - Required. Názov stĺpca, ktorý sa má zahrnúť.Name(s) of the column(s) to include. Pre tento argument musíte zadať reťazec (napríklad "Názov", vrátane úvodzoviek).You must specify a string (for example, "Name" with double quotes included) for this argument.

PríkladyExamples

V nasledujúcich príkladoch použijeme zdroj údajov IceCreamSales (PredajZmrzliny), ktorý obsahuje údaje v tejto tabuľke:The examples in this section use the IceCreamSales data source, which contains the data in this table:

Ani jeden z týchto príkladov neupraví zdroj údajov IceCreamSales.None of these examples modify the IceCreamSales data source. Každá funkcia transformuje hodnotu zdroja údajov ako tabuľku a vráti túto hodnotu ako výsledok.Each function transforms the value of the data source as a table and returns that value as the result.

VzorecFormula PopisDescription VýsledokResult
AddColumns( IceCreamSales, "Revenue", UnitPrice * QuantitySold )AddColumns( IceCreamSales, "Revenue", UnitPrice * QuantitySold ) Pridá do výsledku stĺpec Revenue (Výnos).Adds a Revenue column to the result. Pre každý záznam sa vyhodnotí súčin jednotkovej ceny a predaného množstva (UnitPrice * QuantitySold) a výsledok sa umiestni do nového stĺpca.For each record, UnitPrice * QuantitySold is evaluated, and the result is placed in the new column.
DropColumns( IceCreamSales, "UnitPrice" )DropColumns( IceCreamSales, "UnitPrice" ) Vylúči z výsledku stĺpec UnitPrice (JednotkováCena).Excludes the UnitPrice column from the result. Pomocou tejto funkcie môžete vylúčiť stĺpce a pomocou funkcie ShowColumns ich môžete zahrnúť.Use this function to exclude columns, and use ShowColumns to include them.
ShowColumns( IceCreamSales, "Flavor" )ShowColumns( IceCreamSales, "Flavor" ) Zahrnie do výsledku iba stĺpec Flavor (Chuť).Includes only the Flavor column in the result. Pomocou tejto funkcie môžete zahrnúť stĺpce a pomocou funkcie DropColumns ich môžete vylúčiť.Use this function include columns, and use DropColumns to exclude them.
RenameColumns( IceCreamSales, "UnitPrice", "Price")RenameColumns( IceCreamSales, "UnitPrice", "Price") Premenuje vo výsledku stĺpec UnitPrice (JednotkováCena).Renames the UnitPrice colum in the result.
RenameColumns( IceCreamSales, "UnitPrice", "Price", "QuantitySold", "Number")RenameColumns( IceCreamSales, "UnitPrice", "Price", "QuantitySold", "Number") Výsledkom sú premenované stĺpce UnitPrice a QuantitySold.Renames the UnitPrice and QuantitySold columns in the result.
DropColumns(
RenameColumns(
AddColumns( IceCreamSales, "Revenue",
UnitPrice * QuantitySold ),
"UnitPrice", "Price" ),
"Quantity" )
DropColumns(
RenameColumns(
AddColumns( IceCreamSales, "Revenue",
UnitPrice * QuantitySold ),
"UnitPrice", "Price" ),
"Quantity" )
Vykoná nasledujúce transformácie tabuľky v uvedenom poradí s tým, že začne uprostred vzorca:Performs the following table transforms in order, starting from the inside of the formula:
  1. Pridá stĺpec Revenue (Výnos), ktorý sa zakladá na vypočítaní súčinu UnitPrice * Quantity pre jednotlivé záznamy.Adds a Revenue column based on the per-record calculation of UnitPrice * Quantity.
  2. Premenuje stĺpec UnitPrice (JednotkováCena) na Price (Cena).Renames UnitPrice to Price.
  3. Vylúči stĺpec Quantity (Množstvo).Excludes the Quantity column.
Poradie je dôležité.Note that order is important. Nemôžeme napríklad použiť pri výpočte stĺpec UnitPrice (JednotkováCena) po tom, ako ho premenujeme.For example, we can't calculate with UnitPrice after it has been renamed.

Podrobný postupStep by step

  1. Naimportujte alebo vytvorte kolekciu s názvom Inventory podľa popisu v prvom podpostupe v článku o zobrazení textu a obrázkov v galérii.Import or create a collection named Inventory as the first subprocedure in Show text and images in a gallery describes.

  2. Pridajte tlačidlo a jeho vlastnosť OnSelect nastavte na tento vzorec:Add a button, and set its OnSelect property to this formula:

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

  3. Stlačte F5, vyberte tlačidlo, ktoré ste práve vytvorili a potom sa stlačením klávesu Esc vráťte do pracovného priestoru návrhu.Press F5, select the button that you just created, and then press Esc to return to the design workspace.

  4. V ponuke Súbor vyberte možnosť Kolekcie.On the File menu, select Collections.

  5. Skontrolujte, či ste vytvorili kolekciu s názvom Inventory2.Confirm that you've created a collection, named Inventory2. Nová kolekcia obsahuje rovnaké informácie ako kolekcia Inventory, ale stĺpec s názvom ProductName v kolekcii Inventory sa v kolekcii Inventory2 nazýva JacketID.The new collection contains the same information as Inventory except that the column named ProductName in Inventory is named JacketID in Inventory2.