GehituColumns, DropColumns, RenameColumns eta ShowColumns funtzioak

Hauei aplikatzen zaie: Canvas aplikazioak Mahaigaineko fluxuak Modeloetan oinarritutako aplikazioak Power Platform CLI

Taula bati formatua ematen dio zutabeak gehituz, jareginez, berrizendatuz eta hautatuz.

**ForAll funtzioa taula bati forma emateko ere erabil daiteke, lehendik dauden zutabeetatik sortutako erregistro berrien taula itzuliz.

Informazio orokorra

Funtzio hauek taula bat osatzen dute bere zutabeak egokituz:

• Murriztu hainbat zutabe dituen taula bat zutabe bakarrera, zutabe bakarreko funtzioekin erabiltzeko, hala nola Behea edo Sqrt.
• Gehitu kalkulatutako zutabe bat taula batean (adibidez, a Prezio totala zutabea biderkatzearen emaitzak erakusten dituena Kopurua arabera Unitatearen prezioa).
• Izeneko zutabeari zerbait esanguratsuagoa bihurtzeko, erabiltzaileei erakusteko edo formuletan erabiltzeko.

Taula bat balioa da Power Apps-en, kate edo zenbaki bat bezala. Taula bat argumentu gisa zehaztu dezakezu formula batean, eta funtzioek taula itzul dezakete.

Oharra

Gai honek deskribatzen dituen funtzioek ez dute jatorrizko taula aldatzen. Horren ordez, taula hori argumentu gisa hartzen dute eta taula berri bat itzultzen dute aplikatutako transformazio batekin. Informazio gehiago lortzeko, ikus taulekin lan egitea.

Ezin dituzu aldatu datu-iturburu bateko zutabeak, funtzio hauek erabiliz. Datuak bere iturburuan aldatu behar dituzu. Zutabeak gehitu ditzakezu bilduma batean Collect funtzioarekin. Informazio gehiago lortzeko, ikus datu iturriekin lan egitea.

Deskribapenak

AddColumns funtzioak zutabe bat taula bati gehitzen dio eta formula batek zutabe horretako balioak definitzen ditu. Existitzen diren zutabeak aldatu gabe daude.

Formula taulako erregistro bakoitzerako ebaluatzen da.

Une honetan prozesatzen ari den erregistroko eremuak erabilgarri daude formulan. Beste balio bat erabili nahi baduzu, erabili ThisRecord eragilea edo aipatu eremuak beren izenen arabera. As eragilea erabil daiteke prozesatuko den erregistroari izena jartzeko; horri esker, formula errazagoa izango da eta habiaratutako erregistroak erabilerrazagoak izango dira. Informazio gehiago lortzeko, ikusi beheko adibideak eta erregistro-esparruarekin lan egitea.

DropColumns funtzioak zutabeak taula batetik baztertzen ditu. Gainerako zutabeak aldatu gabe daude. DropColumns zutabeak baztertzen ditu, eta ShowColumns zutabeak biltzen ditu.

Erabili RenameColumns funtzioa taula bateko zutabe bat edo gehiago berrizendatzeko, gutxienez bat argumentu pare bat emanez, taulak biltzen duen zutabe baten izena (izen zaharra, ordezkatu nahi duzun) eta mahaiak ez duen zutabe baten izena zehazten duena. eduki (izen berria, erabili nahi duzun). Izen zaharra dagoeneko egon behar da taulan, eta izen berria ez da existitu behar. Zutabe-izen bakoitza argumentu-zerrendan behin bakarrik ager daiteke zutabe-izen zahar gisa edo zutabe-izen berri gisa. Zutabe bat lehendik dagoen zutabe izenari berrizendatzeko, bota lehenengo lehendik dagoen zutabearekin DropColumns edo aldatu izena dagoen zutabeari beste bat habiaratuta RenameColumns beste baten barruan funtzioa.

ShowColumns funtzioak taula bateko zutabeak biltzen ditu eta beste zutabe guztiak botatzen ditu. ShowColumns erabil dezakezu zutabe bakarreko taula sortzeko zutabe anitzeko taula bat sortzeko. ShowColumns zutabeak ditu, eta DropColumns zutabeak baztertzen ditu.

Funtzio horietarako, emaitza taula berri bat da aplikatutako transformazioarekin. Jatorrizko taula ez da aldatu. Ezin duzu lehendik dagoen taula formula batekin aldatu. SharePoint, Microsoft Dataverse, SQL Server-ek eta beste datu iturri batzuek zerrenden, taulen eta taulen zutabeak aldatzeko tresnak eskaintzen dituzte, askotan eskema gisa aipatzen direnak. Artikulu honetako funtzioek sarrerako taula bat soilik eraldatzen dute, jatorrizkoa aldatu gabe, irteerako taula batean gehiago erabiltzeko.

Funtzio hauen argumentuek ordezkatze-eragiketak onartzen dituzte. Adibidez, Filter funtzioa erlazionatutako erregistroen bilaketa zerrendetan erabilitako argumentu gisa erabilita, nahiz eta '[dbo].[AllListings]' datu-iturburuak milioi errenkada ditu:

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

Hala ere, funtzio horien irteera hurrengoa da ordezkatzerik gabeko erregistroaren muga. Adibide honetan, 500 erregistro baino ez dira itzultzen RealEstateAgents datu-iturburu 501 erregistro edo gehiago ditu.

Modu honetan Gehitu zutabeak erabiliz gero, Iragazkiak dei bereiziak egin behar ditu lehen horietako bakoitzarentzat datu-iturburu erregistroak RealEstateAgentsn, eta horrek sareko berriketa asko eragiten du. [dbo](.[AllListings] aski txikia bada eta ez da askotan aldatzen. Bildu funtzioa dei dezakezu OnStart aplikazioan abiaraztean datu-iturburu cachean gordetzeko. Halaber, aplikazioa berregituratu ahal izango duzu, erabiltzaileak hala eskatzen duenean soilik erlazionatutako erregistroak lor ditzan.

Oharra

3.24042 bertsioaren Power Apps bertsioaren aurretik, zutabeen izenak testu-kate batekin zehazten ziren komatxo bikoitzak erabiliz, eta datu-iturburu batera konektatuz gero, izen logikoak ere izan behar ziren. Adibidez, komatxo bikoitzekin "cr43e_name" izen logikoa erabili zen bistaratze-izenaren ordez Izena komarik gabe. . Zuriuneak dituzten zutabe-izenak dituzten SharePoint eta Excel datu-iturburuetarako, tarte bakoitza "_x0020_"-rekin zehaztu zen, adibidez "Column Name" as "Column_x0020_Name". Bertsio honen ondoren, aplikazio guztiak automatikoki eguneratu ziren artikulu honetan deskribatutako sintaxi berrira.

Sintaxia

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

• Taula - Beharrezkoa. Eragiketak egiteko taula.
• ColumnName(s) - Beharrezkoa. Gehitu beharreko zutabeen izenak.
• Formulak – Beharrezkoa. Erregistro bakoitzerako ebaluatzeko formulak. Emaitza dagokion zutabe berriaren balio gisa gehitzen da. Taulako beste zutabeak erreferentzia ditzakezu formula honetan.

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

• Taula - Beharrezkoa. Eragiketak egiteko taula.
• ColumnName(s) - Beharrezkoa. Jarri beharreko zutabeen izenak.

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

• Taula - Beharrezkoa. Eragiketak egiteko taula.
• OldColumnNames - Beharrezkoa. Jatorrizko taulatik aldatu beharreko zutabeen izenak. Elementu hau argumentu parean agertzen da lehendabizi (edo lehenik argumentu pare bakoitzean formulak pare bat baino gehiago biltzen baditu).
• NewColumnNames - Beharrezkoa. Ordezko izenak. Elementu hau argumentu parean agertzen da azkenean (edo azken argumentua pare bakoitzean formulak pare bat baino gehiago biltzen baditu).

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

• Taula - Beharrezkoa. Eragiketak egiteko taula.
• ColumnName(s) - Beharrezkoa. Sartu beharreko zutabeen izenak.

Adibideak

Atal honetako adibideek erabiltzen dute IceCreamSales datu-iturburu, taula honetako datuak biltzen dituena:

Adibide hauetako bakar bat ere ez da aldatzen IceCreamSales datu-iturburua. Funtzio bakoitzak datu-iturburuaren balioa taula bihurtzen du eta balio hori emaitza gisa itzultzen du.

Formula	Deskribapenak	Result
Gehitu Zutabeak (Izozkiaren Salmentak, Diru-sarrerak, Unitatearen Prezioa * Saldutako Kantitatea)	Diru-sarrerak zutabea gehitzen du emaitzan. Erregistro bakoitzerako, UnitPrice * QuantitySold ebaluatzen da eta emaitza zutabe berrian kokatzen da.
DropColumns(Izozkiaren salmentak, Unitatearen prezioa)	UnitPrice zutabea baztertzen du emaitzatik. Erabil ezazu funtzio hau zutabeak baztertzeko, eta erabili ShowColumns horiek barneratzeko.
Erakutsi Zutabeak (Izozki Salmentak, Zaporea)	Zaporea zutabea soilik gehitzen du emaitzan. Erabil ezazu funtzio hau zutabeak gehitzeko, eta erabili DropColumns horiek baztertzeko.
Aldatu izena zutabeak (Izozki-salmentak, Unitatearen Prezioa, Prezioa)	UnitPrice zutabearen izena aldatzen du emaitzan.
Aldatu Zutabeak (Izozki Salmentak, Unitatearen Prezioa, Prezioa, Saldu kopurua, Zenbakia)	UnitPrice eta QuantitySold zutabeen izena aldatzen du emaitzan.
DropColumns( RenameColumns( Gehitu Zutabeak (Izozki Salmentak, Diru-sarrerak, UnitPrice * QuantitySold ), Unitatearen Prezioa, Prezioa), Kantitatea)	Hurrengo taularen eraldaketak ordenan egiten ditu, formularen barrutik hasita: Diru-sarrerak zutabea gehitzen du UnitPrice * Kantitatea erregistro bakoitzeko kalkuluan oinarrituta. UnitPrice izena aldatzen du Prezioa gisa. Kopurua zutabea baztertzen du. Ordena garrantzitsua da, adibidez, ezin dugu UnitPrice rekin kalkulatu izena aldatu ondoren.

Urratsez urrats

Proba ditzagun artikulu honetako lehengo adibide batzuk.

1. Sortu bilduma bat Button kontrola gehituz eta OnSelect propietatea formulan ezartzen:

   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. Exekutatu formula botoia hautatuta Alt tekla sakatuta edukita.

3. Gehitu bigarren Button kontrola, eta ezarri horren OnSelect propietatea formula honetan eta exekuta ezazu:

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

4. Fitxategia menuan, hautatu Bildumak eta, ondoren, hautatu IceCreamSales bilduma hori erakusteko.

   Grafiko honek erakusten duen moduan, bigarren formulak ez du bilduma hau aldatu. AddColumns erabilitako funtzioa IceCreamSales irakurtzeko argumentu gisa; funtzioak ez du argumentu hori aipatzen duen taula aldatu.

   

5. Aukeratu FirstExample.

   Grafiko honek erakusten duen moduan, bigarren formulak taula berri bat itzuli du zutabe erantsiarekin. ClearCollect funtzioan taula berria harrapatu da FirstExample bilduma, jatorrizko taulan zerbait gehituz funtzioa zeharkatzen zen bitartean iturria aldatu gabe:

   

Mapeatu zutabeak osagai batean

Ikusi Esleitu zutabeak.