Kopīgot, izmantojot

AddColumns, DropColumns, RenameColumns, un ShowColumns funkcijas

Attiecas uz: Audekla programmas Copilot Studio Desktop plūsmas Modeļa vadītas programmas Power Platform CLI Dataverse funkcijas

Veido tabulu vai ierakstu , pievienojot, nometot, pārdēvējot un atlasot tās kolonnas.

Funkciju ForAll var izmantot arī, lai veidotu tabulu, atgriežot tabulu ar jauniem ierakstiem, kas izveidoti no esošajām kolonnām.

Pārskats

Šīs funkcijas veido tabulu vai ierakstu, pielāgojot tās kolonnas:

  • Samaziniet tabulu vai ierakstu, kas satur vairākas kolonnas, līdz vienai kolonnai, lai to izmantotu ar vienas kolonnas funkcijām, piemēram, Lower vai Sqrt.
  • Pievienojiet aprēķināto kolonnu tabulai vai ierakstam (piemēram, kolonnai Kopējā cena , kurā redzami daudzuma reizināšanas rezultāti ar vienības cenu).
  • Pārdēvējiet kolonnu uz kaut ko jēgpilnāku, lai to varētu rādīt lietotājiem vai izmantot formulās.

Tabula ir vērtība programmā Power Apps, gluži kā virkne vai skaitlis. Varat konkretizēt tabulu kā formulas argumentu, un funkcijas var atgriezt tabulu kā rezultātu.

Note

Šajā tēmā aprakstītās funkcijas nepārveido sākotnējo tabulu. Tā vietā tās izmanto šo tabulu kā argumentu un atgriež jaunu tabulu ar piemērotajām izmaiņām. Papildinformāciju skatiet sadaļā Darbs ar tabulām.

Jūs nevarat modificēt datu avota kolonnas, izmantojot šīs funkcijas. Dati ir jāmodificē to avotā. Varat pievienot kolonnas kolekcijai ar funkciju Collect. Papildinformāciju skatiet sadaļā Darbs ar datu avotiem.

Apraksts

Funkcija AddColumns tabulai vai ierakstam pievieno kolonnu, un formula definē šīs kolonnas vērtības. Esošās kolonnas netiek modificētas.

Formula tiek novērtēta norādītajam ierakstam vai katram sniegtās tabulas ierakstam.

Formulā ir pieejami pašlaik apstrādātie ieraksta lauki. Izmantojiet operatoru ThisRecord vai vienkārši norādiet uz laukiem pēc nosaukuma, kā to darītu ar jebkuru citu vērtību. Operatoru As var izmantot arī, lai apstrādājamajam ierakstam piešķirtu nosaukumu, kas var palīdzēt padarīt formulu saprotamāku, bet ligzdotos ierakstus — pieejamus. Papildinformāciju skatiet tālāk sniegtajos piemēros un sadaļā Darbs ar ierakstu tvērumu.

Funkcija DropColumns izslēdz kolonnas no tabulas vai ieraksta. Citas kolonnas netiek modificētas. DropColumns Izslēdz kolonnas un ShowColumns ietver kolonnas.

Izmantojiet funkciju, RenameColumns lai pārdēvētu vienu vai vairākas tabulas vai ieraksta kolonnas, norādot vismaz vienu argumentu pāri, kas norāda tabulas vai ieraksta kolonnas nosaukumu (vecais nosaukums, kuru vēlaties aizstāt) un tās kolonnas nosaukumu, kas tabulā vai ierakstā nav (jaunais nosaukums, kuru vēlaties izmantot). Vecajam nosaukumam jau ir jābūt tabulā vai ierakstā, un jaunais nosaukums nedrīkst pastāvēt. Katra kolonnas nosaukums argumentu sarakstā var parādīties tikai vienu reizi kā vecais kolonnas nosaukums vai jauns kolonnas nosaukums. Lai pārdēvētu kolonnu par esošas kolonnas nosaukumu, vispirms nometiet esošo kolonnu ar DropColumns, vai pārdēvējiet esošo kolonnu, ligzdojot vienu RenameColumns funkciju citā.

Funkcija ShowColumns ietver tabulas vai ieraksta kolonnas un nomet visas pārējās kolonnas. Varat izmantot ShowColumns , lai izveidotu vienas kolonnas tabulu vai ierakstu no vairāku kolonnu tabulas vai ieraksta. ShowColumns Ietver kolonnas un DropColumns izslēdz kolonnas.

Visām šīm funkcijām rezultāts ir jauna tabula vai ieraksts ar lietotu transformāciju. Sākotnējā tabula vai ieraksts netiek modificēts. Esošu tabulu vai ierakstu nevar modificēt ar formulu. SharePoint, Microsoft Dataverse, SQL Server un citi datu avoti nodrošina rīkus sarakstu un tabulu kolonnu modificēšanai, ko bieži dēvē par shēmu. Šajā tēmā aprakstītās funkcijas tikai pārveido ievades tabulu vai ierakstu, nemodificējot oriģinālu, par izvades tabulu vai ierakstu turpmākai lietošanai.

Šo funkciju argumenti atbalsta deleģēšanu. Piemēram, funkcija Filter, ko izmanto kā argumentu saistīto ierakstu ievilkšanai, meklē visos sarakstos pat, ja datu avots '[dbo].[AllListings]' satur miljons rindas:

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

Taču uz šo funkciju izvadi attiecas nedeleģēšanas ieraksta ierobežojumi. Šajā piemērā tiek atgriezti tikai 500 ieraksti pat, ja datu avotā RealEstateAgents ir 501 vai vairāk ierakstu.

Ja izmantojat AddColumns šādā veidā, filtram ir jāveic atsevišķi izsaukumi uz datu avotu katram no šiem pirmajiem ierakstiem RealEstateAgents, kas izraisa daudz tīkla pļāpāšanas. Ja [dbo](.[AllListings] ir pietiekami mazs un bieži nemainās. Varat izsaukt funkciju Collect pakalpojumā OnStart , lai kešatmiņā saglabātu datu avots savā lietotnē, kad tā tiek startēta. Varat arī pārstrukturizēt programmu, lai ievilktu saistītās rindas vienīgi tad, ja lietotājs tās pieprasa.

Note

Pirms Power Apps versijas 3.24042 kolonnu nosaukumi tika norādīti ar teksta virkni, izmantojot dubultās pēdiņas, un, ja tie ir savienoti ar datu avots, tiem bija jābūt arī loģiskiem nosaukumiem. Piemēram, parādāmā vārda vietā tika izmantots loģiskais nosaukums "cr43e_name" ar dubultām pēdiņām Vārds bez pēdiņām. Datu SharePoint avotiem Excel un Excel, kuros ir kolonnu nosaukumi ar atstarpēm, katra atstarpe tika norādīta ar "_x0020_", piemēram "Kolonnas nosaukums"kā"Column_x0020_Name". Pēc šīs versijas visas programmas tika automātiski atjauninātas uz jauno sintaksi, kas aprakstīta šajā rakstā.

Sintakse

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

  • TableOrRecord - obligāts. Tabula vai ieraksts, ar kuru jādarbojas.
  • ColumnNames - Obligāts. Pievienojamo kolonnu nosaukumi.
  • Formulas - Obligāts. Formulas, kas jānovērtē katram ierakstam. Rezultāts tiek pievienots kā atbilstošās jaunās kolonnas vērtība. Šajā formulā var atsaukties uz citām tabulas vai ieraksta kolonnām.

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

  • TableOrRecord - obligāts. Tabula vai ieraksts, ar kuru jādarbojas.
  • ColumnNames - Obligāts. Nometamo kolonnu nosaukumi.

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

  • TableOrRecord - obligāts. Tabula vai ieraksts, ar kuru jādarbojas.
  • OldColumnNames - Obligāts. Pārdēvējamo kolonnu nosaukumi no sākotnējās tabulas vai ieraksta. Šis elements argumentu pārī parādās pirmais (vai pirmais katrā argumentu pārī, ja formulā ir vairāk par vienu pāri).
  • NewColumnNames - Obligāts. Aizstājējvārdi. Šis elements argumentu pārī parādās pēdējais (vai pēdējais katrā argumentu pārī, ja formulā ir vairāk par vienu pāri).

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

  • TableOrRecord - obligāts. Tabula vai ieraksts, ar kuru jādarbojas.
  • ColumnNames - Obligāts. Iekļaujamo kolonnu nosaukumi.

Piemēri

Šīs sadaļas piemēros izmantots datu avots IceCreamSales, kas satur šīs tabulas datus:

Piemērs ar saldējumu.

Neviens no šiem piemēriem nepārveido datu avotu IceCreamSales. Katra funkcija pārveido datu avota vērtību kā tabulu un atgriež šo vērtību kā rezultātu.

Formula Apraksts Rezultāts
AddColumns( IceCreamSales, Ieņēmumi, Vienības cena * Pārdotais daudzums ) Rezultātam pievieno kolonnu Ieņēmumi. Katram ierakstam tiek novērtēts UnitPrice * QuantitySold, un rezultāts tiek novietots jaunajā kolonnā. Rezultāts ar zemeņu, šokolādes un vaniļas.
DropColumns( IceCreamSales, Vienības cena ) No rezultāta izslēdz kolonnu UnitPrice. Izmantojiet šo funkciju, lai izslēgtu kolonnas, un izmantojiet ShowColumns , lai tās iekļautu. Rezultāts ar zemeņu, šokolādes un vaniļas, kam ir tikai kolonna QuantitySold.
ShowColumns( Saldējuma pārdošana, garša ) Rezultātā iekļauj tikai kolonnu Garša. Izmantojiet šo funkciju, iekļaujiet kolonnas un izmantojiet DropColumns , lai tās izslēgtu. Tikai kolonna Garša.
RenameColumns( IceCreamSales, Vienības cena, Cena) Rezultātā pārdēvē kolonnu UnitPrice. Rezultāts, izmantojot Garša, Cena un Ieņēmumi.
RenameColumns( IceCreamSales, Vienības cena, Cena, Pārdotais daudzums, Skaits) Rezultātā pārdēvē kolonnas UnitPrice un QuantitySold. Rezultāts ar 3 saldējumiem un kolonnām kā Garša, Cena, Ieņēmumi.
DropColumns(
RenameColumns(
AddColumns( IceCreamSales, Ieņēmumi,
Vienības cena * pārdotais daudzums),
UnitPrice, Cena ),
Daudzums )		 Veic šīs tabulas pārveidi secībā, sākot no formulas iekšpuses:
  1. Pievieno kolonnu Ieņēmumi , pamatojoties uz vienības cenas * daudzuma aprēķina par ierakstu.
  2. Pārdēvē UnitPrice par Price.
  3. Izslēdz kolonnu Daudzums.
Pasūtījums ir svarīgs, piemēram, mēs nevaram aprēķināt ar UnitPrice pēc tā pārdēvēšanas.		 Saldējuma piemērs vienības cenai.

Pakāpeniskas darbības

Izmēģināsim dažus piemērus no šī raksta sākuma.

  1. Izveidojiet kolekciju, pievienojot Button vadīklu un iestatot tās rekvizītu OnSelect uz šo formulu:

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

  2. Palaidiet formulu, atlasot pogu un turot nospiestu Alt taustiņu.

  3. Pievienojiet otro Pogas vadīklu, iestatiet tās rekvizītu OnSelect uz šo formulu un pēc tam to palaidiet:

    ClearCollect( FirstExample,
   AddColumns( IceCreamSales, Revenue, UnitPrice * QuantitySold )
)

  4. Izvēlnē Fails atlasiet Kolekcijas un pēc tam atlasiet IceCreamSales, lai parādītu šo kolekciju.

    Kā redzams šajā grafikā, otrā formula šo kolekciju nemodificēja. Funkcija AddColumns izmantoja IceCreamSales kā tikai lasāmu argumentu; funkcija nemodificēja tabulu, uz kuru attiecas šis arguments.

    Kolekcijas skatītājs, kas rāda trīs kolekcijas Ice Cream Sales ierakstus, kuri neietver Ieņēmumu kolonnu.

  5. Atlasiet FirstExample.

    Kā parādīts šajā grafikā, otrā formula atgrieza jaunu tabula ar pievienoto kolonnu. Funkcija ClearCollect notvēra jauno tabulu kolekcijā FirstExample, pievienojot kaut ko sākotnējai tabulai, kad tā virzījās cauri funkcijai, nemodificējot avotu:

    Kolekcijas skatītājs, kas tāda kolekcijas First Example trīs ierakstus, kuri ietver jaunu kolonnu Ieņēmumi.

Kolonnu kartēšana komponentā

Skatīt Kartēt kolonnas.

  • Last updated on