AddColumns, DropColumns, RenameColumnsin funkcije ShowColumns

Velja za: Aplikacije Canvas Copilot Studio Desktop tokovi Modelno vodene aplikacije Power Platform CLI Dataverse funkcije

Oblikujte tabelo ali zapis tako, da dodate, spustite, preimenujete in izberete njene stolpce.

Funkcijo ForAll lahko uporabite tudi za oblikovanje tabele tako, da vrne tabelo novih zapisov, ustvarjenih iz obstoječih stolpcev.

Pregled

Te funkcije oblikujo tabelo ali zapis tako, da prilagodijo stolpce:

Zmanjšajte tabelo ali zapis, ki vsebuje več stolpcev navzdol, v en stolpec in uporabite s funkcijami z enim stolpcem, kot je Lower ali Sqrt.
Dodajte izračunani stolpec v tabelo ali zapis (na primer stolpec Skupna cena, ki prikazuje rezultate množenja količine sceno enote).
Za prikaz uporabnikom ali za uporabo v formulah preimenujte stolpec v nekaj bolj smiselnega.

Tabela je vrednost v rešitvi Power Apps, tako kot niz ali številka. Tabelo lahko določite kot argument v formuli in funkcije lahko vrnejo tabelo kot rezultat.

opomba,

Funkcije, ki jih opisuje ta tema, ne spremenijo prvotne tabele. Namesto tega vzamejo tabelo kot argument in vrnejo novo tabelo z uporabljeno pretvorbo. Za več informacij glejte delo s tabelami.

S temi funkcijami ne morete spremeniti stolpcev vira podatkov. Podatke morate spremeniti v viru. Stolpce lahko dodate v zbirko s funkcijo Collect. Za več informacij glejte delo z viri podatkov.

Description

Funkcija AddColumns doda stolpec v tabelo ali zapis in formula določi vrednosti v tem stolpcu. Obstoječi stolpci ostanejo nespremenjeni.

Formula je ovrednotena za navedeni zapis ali za vsak zapis v navedeni tabeli.

Polja zapisa, ki je trenutno v obdelavi, so na voljo v okviru formule. Uporabite operator ThisRecord ali pa polja preprosto navedite poimensko, kot bi storili za katero koli drugo vrednost. Operator As lahko uporabite tudi za poimenovanje zapisa, ki se obdeluje, s čimer bo formulo lažje razumeti in bodo dostopni ugnezdeni zapisi. Več informacij je v spodnjih primerih in razdelku delo z obsegom zapisov.

Funkcija DropColumns izključi stolpce iz tabele ali zapisa. Vsi drugi stolpci ostanejo nespremenjeni. DropColumns izključi stolpce in vključi ShowColumns stolpce.

RenameColumns S funkcijo preimenujte enega ali več stolpcev tabele ali zapisa tako, da navedete vsaj en par argumentov, ki določa ime stolpca, ki ga vsebuje tabela ali zapis (staro ime, ki ga želite zamenjati) in ime stolpca, ki ga tabela ali zapis ne vsebuje (novo ime, ki jo želite uporabiti). Staro ime mora že obstajati v tabeli ali zapisu, novo ime pa ne sme obstajati. Vsako ime stolpca se lahko na seznamu argumentov prikaže le enkrat kot staro ime stolpca ali kot novo ime stolpca. Če želite stolpec preimenovati v obstoječe ime stolpca, DropColumnsnajprej spustite obstoječi stolpec z , RenameColumns ali pa preimenujte obstoječi stolpec tako, da ugnezdite eno funkcijo v drugo.

Funkcija ShowColumns vključuje stolpce tabele ali zapisa in spusti vse druge stolpce. Tabelo ali zapis ShowColumns z enim stolpcem lahko ustvarite iz tabele ali zapisa z več stolpci. ShowColumns vključuje stolpce in DropColumns izključuje stolpce.

Za vse te funkcije je rezultat nova tabela ali zapis z uporabljeno pretvorbo. Izvirna tabela ali zapis ni spremenjen. Obstoječe tabele ali zapisa s formulo ni mogoče spremeniti. SharePoint, Microsoft Dataverse, SQL Server in drugi viri podatkov omogočajo orodja za spreminjanje stolpcev seznamov in tabel, ki se pogosto imenujejo shema. Funkcije v tej temi pretvorijo le vhodno tabelo ali zapis, ne da bi spremenili izvirnik, v izhodno tabelo ali zapis za nadaljnjo uporabo.

Argumenti za te funkcije podpirajo dodelitev. Funkcija Filter, ki se uporablja kot argument za vključitev povezanih zapisov, na primer išče po vseh seznamih, tudi če vir podatkov '[dbo].[AllListings]' vsebuje milijon vrstic:

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

Vendar za rezultat teh funkcij velja omejitev števila zapisov brez dodeljevanja. V tem primeru je vrnjenih samo 500 zapisov, tudi če ima vir podatkov RealEstateAgents 501 zapis ali več.

Če uporabljate AddColumns na ta način, mora Filter klicati ločen vir podatkov za vsak od teh prvih zapisov v storitvi RealEstateAgents, kar povzroči veliko klepeta v omrežju. Če [dbo](.[AllListings] je dovolj majhen in se ne spreminja pogosto. Funkcijo Collect lahko pokličete v OnStart za predpomnilnik vir podatkov v vaši aplikaciji, ko se zažene. Namesto tega lahko svojo aplikacijo prestrukturirate tako, da vključite povezane zapise le, ko jih uporabnik zahteva.

opomba,

V Power Apps pred različico 3.24042 so bila imena stolpcev podana z besedilnim nizom z dvojnimi narekovaji, in če so bili povezani z vir podatkov, so morala biti tudi logična imena. Na primer, logično ime »cr43e_name« z dvojnimi narekovaji je bilo uporabljeno namesto prikazno ime Ime brez narekovajev. Za SharePoint in izvore podatkov Excel, ki vsebujejo imena stolpcev s presledki, je bil vsak presledek določen z "_x0020_", na primer "Stolpec Ime« kot »Ime_stolpca_x0020«. Po tej različici so bile vse aplikacije samodejno posodobljene na novo sintakso, opisano v tem članku.

Sintaksa

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

TableOrRecord – zahtevano. Tabela ali zapis za delovanje.
Imena stolpcev - obvezno. Imena stolpcev, ki jih želite dodati.
Formule - obvezno. Formule za vrednotenje za vsak zapis. Rezultat je dodan kot vrednost ustreznega novega stolpca. V tej formuli se lahko sklicujete na druge stolpce tabele ali zapisa.

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

TableOrRecord – zahtevano. Tabela ali zapis za delovanje.
Imena stolpcev - obvezno. Imena stolpcev, ki jih želite izpustiti.

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

TableOrRecord – zahtevano. Tabela ali zapis za delovanje.
OldColumnNames - Zahtevano. Imena stolpcev, ki jih želite preimenovati iz izvirne tabele ali zapisa. Ta element se prikaže prvi v paru argumentov (ali prvi v vsakem paru argumentov, če formula vključuje več parov).
NovaImenaStolpcev - Zahtevano. Nadomestna imena. Ta element se prikaže zadnji v paru argumentov (ali zadnji v vsakem paru argumentov, če formula vključuje več parov).

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

TableOrRecord – zahtevano. Tabela ali zapis za delovanje.
Imena stolpcev - obvezno. Imena stolpcev, ki jih je treba vključiti.

Primeri

Primeri v tem razdelku uporabljajo vir podatkov IceCreamSales, ki vsebuje podatke v tej tabeli:

Primer Icecream.

Noben od teh primerov ne spremeni vira podatkov IceCreamSales. Vsaka funkcija pretvori vrednost vira podatkov kot tabelo in vrne to vrednost kot rezultat.

Formula	Description	Rezultat
*AddColumns( IceCreamSales, Prihodek, CenaEnote QuantitySold )**	Rezultatu doda stolpec Revenue. Pri vsakem zapisu se ovrednoti formula *UnitPrice QuantitySold** in rezultat je vnesen v nov stolpec.
DropColumns(IceCreamSales, CenaEnote)	Izključi stolpec UnitPrice iz rezultata. To funkcijo uporabite, če želite izključiti stolpce in jih ShowColumns vključiti.
ShowColumnsNo, to je vse, kar sem hotel.	V rezultat vključi samo stolpec Flavor. S to funkcijo vključite stolpce in jih izključite DropColumns .
RenameColumns(IceCreamSales, CenaEnote, Cena)	Preimenuje stolpec UnitPrice v rezultatu.
RenameColumns(IceCreamSales, CenaEnote, Cena, KoličinaSold, Število)	Preimenuje stolpca UnitPrice in QuantitySold v rezultatu.
DropColumns( RenameColumns( AddColumns( IceCreamSales, Prihodek, CenaEnote * QuantitySold ), Cena enote, cena ), količina)	Izvede spodnje pretvorbe tabele v vrstnem redu, pri čerem začne znotraj formule: Doda stolpec Prihodek na podlagi izračuna na zapis *UnitPrice Količina. Preimenuje UnitPrice v Price. Izključi stolpec Quantity. Vrstni red je pomemben, na primer ne moremo izračunati z UnitPrice** po preimenovanju.

Korak za korakom

Poskusimo nekaj primerov iz prejšnjega članka.

Ustvarite zbirko, tako da dodate kontrolnik Button in nastavite njegovo lastnost OnSelect na to formulo:

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

Medtem ko držite tipko Alt, izberite gumb, da zaženete formulo.
Dodajte še en kontrolnik Button in nastavite njegovo lastnost OnSelect na spodnjo formulo ter jo nato zaženite:
```
ClearCollect( FirstExample,
   AddColumns( IceCreamSales, Revenue, UnitPrice * QuantitySold )
)
```
V meniju Datoteka izberite Zbirke in nato še IceCreamSales, da jo prikažete.

Kot prikazuje slika, druga formula ni spremenila te zbirke. Funkcija AddColumns je funkcijo IceCreamSales uporabili kot argument samo za branje; funkcija ni spreminjala tabele, na katero se ta argument sklicuje.
Izberite FirstExample.

Kot prikazuje ta slika, je druga formula vrnila novo tabelo z dodanim stolpcem. Funkcija ClearCollect je zajela novo tabelo v zbirki FirstExample in dodala nekaj izvirni tabeli med pomikanjem po funkciji, ne da bi spremenila vir:

Preslikava stolpcev v komponenti

Glejte Preslikava stolpcev.

Povratne informacije

Ali je bila ta stran uporabna?

Last updated on 2025-10-10