Collect, Cleareta ClearCollect funtzioak

Function	Honi dagokio
Clear	Mihise-aplikazioak Mahaigaineko fluxuak Power Platform CLI Dataverse funtzioak
ClearCollect	Oihaleko aplikazioak Mahaigaineko fluxuak Power Platform CLI
Collect	Mihise-aplikazioak Mahaigaineko fluxuak Ereduetan oinarritutako aplikazioak Power Platform CLI Dataverse funtzioak

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

Collect

Funtzioak Collect erregistroak gehitzen dizkio datu-iturri bati. 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 Aldatutako datu-iturburua taula gisa itzultzen du. Collect Portaera formula batean soilik erabil daiteke.

Clear

Funtzioak Clear bilduma bateko erregistro guztiak ezabatzen ditu. Bildumako zutabeak geratuko dira.

Kontuan izan bildumetan bakarrik funtzionatzen duela Clear , 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.

Clear Ez du itzulketa-baliorik. Bakarrik erabil daiteke portaera formula aukerarekin.

ClearCollect

Funtzio honek ClearCollect bilduma bateko erregistro guztiak ezabatzen ditu. Ondoren, bilduma berean beste erregistro multzo bat gehitzen da. Funtzio bakar batekin, ClearCollect eta ondoren Collectkonbinazioa Clear eskaintzen du.

ClearCollect 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

Collect( DataSource, Item, ... )

• 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.

Clear(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, { Zaporea: "Marrubi", 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.
Collect( Izozkia, { Zaporea: "Pistatxoa", Kantitatea: 40 }, { Zaporea: "Laranja", Kantitatea: 200 } )	Bi erregistro gehitzen ditu Izozkia bilduma pistatxo eta laranja izozkiak biltzen dituen bilduma.	Izozkia bilduma ere aldatu egin da.
Clear( 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 erregistro eta taulako argumentuak nola kudeatzen diren Collect eta ClearCollect nola kudeatzen diren aztertzen dute.

Formula	Deskribapenak	Emaitza
ClearCollect( Izozkia, { Zaporea: "Txokolatea", Kantitatea: 100 }, { Zaporea: "Bainila", Kantitatea: 200 } )	Clear datu guztiak eta, ondoren, bi erregistro gehitzen dizkio IceCream bildumari, txokolate eta bainila izozkia kopuru bat barne hartzen duena. Gehitu beharreko erregistroak funtzioaren argudio indibidual gisa ematen dira.	Izozkia bilduma ere aldatu egin da.
ClearCollect( Izozkia, Taula ( { Zapore: "Txokolatea", Kantitatea: 100 }, { Zapore: "Bainila", 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.