Функције "Прикупи", "Обриши" и "ЦлеарЦоллецт"

Креира и брише колекције и додаје записе у сваки извор података.

Collect

Важи за: Цанвас апликације Картице Dataverse < ДИЦТ__ниско кодирање > лоw-цоде ЦЛИ Power Platform Десктоп токове

Функција Collect додаје записе у извор података. Ставке које треба додати могу бити:

• Једна вредност: Вредност је смештена у поље Value новог записа. Сва остала својства су остављена blank.
• Запис: Свако именовано својство се налази у одговарајућем својству новог записа. Сва остала својства су остављена празна.
• Табела: Сваки запис табеле додаје се као посебан запис извора података, као што је горе описано. Табела се не додаје као угнежђена табела у запис. Да бисте то учинили, прво умотајте табелу у запис.

Када се користе са колекцијом, додатне колоне креираће се по потреби. Колоне за друге изворе података су фиксиране према извору података и нове колоне се не могу додавати.

Ако извор података већ не постоји, креира се колекција.

Колекције се понекад користе за задржавање глобалних променљивих или за привремену копију извора података. Апликације са подлогом се заснивају на формулама које се аутоматски прерачунавају док је корисник у интеракцији са апликацијом. Колекције не уживају ову предност и њихово коришћење може вашој апликацији отежати креирање и разумевање. Пре употребе колекције на овај начин, прегледајте рад са променљивим.

Такође можете да користите функцију Patch да бисте креирали записе у извору података.

Collect враћа измењени извор података као табелу. Collect може се користити само у формули понашања.

Обриши

Важи за: Цанвас апликације

Функција Clear брише све записе збирке. Колоне збирке ће остати.

Имајте у виду да функција Clear делује само на збирке, а не на друге изворе података. Можете користити RemoveIf( DataSource, true ) за ову сврху. Будите опрезни, јер ћете тако уклонити све записе из складишта извора података и то може утицати на друге кориснике.

Можете користити функцију Remove за селективно уклањање записа.

Clear нема повратну вредност. Може се користити само у формули понашања.

ClearCollect

Важи за: Цанвас апликације Модел-дривен апликације

Функција ClearCollect брише све записе из колекције. А онда у исту колекцију додаје другачији скуп записа. У једној функцији, ClearCollect нуди комбинацију функција Clear и Collect.

ClearCollect враћа измењену колекцију као табелу. ClearCollect може се користити само у формули понашања.

Делегирање

Када ове функције користите уз извор података, не можете их делегирати. Само први део извора података ће бити преузет, а затим примењена функција. Резултат можда не представља комплетну слику. Упозорење може да се приказује у тренутку креирања као подсетник на ово ограничење и да вам предложи прелазак на алтернативне опције које је могуће делегирати, где је то могуће. Више информација потражите у прегледу делегирања.

Синтакса

Collect( DataSource, Item, ... )

• DataSource – Обавезно. Извор података у који желите да додате податке. Ако већ не постоји, креира се нова колекција.
• Item(s) – Обавезно. Један или више записа или табела које треба додати у извор података.

Clear( Collection )

• Collection – Обавезно. Колекција коју желите да обришете.

ClearCollect( Collection, Item, ... )

• Collection – Обавезно. Колекцију коју желите да обришете, а затим у њу додате податке.
• Item(s) – Обавезно. Један или више записа или табела које треба додати у извор података.

Примери

Брисање и додавање записа у извор података

У овим примерима ћете избрисати и додати у колекцију која је названа IceCream. Извор података почиње са овим садржајем:

Формула	Опис	Резултат
ClearCollect( IceCream, { Flavor: "Strawberry", Quantity: 300 } )	Брише све податке из колекције IceCream, а затим додаје запис који укључује количину сладоледа од јагоде.	Колекција IceCream је такође измењена.
Collect( IceCream, { Flavor: "Pistachio", Quantity: 40 }, { Flavor: "Orange", Quantity: 200 } )	Додаје два записа у колекцију IceCream која укључује количину сладоледа од пистације и наранџе.	Колекција IceCream је такође измењена.
Clear( IceCream )	Уклања све записе из колекције IceCream.	Колекција IceCream је такође измењена.

Детаљне примере како да направите колекцију потражите у чланку Креирање и ажурирање колекције.

Записи и табеле

Ови примери истражују како се рукује аргументима табела и записа у функцијама Collect и ClearCollect.

Формула	Опис	Резултат
ClearCollect( IceCream, { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } )	Брише све податке, а затим додаје два записа у колекцију IceCream, која садржи количину сладоледа од чоколаде и ваниле. Записи који се додају дају се као појединачни аргументи функције.	Колекција IceCream је такође измењена.
ClearCollect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } ) )	Исто као и претходни пример, осим што су записи комбиновани у табели и прослеђени кроз један аргумент. Садржај табеле извлачи се један по један запис пре него што се дода у колекцију IceCream.	Колекција IceCream је такође измењена.
ClearCollect( IceCream, { MyFavorites: Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } ) } )	Исто као и претходни пример, осим што је табела умотана у запис. Записи табеле се не извлаче и уместо тога цела табела се додаје као ћелија записа.	Колекција IceCream је такође измењена.