Collect, Clearжәне ClearCollect функциялары

Function	Мынаған қолданылады
Clear	Кенеп бағдарламалары Жұмыс үстелі ағындары Power Platform CLI Dataverse функциялары
ClearCollect	Кенеп бағдарламалары Жұмыс үстелі ағындары Power Platform CLI
Collect	Кенеп бағдарламалары Жұмыс үстелі ағындары Үлгіге негізделген бағдарламалар Power Platform CLI Dataverse функциялары

Жинақтарды жасайды және тазалайды әрі кез келген деректер көзінежазбаларды қосады.

Collect

Функция Collect деректер көзіне жазбаларды қосады. Қосатын элементтер мыналар болуы мүмкін:

• Бір мән: мән жаңа жазбаның Value өрісіне орналастырылады. Барлық басқа сипаттар blank (бос) қалдырылады.
• Жазба: әрбір аталған сипат жаңа жазбаның сәйкес сипатына орналастырылады. Барлық басқа сипаттар blank (бос) қалдырылады.
• Кесте: кестенің әр жазбасы жоғарыда сипатталғандай деректер көзінің жеке жазбасы ретінде қосылады. Кесте жазбаға кірістірілген кесте ретінде қосылмайды. Мұны істеу үшін алдымен кестені жазбамен орап алыңыз.

Жинақпен бірге пайдаланғанда, қажет кезде қосымша бағандар жасалады. Басқа деректер кездері үшін бағандарды деректер көзі бекітеді және жаңа бағандарды қосу мүмкін емес.

Егер деректер көзі бұрыннан болмаса, жинақ жасалады.

Жинақтар кейде глобалдық айнымалыларды сақтау немесе деректер көзінің уақытша көшірмесін жасау үшін пайдаланылады. Кенеп бағдарламалары пайдаланушы бағдарламамен өзара әрекеттескен кезде автоматты түрде қайта есептелетін формулаларға негізделеді. Жинақтарда бұл артықшылық жоқ және оларды пайдалану бағдарламаңызды жасау және түсінуді қиындатуы мүмкін. Жинақты осылай пайдаланбас бұрын айнымалылармен жұмыс істеу бөлімін қарап шығыңыз.

Сондай-ақ деректер көзінде жазбаларды жасау үшін Patch функциясын пайдалануға болады.

Collect Өзгертілген деректер көзін кесте ретінде қайтарады. Collect Оны тек белгілі бір іс-әрекетте ғана қолдануға болады.

Clear

Функция Clear жиынтықтың барлық жазбаларын жояды. Жинақтың бағандары қалады.

Назар аударыңыз, Clear тек деректер көздері бойынша емес, басқа деректер көздері бойынша жұмыс істейді. Бұл мақсатта RemoveIf( DataSource, true ) функциясын пайдалана аласыз. Сақ болыңыз, өйткені бұл деректер көзі қоймасындағы барлық жазбаларды жояды және басқа пайдаланушыларға әсер етуі мүмкін.

Жазбаларды таңдау бойынша жою үшін Remove функциясын пайдалана аласыз.

Clear Қайтару құндылығы жоқ. Оны тек мінез-құлық формуласында пайдалануға болады.

ClearCollect

Функция ClearCollect жиынтықтағы барлық жазбаларды жояды. Бір жинаққа жазбалардың әртүрлі жинағын қосады. Бірегей ClearCollectClear функция арқылы біріктіріледі және содан Collectкейін .

ClearCollect Өзгертілген жиынды кесте ретінде қайтарады. ClearCollect Оны тек белгілі бір іс-әрекетте ғана қолдануға болады.

Өкіл

Деректер көзімен бірге пайдаланылғанда, бұл функция тағайындалмайды. Деректер көзінің бірінші бөлімі ғана алынып, функция қолданылады. Нәтиже толық тарихты білдірмейді. Ескерту авторлық уақытта осы шектеу туралы еске салу және мүмкіндігінше жіберілетін баламалы нұсқаларды ауыстыруды ұсыну үшін пайда болуы мүмкін. Қосымша ақпарат алу үшін, Өкілдік шолуы бөлімін қараңыз.

Синтаксис

Collect( Деректер көзі, элемент, ... )

• Деректер көзі – Міндетті. Деректер қосқыңыз келетін деректер көзі. Егер бұрыннан болмаса, жаңа жинақ жасалады.
• Элементтер - Міндетті. Деректер көзіне қосатын бір немесе бірнеше жазбалар немесе кестелер.

Clear( Коллекция )

• Жинақ – Міндетті. Тазалағыңыз келетін жинақ.

ClearCollect( Коллекция, элемент, ... )

• Жинақ – Міндетті. Тазалап, содан кейін деректерді қосқыңыз келетін жинақ.
• Элементтер - Міндетті. Деректер көзіне қосатын бір немесе бірнеше жазбалар немесе кестелер.

Мысалдар

Деректер көзінен жазбаларды тазалау және қосу

Осы мысалдарда сіз IceCream атты жинақты өшіресіз және оған қосасыз. Деректер көзі мына мазмұнмен басталады:

Формула	Сипаттамасы	Нәтиже
ClearCollect( Балмұздақ, { Хош иістендіргіш: «Құлпынай», Саны: 300 } )	IceCream жинағынан барлық деректерді тазалайды, содан кейін құлпынай балмұздағының мөлшерін қамтитын жазбаны қосады.	IceCream жинағы да өзгертілді.
Collect( Балмұздақ, { Хош иістендіргіш: «Фисташка», Саны: 40 }, { Дәм: «апельсин», Саны: 200 } )	IceCream жинағына фисташка және апельсин балмұздағының мөлшерін қамтитын екі жазбаны қосады.	IceCream жинағы да өзгертілді.
Clear( Балмұздақ )	IceCream жинағынан барлық жазбаларды жояды.	IceCream жинағы да өзгертілді.

Жинақты жасау жолының қадамдық мысалдарын Жинақты жасау және жаңарту бөлімінен қараңыз.

Жазбалар және кестелер

Бұл мысалдарда жазба мен кесте аргументтері Collect қалай өңделетінін ClearCollect және өңделетінін қарастырады.

Формула	Сипаттамасы	Нәтиже
ClearCollect( IceCream, { Flavor: "Chocolate", Саны: 100 }, { Flavor: "Vanilla", Саны: 200 } )	Clear Барлық деректер, содан кейін Балмұздақ коллекциясына шоколад пен ванильді балмұздақтың мөлшерін қамтитын екі жазба қосады. Қосылатын жазбалар функцияның жеке аргументтері ретінде беріледі.	IceCream жинағы да өзгертілді.
ClearCollect( Балмұздақ, Кесте( { Хош иістендіргіш: "Шоколад", Саны: 100 }, { Хош иістендіргіш: "Ваниль", Саны: 200 } ) )	Алдыңғы мысалға ұқсас, тек жазбалар кестеде біріктіріліп, бір аргумент арқылы өткізіледі. Кестенің мазмұны IceCream жинағына қосылмастан бұрын әр жазбадан кезекпен шығарып алынады.	IceCream жинағы да өзгертілді.
ClearCollect( Балмұздақ, { MyFavorites: Table( { Flavor: "Chocolate", Саны: 100 }, { Flavor: "Vanilla", Саны: 200 } ) } )	Алдыңғы мысалмен бірдей, тек кесте жазбамен орап алынады. Кестенің жазбалары шығарып алынбайды және оның орнына бүкіл кесте жазбаның ұяшығы түрінде қосылады.	IceCream жинағы да өзгертілді.