Collect, Clearja ClearCollect funktsioonid

Funktsioon	Kehtib järgmiste puhul
Clear	Lõuendirakendused Töölauavood Power Platform CLI Dataverse'i funktsioonid
ClearCollect	Lõuendirakendused Töölauavood Power Platform CLI
Collect	Lõuendirakendused Töölauavood Mudelipõhised rakendused Power Platform CLI Dataverse'i funktsioonid

Loob ja kustutab kollektsioonid ning lisab kirjed igale andmeallikale.

Collect

Funktsioon Collect lisab kirjed andmeallikasse. Lisatavad kirjed võivad olla järgmised.

• Üks väärtus: väärtus paigutatakse uue kirje väljale Value (Väärtus). Kõik ülejäänud atribuudid jäävad väärtusega blank.
• Kirje: iga nimega atribuut paigutatakse uue kirje vastavasse atribuuti. Kõik ülejäänud atribuudid jäävad tühjaks.
• Tabel : iga tabeli kirje lisatakse eespool kirjeldatud andmeallikasse eraldi kirjena. Tabelit ei lisata kirjele pesastatud tabelina. Selleks mähige tabel esmalt kirjesse.

Kui seda kasutatakse koos kollektsiooniga, luuakse vajadusel täiendavad veerud. Teiste andmeallikate veerud fikseerib andmeallikas ja uusi veerge ei saa lisada.

Andmeallika puudumisel luuakse kollektsioon.

Kollektsioone kasutatakse mõnikord globaalsete muutujate hoidmiseks või andmeallikast ajutise koopia tegemiseks. Lõuendirakendused põhinevad valemitel, mis arvutatakse automaatselt, kui kasutaja suhtleb rakendusega. Kollektsioonid ei paku seda eelist ning nende kasutamine võib muuta rakenduse loomise ja mõistmise keerulisemaks. Enne kollektsiooni kasutamist sel viisil vaadake üle jaotis muutujatega töötamine.

Andmeallikasse kirjete loomiseks saate kasutada ka funktsiooni Patch (Plaasterda).

Collect tagastab muudetud andmeallika tabelina. Collect saab kasutada ainult käitumisvalemis.

Clear

Funktsioon Clear kustutab kõik kogumiku kirjed. Kollektsiooni veerud jäävad alles.

Võtke arvesse, et Clear see töötab ainult kollektsioonides, mitte muudes andmeallikates. Selleks eesmärgiks saate kaustada RemoveIf( DataSource, true ). Olge ettevaatlik, kuna see eemaldab kõik andmed andmeallika salvestusruumist ja võib mõjutada teisi kasutajaid.

Kirjete valikuliseks eemaldamiseks saate kasutada funktsiooni Remove (Eemalda).

Clear tagastatud väärtus puudub. Seda saab kasutada ainult käitumise valemis.

ClearCollect

Funktsioon ClearCollect kustutab kogumist kõik kirjed. Seejärel lisatakse samasse kollektsiooni teistsugune kirjete kollektsioon. Ühe funktsiooniga ClearCollect pakub kombinatsiooni Clear ja seejärel Collect.

ClearCollect tagastab muudetud kogumiku tabelina. ClearCollect saab kasutada ainult käitumisvalemis.

Delegeerimine

Koos andmeallikaga kasutamisel ei saa neid funktsioone delegeerida. Tuuakse ainult andmeallika esimene osa ja seejärel rakendatakse funktsioon. Tulem ei pruugi esindada täielikku lugu. Koostamise ajal võidakse kuvada hoiatus, mis tuletab teile seda piirangut meelde ja soovitab võimalusel lülituda delegeeritavatele alternatiividele. Lisateabe saamiseks vt delegeerimise ülevaadet.

Süntaks

Collect( DataSource, Item, ... )

• DataSource – nõutav. Andmeallikas, millele soovite andmeid lisada. Kui seda veel pole, luuakse uus kollektsioon.
• Nõutavad esemed . Üks või mitu kirjet või tabelit andmeallikasse lisamiseks.

Clear( Kogumik )

• Kollektsioon – nõutav. Kollektsioon, mille soovite tühjendada.

ClearCollect( Kogum, üksus, ... )

• Kollektsioon – nõutav. Kollektsioon, mille soovite kustutada ja siis millele andmed lisada.
• Nõutavad esemed . Üks või mitu kirjet või tabelit andmeallikasse lisamiseks.

Näited

Kirjete kustutamine ja lisamine andmeallikasse.

Nendes näidetes saate kustutada ja lisada kollektsiooni, mille nimi on IceCream. Andmeallikas algab järgmise sisuga.

Valem	Kirjeldus	Tulemus
ClearCollect( IceCream, { Maitse: "Maasikas", Kogus: 300 } )	Kustutab kõik andmed kollektsioonist IceCream ja lisab seejärel kirje, mis sisaldab maasika jäätise kogust.	Andmeallikat IceCream on muudetud.
Collect( IceCream, { Flavor: "Pistachio", Kogus: 40 }, { Maitse: "Oranž", Kogus: 200 } )	Lisab kaks kirjet kollektsiooni IceCream, mis sisaldab pistaatsiapähkleid ja apelsinijäätist.	Andmeallikat IceCream on muudetud.
Clear( IceCream )	Eemaldab kõik kirjed kollektsioonist IceCream.	Andmeallikat IceCream on muudetud.

Üksikasjalikku teavet kollektsiooni loomise kohta leiate teemast Kollektsiooni loomine ja värskendamine.

Kirjed ja tabelid

Need näited uurivad, kuidas kirje- ja tabeliargumente Collect käsitletakse ja ClearCollect käsitletakse.

Valem	Kirjeldus	Tulemus
ClearCollect( IceCream, { Maitse: "Šokolaad", Kogus: 100 }, { Maitse: "Vanilla", Kogus: 200 } )	Clear kõik andmed ja seejärel lisab IceCream kogusse kaks kirjet, mis sisaldavad šokolaadi ja vanillijäätist. Lisatavad kirjed esitatakse funktsiooni üksikute argumentidena.	Andmeallikat IceCream on muudetud.
ClearCollect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Kogus: 200 } )	Sama nagu eelmises näites, välja arvatud see, et kirjed ühendatakse tabelisse ja sisestatakse ühe argumendi kaudu. Tabeli sisu ekstraheeritakse kirje kaupa enne kollektsiooni IceCream lisamist.	Andmeallikat IceCream on muudetud.
ClearCollect( IceCream, { MyFavorites: Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Kogus: 200 } ) } )	Sama nagu eelmises näites, välja arvatud see, et tabel on kirjega mähitud. Tabeli kirjeid ei ekstraheerita ja selle asemel lisatakse kogu tabel kirje lahtrina.	Andmeallikat IceCream on muudetud.