AddColumns, DropColumns, RenameColumns, eta ShowColumns funtzioak

Honako hauei aplikatzen zaie: Mihise-aplikazioak Copilot Studio Mahaigaineko fluxuak Ereduetan oinarritutako aplikazioak Power Platform CLI Dataverse funtzioak

Taula edo erregistro bati forma ematen dio, bere zutabeak gehituz, jareginez, izenez aldatu eta hautatuta.

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

Informazio orokorra

Funtzio hauek taula edo erregistro bati forma ematen diote haren zutabeak doituz:

Murriztu zutabe anitz dituen taula edo erregistro bat zutabe bakarrera zutabe bakarreko funtzioekin erabiltzeko, hala nola Lower edo Sqrt.
Gehitu kalkulatutako zutabe bat taula edo erregistro bati (adibidez, Prezio osoaren zutabea, Kantitateaunitate-prezioarekin biderketaren emaitzak erakusten dituena).
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

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

Formula emandako erregistrorako edo emandako 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.

Funtzioak DropColumns zutabeak taula edo erregistro batetik kanpo uzten ditu. Gainerako zutabeak aldatu gabe daude. DropColumns Zutabeak baztertzen ditu eta ShowColumns zutabeak barne hartzen ditu.

Erabili funtzioa RenameColumns taula edo erregistro bateko zutabe baten edo gehiagoren izena aldatzeko. Gutxienez argumentu-bikote bat emanez, taula edo erregistroak duen zutabe baten izena (ordezkatu nahi duzun izen zaharra) eta taula edo erregistroak ez duen zutabe baten izena (izen berria, erabili nahi duzuna). Izen zaharrak taulan edo erregistroan egon behar du, eta izen berriak ez du existitu behar. Zutabe-izen bakoitza behin bakarrik ager daiteke argumentu-zerrendan, zutabe-izen zahar edo berri gisa. Zutabe bati lehendik dagoen zutabe-izen batera aldatzeko, jaregin lehenik eta behin lehendik dagoen zutabea DropColumns, edo aldatu lehendik dagoen zutabeari funtzio bat RenameColumns beste baten barruan habiaratuz.

Funtzioak ShowColumns taula edo erregistro bateko zutabeak barne hartzen ditu, eta gainerako zutabe guztiak jaregiten ditu. Zutabe bakarreko taula edo erregistro bat sortzeko erabil ShowColumns dezakezu zutabe anitzeko taula edo erregistro batetik. ShowColumns zutabeak sartzen ditu eta DropColumns zutabeak baztertzen ditu.

Funtzio horien guztietarako, emaitza taula edo erregistro berri bat da, eraldaketa aplikatuta. Jatorrizko taula edo erregistroa ez da aldatu. Ezin duzu lehendik dagoen taula edo erregistro bat formula batekin aldatu. SharePoint, Microsoft Dataverse, SQL Server eta beste datu-iturri batzuek zerrenda eta taulen zutabeak aldatzeko tresnak eskaintzen dituzte. Gai honetako funtzioek sarrerako taula edo erregistro bat soilik eraldatzen dute, jatorrizkoa aldatu gabe, irteerako taula edo erregistro bihurtzen dute, 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 erabiltzen AddColumns baduzu, Filter-ek dei bereiziak egin behar ditu RealEstateAgents-eko lehen erregistro horietako bakoitzerako datu-iturrira, eta horrek sareko berriketa ugari eragiten ditu. [dbo](.[AllListings] aski txikia bada eta ez da askotan aldatzen. Bildu funtziora deitu 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. . Zutabe-izenak zuriuneekin dituzten SharePoint eta Excel datu-iturburuetarako, tarte bakoitza "_x0020_"-rekin zehaztu zen, adibidez "Zutabearen izena" as "Column_x0020_Name". Bertsio honen ondoren, aplikazio guztiak automatikoki eguneratu ziren artikulu honetan deskribatutako sintaxi berrira.

Sintaxia

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

TableOrRecord - Beharrezkoa. Ebakuntza egiteko taula edo erregistroa.
ColumnNames - Beharrezkoa. Gehitu beharreko zutabeen izenak.
Formulak - Beharrezkoa. Erregistro bakoitzerako ebaluatzeko formulak. Emaitza dagokion zutabe berriaren balio gisa gehitzen da. Formula honetan taulako edo erregistroko beste zutabe batzuei erreferentzia egin diezaiekezu.

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

TableOrRecord - Beharrezkoa. Ebakuntza egiteko taula edo erregistroa.
ColumnNames - Beharrezkoa. Jarri beharreko zutabeen izenak.

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

TableOrRecord - Beharrezkoa. Ebakuntza egiteko taula edo erregistroa.
OldColumnNames - Beharrezkoa. Jatorrizko taulatik edo erregistrotik izena 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( TableOrRecord, ColumnName1 [, ColumnName2, ... ] )

TableOrRecord - Beharrezkoa. Ebakuntza egiteko taula edo erregistroa.
ColumnNames - Beharrezkoa. Sartu beharreko zutabeen izenak.

Adibideak

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

IceCream adibidea.

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
*AddColumns( Izozki-salmentak, diru-sarrerak, unitate-prezioa kantitatea)**	Diru-sarrerak zutabea gehitzen du emaitzan. Erregistro bakoitzerako, *UnitPrice QuantitySold** ebaluatzen da eta emaitza zutabe berrian kokatzen da.
DropColumns(IceCreamSales, UnitPrice)	UnitPrice zutabea baztertzen du emaitzatik. Erabili funtzio hau zutabeak baztertzeko, eta erabili ShowColumns horiek sartzeko.
ShowColumns( Izozki-salmentak, zaporea )	Zaporea zutabea soilik gehitzen du emaitzan. Erabili funtzio hau include zutabeak, eta erabili DropColumns horiek baztertzeko.
RenameColumns(IceCreamSales, UnitPrice, Price)	UnitPrice zutabearen izena aldatzen du emaitzan.
RenameColumns(IceCreamSales, UnitPrice, Price, QuantitySalt, Number)	UnitPrice eta QuantitySold zutabeen izena aldatzen du emaitzan.
DropColumns( RenameColumns( AddColumns(Izozkiak, Diru-sarrerak, Prezio unitarioa * Saldutako kantitatea), 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.

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 }
   )
)

Exekutatu formula botoia hautatuta Alt tekla sakatuta edukita.
Gehitu bigarren Button kontrola, eta ezarri horren OnSelect propietatea formula honetan eta exekuta ezazu:
```
ClearCollect( FirstExample,
   AddColumns( IceCreamSales, Revenue, UnitPrice * QuantitySold )
)
```
Fitxategia menuan, hautatu Bildumak eta, ondoren, hautatu IceCreamSales bilduma hori erakusteko.

Grafiko honek erakusten duen moduan, bigarren formulak ez du bilduma hau aldatu. Funtzioak AddColumnsIceCreamSales erabili zuen irakurtzeko soilik argumentu gisa; funtzioak ez zuen argumentu horri dagokion taula aldatu.
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.

Ohar-bidaltzea

Lagungarria izan al da orrialde hau?

Last updated on 2025-10-10