Funkcijos Rinkti, Išvalyti ir Išvalyti Kolekcionavimą

Sukuria ir išvalo rinkinius ir įtraukia įrašus į bet kurį duomenų šaltinį.

Collect

Taikoma: Drobės programos Kortelės Dataverse mažo kodo papildiniai Power Platform CLI Darbalaukio srautai

Rinkimo funkcija įtraukia įrašus į duomenų šaltinį. Elementai, kurie gali būti įtraukti:

• Viena reikšmė: reikšmė pateikiama naujo įrašo Reikšmės lauke. Visos kitos ypatybės paliekamos tuščios.
• Įrašas: kiekviena įvardyta ypatybė įdedama į atitinkamą naujo įrašo ypatybę. Visos kitos ypatybės paliekamos tuščios.
• Lentelė: kiekvienas lentelės įrašas įtraukiamas kaip atskiras duomenų šaltinio įrašas, kaip aprašyta pirmiau. Lentelė neįtraukiama į įrašą kaip įdėtoji lentelė. Norėdami tai atlikti, pirmiausia įkelkite lentelę į įrašą.

Naudojant su rinkiniu, prireikus bus sukurti papildomi stulpeliai. Kitų duomenų šaltinių stulpeliai fiksuojami pagal duomenų šaltinį ir naujų stulpelių negalima įtraukti.

Jei duomenų šaltinio dar nėra, sukuriamas rinkinys.

Rinkiniai kartais naudojami visuotiniams kintamiesiems laikyti arba laikinai duomenų šaltinio kopijai kurti. Drobės programos yra pagrįstos formulėmis, kurios automatiškai perskaičiuoja, kaip vartotojas sąveikauja su programa. Rinkiniai neturi šio pranašumo ir juos naudojant gali būti sunkiau kurti bei suprasti programą. Prieš naudodami rinkinį tokiu būdu, peržiūrėkite darbą su kintamaisiais.

Be to, galite naudoti Pataisos funkciją norėdami sukurti įrašų duomenų šaltinyje.

Rinkinys pateikia modifikuotą duomenų šaltinį kaip lentelę. Rinkinį galima naudoti tik veikimo formulėje.

Išvalyti

Taikoma: drobės programoms

Valymo funkcija panaikina visus rinkinio įrašus. Rinkinio stulpeliai išliks.

Atminkite, kad Valymas veikia tik rinkiniuose, o ne kituose duomenų šaltiniuose. Šiam tikslui galite naudoti RemoveIf( DataSource, true ). Būkite atsargūs, nes taip pašalinsite visus duomenų šaltinio saugykloje esančius įrašus ir gali būti paveikti kiti vartotojai.

Galite naudoti Šalinimo funkciją norėdami pašalinti pasirinktus įrašus.

Valyti neturi grąžinamos reikšmės. Ją galima naudoti tik veikimo formulėje.

ClearCollect

Taikoma: drobės programoms Modeliu pagrįstoms programoms

ClearCollect funkcija panaikina visus rinkinio įrašus. Tada į tą patį rinkinį įtraukiamas skirtingas įrašų rinkinys. Naudojant vieną funkciją ClearCollect siūlo Valymo ir Rinkimo derinį.

ClearCollect pateikia modifikuotą rinkinį kaip lentelę. ClearCollect galima naudoti tik veikimo formulėje.

Perdavimas

Kai šios funkcijos naudojamos su duomenų šaltiniu, jų perduoti negalima. Bus gauta tik pirmoji duomenų šaltinio dalis, o tada bus taikoma funkcija. Rezultatas gali apimti ne visą informaciją. Kuriant gali pasirodyti įspėjimas, priminsiantis šį apribojimą ir pasiūlysiantis, kur įmanoma, pereiti prie perduodamųjų alternatyvų. Norėdami gauti daugiau informacijos, žr. perdavimo apžvalgą.

Sintaksė

Rinkti( DataSource, Elementas, ... )

• DataSource – Būtinas. Duomenų šaltinis, į kurį norite įtraukti duomenis. Jeigu jo dar nėra, sukuriamas naujas rinkinys.
• Item(s) – būtina. Vienas ar daugiau įrašų arba lentelių, kurias reikia įtraukti į duomenų šaltinį.

Valyti( Rinkinys )

• Collection – būtina. Rinkinys, kurį norite išvalyti.

ClearCollect( Rinkinys, Elementas, ... )

• Collection – būtina. Rinkinys, kurį norite išvalyti ir tada įtraukti duomenis.
• Item(s) – būtina. Vienas ar daugiau įrašų arba lentelių, kurias reikia įtraukti į duomenų šaltinį.

Pavyzdžiai

Įrašų valymas ir įtraukimas į duomenų šaltinį

Šiuose pavyzdžiuose galėsite ištrinti ir įtraukti rinkinį, pavadintą IceCream. Duomenų šaltinis prasideda šiuo turiniu:

Formulė	Aprašymas	Rezultatas
ClearCollect( IceCream, { Flavor: "Strawberry", Quantity: 300 } )	Išvalo visus duomenis iš IceCream rinkinio, tada įtraukia įrašą, kuriame nurodytas braškių ledų kiekis.	IceCream rinkinys taip pat modifikuotas.
Collect( IceCream, { Flavor: "Pistachio", Quantity: 40 }, { Flavor: "Orange", Quantity: 200 } )	Įtraukia du įrašus į IceCream rinkinį, kuriame nurodytas pistacijų ir apelsinų ledų kiekis.	IceCream rinkinys taip pat modifikuotas.
Clear( Ledai )	Pašalina visus įrašus iš IceCream rinkinio.	IceCream rinkinys taip pat modifikuotas.

Nuoseklių pavyzdžių, kaip sukurti rinkinį, žr. Rinkinio kūrimas ir naujinimas.

Įrašai ir lentelės

Šiuose pavyzdžiuose nagrinėjama, kaip tvarkomi įrašų ir lentelių argumentai naudojant Rinkti ir ClearCollect.

Formulė	Aprašas	Rezultatas
ClearCollect( IceCream, { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } )	Išvalo visus duomenis ir įtraukia du įrašus į IceCream rinkinį, kuriame nurodytas šokolado ir vanilės ledų kiekis. Įrašai, kuriuos reikia įtraukti, pateikiami kaip atskiri funkcijos argumentai.	IceCream rinkinys taip pat modifikuotas.
ClearCollect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } ) )	Taip pat kaip ankstesniame pavyzdyje, išskyrus tai, kad įrašai sujungiami į lentelę ir perduodami naudojant vieną argumentą. Lentelės turinys išskleidžiamas po vieną įrašą prieš įtraukiant į IceCream rinkinį.	IceCream rinkinys taip pat modifikuotas.
ClearCollect( IceCream, { MyFavorites: Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } ) } )	Taip pat kaip ir ankstesniame pavyzdyje, išskyrus tai, kad lentelė bus įkelta į įrašą. Lentelės įrašai neišskleidžiami, bet visa lentelė įtraukiama kaip įrašo langelis.	IceCream rinkinys taip pat modifikuotas.