Funkcije »AddColumns«, »DropColumns«, »RenameColumns« in »ShowColumns« v rešitvi Power Apps

Članek
03/10/2022
3 min za branje

Oblikuje tabelo z dodajanjem, spuščanjem, preimenovanjem in izbiranjem njenih stolpcev.

Pregled

Te funkcije oblikujejo tabelo s prilagajanjem njenih stolpcev:

Zmanjšajte tabelo, ki vsebuje več stolpcev, na zgolj en stolpec za uporabo s funkcijami za en stolpec, kot je Lower ali Abs.
Dodajte izračunani stolpec v tabelo (na primer stolpec Skupna cena, ki prikazuje rezultate množenja količine s ceno na enoto).
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 članek o delu z viri podatkov.

Opis

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

Formula se ovrednoti za vsak zapis tabele.

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. Vsi drugi stolpci ostanejo nespremenjeni. DropColumn izključi stolpce, ShowColumns pa jih vključi.

Uporabite funkcijo RenameColumns in preimenujte enega ali več stolpcev tabele tako, da navedete vsaj en par argumentov, ki določa ime stolpca v tabeli (staro ime, ki ga želite zamenjati) in ime stolpca, ki ga tabela ne vsebuje (novo ime, ki ga želite uporabiti). Staro ime mora že obstajati v tabeli, novo ime pa ne sme obstajati. Ime vsakega stolpca se lahko na seznamu argumentov prikaže samo enkrat, in sicer kot staro ime stolpca ali novo ime stolpca. Če želite stolpec preimenovati v obstoječe ime stolpca, najprej s funkcijo DropColumns opustite obstoječi stolpec ali pa obstoječi stolpec umaknite tako, da ugnezdite eno funkcijo RenameColumns znotraj druge.

Funkcija ShowColumns vključi stolpce tabele in izpusti vse druge stolpce. Funkcijo ShowColumns lahko uporabite za ustvarjanje tabele z enim stolpcem iz tabele z več stolpci. Funkcija ShowColumns izključi stolpce, funkcija DropColumns pa jih izključi.

Pri vseh teh funkcijah je rezultat nova tabela z uporabljeno pretvorbo. Izvirna tabela se ne spremeni. Obstoječe tabele ne morete spremeniti s formulo. SharePoint, Microsoft Dataverse, SQL Server in drugi viri podatkov zagotavljajo orodja za spreminjanje stolpcev seznamov, tabel in tabel, ki jih pogosto imenujemo shema. Funkcije v tej temi samo preoblikujejo vhodno tabelo v izhodno tabelo za nadaljnjo uporabo, ne da bi spremenili izvirnik.

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 uporabite funkcijo AddColumns na ta način, mora funkcija Filter izvesti ločene klice vira podatkov za vsakega od teh zapisov v RealEstateAgents, kar povzroči veliko omrežnega kramljanja. Če je vir podatkov [dbo].[AllListings] dovolj majhen in se ne spreminja pogosto, lahko pokličete funkcijo Collect v možnosti OnStart, da predpomnite vir podatkov v aplikaciji, ko se zažene. Namesto tega lahko svojo aplikacijo prestrukturirate tako, da vključite povezane zapise le, ko jih uporabnik zahteva.

Sintaksa

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

Table – obvezno. Tabela za obdelavo.
ColumnName(s) – obvezno. Imena stolpcev za dodajanje. Določiti morate niz (npr. "Name" z dvojnimi narekovaji) za ta argument.
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 v tabeli.

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

Table – obvezno. Tabela za obdelavo.
ColumnName(s) – obvezno. Imena stolpcev, ki bodo izključeni. Določiti morate niz (npr. "Name" z dvojnimi narekovaji) za ta argument.

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

Table – obvezno. Tabela za obdelavo.
OldColumnName – obvezno. Ime stolpca za preimenovanje iz prvotne tabele. Ta element se prikaže prvi v paru argumentov (ali prvi v vsakem paru argumentov, če formula vključuje več parov). To ime mora biti niz (npr. "Name" z dvojnimi narekovaji).
NewColumnName – obvezno. Nadomestno ime. Ta element se prikaže zadnji v paru argumentov (ali zadnji v vsakem paru argumentov, če formula vključuje več parov). Določiti morate niz (npr. "CustomerName" z dvojnimi narekovaji) za ta argument.

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

Table – obvezno. Tabela za obdelavo.
ColumnName(s) – obvezno. Imena stolpcev, ki bodo vključeni. Določiti morate niz (npr. "Name" z dvojnimi narekovaji) za ta argument.

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	Opis	Rezultat
*AddColumns( IceCreamSales, "Revenue", UnitPrice QuantitySold )**	Rezultatu doda stolpec Revenue. Pri vsakem zapisu se ovrednoti formula *UnitPrice QuantitySold** in rezultat je vnesen v nov stolpec.
DropColumns( IceCreamSales, "UnitPrice" )	Izključi stolpec UnitPrice iz rezultata. S to funkcijo izključite stolpce, s funkcijo ShowColumns pa jih vključite.
ShowColumns( IceCreamSales, "Flavor" )	V rezultat vključi samo stolpec Flavor. S to funkcijo vključite stolpce, s funkcijo DropColumns pa jih izključite.
RenameColumns( IceCreamSales, "UnitPrice", "Price")	Preimenuje stolpec UnitPrice v rezultatu.
RenameColumns( IceCreamSales, "UnitPrice", "Price", "QuantitySold", "Number")	Preimenuje stolpca UnitPrice in QuantitySold v rezultatu.
DropColumns( RenameColumns( AddColumns( IceCreamSales, "Revenue", UnitPrice * QuantitySold ), "UnitPrice", "Price" ), "Quantity" )	Izvede spodnje pretvorbe tabele v vrstnem redu, pri čerem začne znotraj formule: Doda stolpec Revenue na podlagi izračuna zapisa *UnitPrice Quantity. Preimenuje UnitPrice v Price. Izključi stolpec Quantity. Upoštevajte, da je vrstni red pomemben. Ne moremo na primer računati s stolpcem UnitPrice** po tem, ko je preimenovan.

Korak za korakom

Preskusimo nekaj primerov, ki so že bili navedeni v tej temi.

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 uporabila IceCreamSales kot argument samo za branje; funkcija ni spremenila tabele, na katero se nanaša ta argument.
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:

Preslikaj stolpce v komponenti

Glej Stolpci zemljevida.