AddColumns, DropColumns, RenameColumns, a ShowColumns funkcie

Vzťahuje sa na: Aplikácie plátna Copilot Studio Desktop – postupy aplikácie riadené modelom, funkcie rozhrania Power Platform CLI Dataverse

Tvaruje tabuľku alebo záznam pridaním, vylúčením, premenovaním alebo výberom jej stĺpcov.

Funkciu ForAll možno použiť aj na tvarovanie tabuľky vrátením tabuľky nových záznamov vytvorených z existujúcich stĺpcov.

Prehľad

Tieto funkcie tvarujú tabuľku alebo záznam úpravou jej stĺpcov:

Zmenšite počet tabuliek alebo záznamov, ktoré obsahujú viacero stĺpcov, na jednostĺpcovú tabuľku a použite ich s jednostĺpcovými funkciami, ako je napríklad Lower (Dolná ) alebo Sqrt (Sqrt).
Pridanie vypočítaného stĺpca do tabuľky alebo záznamu (napríklad stĺpca Celková cena , ktorý zobrazuje výsledky násobenia stĺpcov Množstvoa Jednotková cena).
Premenovanie stĺpca na niečo zmysluplnejšie, ak sa má zobraziť používateľom alebo použiť vo vzorcoch.

Tabuľke je v hodnote Power Apps, rovnako ako napríklad reťazec alebo číslo. Tabuľku môžete zadať ako argument vo vzorci a funkcie môžu ako výsledok vrátiť tabuľku.

Poznámka

Funkcie, ktoré táto téma popisuje, neupravujú pôvodnú tabuľku. Namiesto toho používajú tabuľku ako argument a vracajú novú tabuľku s použitou transformáciou. Ďalšie informácie nájdete v časti práca s tabuľkami.

Pomocou týchto funkcií nie je možné upravovať stĺpce zdroja údajov. Musíte upraviť údaje v ich zdroji. Môžete pridať stĺpce do kolekcie pomocou funkcie Collect. Ďalšie informácie nájdete v časti práca so zdrojmi údajov.

Description

Funkcia AddColumns pridá stĺpec do tabuľky alebo záznamu a vzorec zadefinuje hodnoty v tomto stĺpci. Existujúce stĺpce zostanú nezmenené.

Vzorec sa vyhodnotí pre daný záznam alebo pre každý záznam zadanej tabuľky.

Polia záznamu, ktorý sa momentálne spracúva, sú k dispozícii v rámci vzorca. Použite operátor ThisRecord alebo jednoducho odkážte na polia podľa názvu, ako by ste urobili s ľubovoľnou inou hodnotou. Operátor As sa dá použiť aj na pomenovanie záznamu, ktorý sa práve spracúva, vďaka čomu môžete vytvoriť ľahšie pochopiteľný vzorec a sprístupniť vnorené záznamy. Ďalšie informácie 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 alebo záznamu. Všetky ostatné stĺpce zostanú nezmenené. DropColumns vylúči stĺpce a ShowColumns zahrnuje stĺpce.

RenameColumns Pomocou funkcie môžete premenovať jeden alebo viacero stĺpcov tabuľky alebo záznamu zadaním aspoň jedného páru argumentov určujúceho názov stĺpca, ktorý tabuľka alebo záznam obsahuje (starý názov, ktorý chcete nahradiť) a názov stĺpca, ktorý tabuľka alebo záznam neobsahuje (nový názov, ktoré chcete použiť). Starý názov už musí existovať v tabuľke alebo zázname a nový názov nesmie existovať. 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. Ak chcete stĺpec premenovať na názov existujúceho stĺpca, najprv existujúci stĺpec DropColumnsvylúčte alebo premenujte ho vnorením jednej RenameColumns funkcie do druhej.

Funkcia ShowColumns zahrnuje stĺpce tabuľky alebo záznamu a vráti všetky ostatné stĺpce. Tabuľku alebo záznam s jedným stĺpcom môžete použiť ShowColumns na vytvorenie tabuľky alebo záznamu s viacerými stĺpcami. ShowColumns zahŕňa stĺpce a DropColumns vylúči stĺpce.

Výsledkom všetkých týchto funkcií je nová tabuľka alebo záznam s použitou transformáciou. Pôvodná tabuľka alebo záznam sa neupraví. Pomocou vzorca nemôžete upraviť existujúcu tabuľku alebo záznam. SharePoint, Microsoft Dataverse, SQL Server a ďalšie zdroje údajov poskytujú nástroje na úpravu stĺpcov zoznamov a tabuliek, ktoré sa často označujú ako schéma. Funkcie v tejto téme transformujú len vstupnú tabuľku alebo záznam bez toho, aby sa upravila pôvodná tabuľka alebo záznam na ďalšie použitie.

Argumenty týkajúce sa týchto funkcií podporujú delegovanie. Napríklad funkcia Filter, ktorá sa používa ako argument na získanie prehľadov súvisiacich záznamov vo všetkých zoznamoch, aj keď zdroj údajov '[dbo].[AllListings]' obsahuje milión riadkov:

AddColumns( RealEstateAgents,
   Listings,
   Filter(  '[dbo].[AllListings]', ListingAgentName = AgentName )
)

Výstup týchto funkcií však podlieha limitu záznamu bez delegovania. V tomto príklade sa vráti iba 500 záznamov, aj keď zdroj údajov RealEstateAgents obsahuje 501 alebo viac záznamov.

Ak použijete AddColumns týmto spôsobom, funkcia Filter musí pre každý z prvých záznamov v realestateAgents vykonávať samostatné volania zdroja údajov, čo spôsobuje množstvo sieťových chatov. Ak [dbo](.[AllListings] je dostatočne malý a často sa nemení. Funkciu Collect môžete zavolať v OnStart , aby ste po spustení aplikácie uložili do vyrovnávacej pamäte zdroj údajov. Alternatívne by ste svoju aplikáciu mohli reštrukturalizovať, aby ste mohli príslušné záznamy preniesť iba vtedy, keď ich o to používateľ požiada.

Poznámka

V Power Apps pred verziou 3.24042 boli názvy stĺpcov špecifikované textovým reťazcom pomocou dvojitých úvodzoviek a ak boli pripojené k zdroj údajov, museli to byť aj logické názvy. Napríklad logický názov "cr43e_name" s dvojitými úvodzovkami bol použitý namiesto zobrazovaného názvu Názov bez úvodzoviek. Pre zdroje údajov SharePoint a Excel, ktoré obsahujú názvy stĺpcov s medzerami, bola každá medzera špecifikovaná pomocou "_x0020_", napríklad "Stĺpec Názov" ako "Názov_x0020_stĺpca". Po tejto verzii boli všetky aplikácie automaticky aktualizované na novú syntax opísanú v tomto článku.

Syntax

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

TableOrRecord – povinné. Tabuľka alebo záznam, s ktorý sa má spracovať.
Názvy stĺpcov – povinné. Názvy stĺpcov, ktoré sa majú pridať.
Vzorce – povinné. Vzorce na vyhodnotenie pre každý záznam. Výsledok sa pridá ako hodnota príslušného nového stĺpca. V tomto vzorci môžete odkazovať na iné stĺpce tabuľky alebo záznamu.

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

TableOrRecord – povinné. Tabuľka alebo záznam, s ktorý sa má spracovať.
Názvy stĺpcov – povinné. Názvy stĺpcov, ktoré sa majú vypustiť.

RenameColumns( TableOrRecord, OldColumnName1, NewColumnName1 [, OldColumnName2, NewColumnName2, ... ] )

TableOrRecord – povinné. Tabuľka alebo záznam, s ktorý sa má spracovať.
OldColumnNames – povinné. Názvy stĺpcov, ktoré sa majú premenovať z pôvodnej tabuľky alebo záznamu. 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).
NewColumnNames – povinné. Náhradné mená. 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).

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

TableOrRecord – povinné. Tabuľka alebo záznam, s ktorý sa má spracovať.
Názvy stĺpcov – povinné. Názvy stĺpcov, ktoré sa majú zahrnúť.

Príklady

V nasledujúcich príkladoch použijeme zdroj údajov IceCreamSales, ktorý obsahuje údaje v tejto tabuľke:

Príklad Zmrzlina.

Ani jeden z týchto príkladov neupraví zdroj údajov IceCreamSales. Každá funkcia transformuje hodnotu zdroja údajov ako tabuľku a vráti túto hodnotu ako výsledok.

Vzorec	Description	Result
*AddColumns( IceCreamSales, Revenue, UnitPrice QuantitySold )**	Pridá do výsledku stĺpec Výnos. 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.
DropColumns( IceCreamSales, UnitPrice )	Vylúči z výsledku stĺpec UnitPrice. Pomocou tejto funkcie môžete vylúčiť stĺpce a použiť ShowColumns ich na ich zahrnutie.
ShowColumns( IceCreamSales, Flavor )	Zahrnie do výsledku iba stĺpec Chuť. Pomocou tejto funkcie môžete zahrnúť stĺpce a pomocou DropColumns tejto funkcie ich môžete vylúčiť.
RenameColumns( IceCreamSales, UnitPrice, Price)	Premenuje vo výsledku stĺpec UnitPrice.
RenameColumns( IceCreamSales, UnitPrice, Price, QuantitySold, Number)	Výsledkom sú premenované stĺpce UnitPrice a QuantitySold.
DropColumns( RenameColumns( AddColumns( IceCreamSales, Revenue, UnitPrice * QuantitySold ), Jednotková cena, cena ), množstvo)	Vykoná nasledujúce transformácie tabuľky v uvedenom poradí s tým, že začne uprostred vzorca: Pridá stĺpec Výnosy na základe výpočtu na záznam *Jednotková cena Množstvo. Premenuje UnitPrice na Cena. Vylúči stĺpec Množstvo. Poradie je dôležité, napríklad nemôžeme počítať s Jednotková cena** po jej premenovaní.

Podrobne

Skúsme niektoré z príkladov z predchádzajúceho článku.

Vytvorte kolekciu pridaním ovládacieho prvku Tlačidlo a nastavenie jeho vlastnosti OnSelect podľa tohto vzorca:

ClearCollect( IceCreamSales,
   Table(
       { Flavor: "Strawberry", UnitPrice: 1.99, QuantitySold: 20 },
       { Flavor: "Chocolate", UnitPrice: 2.99, QuantitySold: 45 },
       { Flavor: "Vanilla", UnitPrice: 1.50, QuantitySold: 35 }
   )
)

Stlačením tlačidla a podržaním klávesu Alt spustite vzorec.
Pridajte druhý ovládací prvok Tlačidlo, nastavte vlastnosť OnSelect na tento vzorec a potom ho spustite.
```
ClearCollect( FirstExample,
   AddColumns( IceCreamSales, Revenue, UnitPrice * QuantitySold )
)
```
V ponuke Súbor vyberte Kolekcie a potom stlačte IceCreamSales, čím si danú kolekciu zobrazíte.

Ako ukazuje tento obrázok, druhý vzorec túto kolekciu neupravil. Funkcia AddColumnspoužila argument IceCreamSales ako argument iba na čítanie. Funkcia neupravovala tabuľku, na ktorú tento argument odkazuje.
Stlačte možnosť FirstExample.

Ako ukazuje tento obrázok, druhý vzorec vrátil novú tabuľku s pridaným stĺpcom. Funkcia ClearCollect zachytila novú tabuľku v kolekcii FirstExample, pridávajúc niečo do pôvodnej tabuľky, keď pretekala funkciou bez úpravy zdroja:

Mapovanie stĺpcov v súčasti

Pozri Mapovanie stĺpcov.

Pripomienky

Bola táto stránka užitočná?

Last updated on 2025-10-10