Bildu, Garbitu eta ClearCollect funtzioak

Sortu eta garbitu Bildumak eta gehitzen du erregistroak edozeinetara datu-iturburua.

Collect

Hauei aplikatzen zaie: Canvas aplikazioak Txartelak Dataverse kode baxu pluginak Power Platform CLI Mahaigaineko fluxuak

Collect funtzioak datu-iturburu-era erregistroak gehitzen ditu. Gehitu beharreko elementuak hauek izan daitezke:

• Balio bakarra: balioa balioan kokatzen da Value erregistro berri baten eremua. Gainerako propietate guztiak geratzen dira blank.
• Erregistro bat: izendatutako jabetza bakoitza erregistro berri baten propietatean kokatzen da. Gainerako propietate guztiak geratzen dira hutsik.
• Taula: Taulako erregistro bakoitza datu-iturburu-en erregistro berezi gisa gehitzen da goian deskribatu bezala. Taula ez da taula habia gisa gehitu erregistro batean. Horretarako, lehenik eta behin, bildu taula batean erregistro batean.

Bilduma batekin erabiltzen denean, osagarria zutabeak behar den moduan sortuko da. Beste datu-iturrietarako zutabeak datu-iturburu konponduta daude eta zutabe berriak ezin dira gehitu.

datu-iturburu dagoeneko ez badago, bilduma bat sortzen da.

Bildumak aldagai globalak gordetzeko edo datu-iturburu baten aldi baterako kopia egiteko erabiltzen dira. Mihise aplikazioak erabiltzaileak aplikazio batekin elkarreraginean automatikoki berriz kalkulatzen diren formuletan oinarritzen dira. Bildumak ez dute onura hori gozatzen eta horien erabilera zure aplikazioa zailagoa izan daiteke ulertzeko. Bilduma modu honetan erabili aurretik, berrikusi aldagaiekin lan eginez.

Erabili dezakezu ere bai adabakia funtzioa sortu erregistroak datu-iturburuan.

Collect k aldatutako datu-iturburu taula gisa itzultzen du. Collect portaera formula batean soilik erabil daiteke.

Garbitu eremuak

Honi dagokio: Canvas aplikazioei

Clear funtzioak bilduma baten erregistro guztiak ezabatzen ditu. Bildumako zutabeak geratuko dira.

Apuntatu hori Garbitu Bildumetan bakarrik funtzionatzen du eta ez beste datu-iturri batzuetan. Erabil dezakezu RemoveIf( Datu-iturburua, egia ) horretarako. Kontuz ibili horrela, erregistro guztiak datu-iturburu biltegitik kenduko ditu eta beste erabiltzaileei eragin diezaieke.

Erabili egin dezakezu Kendu funtzioa hautatzeko kentzeko erregistroak.

Garbitu k ez du itzulera-baliorik. Bakarrik erabil daiteke portaera formula aukerarekin.

ClearCollect

Hauei aplikatzen zaie: Canvas aplikazioei Ereduetan oinarritutako aplikazioei

ClearCollect funtzioak bilduma baten erregistro guztiak ezabatzen ditu. Ondoren, bilduma berean beste erregistro multzo bat gehitzen da. Funtzio bakarrarekin, ClearCollect nahasketa eskaintzen du Clear eta gero Collect.

ClearCollect k aldatutako bilduma taula gisa itzultzen du. ClearCollect portaera-formula batean soilik erabil daiteke.

Ordezkaritza

Datu-iturburu batekin erabiltzean, funtzio hauek ezin dira ordezkatu. Datu-iturburuaren lehen zatia soilik berreskuratuko da eta, ondoren, funtzioa aplikatuko da. Baliteke emaitzak istorio osoa ez ordeztea. Abisu bat ager daiteke aginte-garaian muga hori gogorarazteko eta, ahal denean, alternatiba ordezkagarrietara aldatzea iradokitzeko. Informazio gehiago eskuratzeko, ikusi ordezkaritzaren informazio orokorra.

Sintaxia

Bildu( Datu-iturria, Elementua, ... )

• DataSource – Beharrezkoa. Datuak gehitu nahi dituzun datu-iturburu. Dagoeneko ez badago, bilduma berria bat sortzen da.
• Elementuak - Beharrezkoa. datu-iturburu-era gehitzeko erregistro edo taula bat edo gehiago.

Garbitu( Bilduma )

• Bilduma – Beharrezkoa. Garbitu nahi duzun bilduma.

ClearCollect( Bilduma, Elementua, ... )

• Bilduma – Beharrezkoa. Garbitu nahi duzun bilduma eta ondoren datuak gehitu.
• Elementuak - Beharrezkoa. datu-iturburu-era gehitzeko erregistro edo taula bat edo gehiago.

Adibideak

datu-iturburu batean erregistroak garbitu eta gehitu

Adibide hauetan izen hori duen bilduma bat ezabatu eta gehituko duzu Izozkia. Eduki hauekin hasten da datu-iturburu:

Formula	Deskribapenak	Emaitza
ClearCollect(Izozkia, { Zorea: "Marrubia", Kantitatea: 300 } )	Datu guztiak garbitzen ditu Izozkia bildu eta gero marrubi izozki kantitate bat biltzen duen erregistro bat gehitzen du.	Izozkia bilduma ere aldatu egin da.
Bildu( Izozkia, { Zaporea: "Pistatxoa", Kantitatea: 40 }, { Zorea: "Laranja", Kantitatea: 200 } )	Bi erregistro gehitzen ditu Izozkia bilduma pistatxo eta laranja izozkiak biltzen dituen bilduma.	Izozkia bilduma ere aldatu egin da.
Garbitu (Izozkia)	Kendu erregistro guztiak Izozkia bilduma.	Izozkia bilduma ere aldatu egin da.

Bilduma bat sortzeko pausoen adibideetarako, ikus Bilduma sortu eta eguneratu.

Erregistroak eta taulak

Adibide hauek nola erregistratu eta taulako argudioak Bildu eta ClearCollect maneiatzen dira.

Formula	Deskribapenak	Emaitza
ClearCollect( Izozkia, { Zaporea: "Txokolatea", Kantitatea: 100 }, { Zorea: "Bainilla", Kantitatea: 200 } )	Garbitu datu guztiak eta gero gehitu bi erregistroak Izozkia bildua barne hartzen duena txokolate eta banilla izozkiaren kantitatea. Gehitu beharreko erregistroak funtzioaren argudio indibidual gisa ematen dira.	Izozkia bilduma ere aldatu egin da.
ClearCollect( Izozkia, Mahaia( { Zaporea: "Txokolatea", Kantitatea: 100 }, { Zaporea: "Banilla", Kantitatea: 200 } ))	Aurreko adibidearen berdina, erregistroak taula batean konbinatu eta argumentu bakarraren bidez pasatzen direla izan ezik. Taularen edukia erregistroaren bidez ateratzen da erregistrora gehitu aurretik Izozkia bilduma.	Izozkia bilduma ere aldatu egin da.
ClearCollect( izozkia, { MyFavorites: Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } ) } )	Aurreko adibidearen berdina taula erregistro batean bilduta dagoela izan ezik. Taularen erregistroak ez dira ateratzen eta taularen ordez erregistroaren gelaxka gisa gehitzen da.	Izozkia bilduma ere aldatu egin da.