Функције Цоллецт, Цлеар и ЦлеарЦоллецт

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

Collect

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

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

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

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

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

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

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

Цоллецт враћа модификовани < ДИЦТ__извор података > дата соурце као табелу. Цоллецт се може користити само у формули понашања.

Обриши

Односи се на: Цанвас апликације

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

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

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

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

ClearCollect

Односи се на: Цанвас апликације Апликације засноване на моделу

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

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

Делегирање

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

Синтакса

Цоллецт ( ДатаСоурце,Итем , ...)

• ДатаСоурце – Обавезно. Извор података у који желите да додате податке. Ако већ не постоји, креира се нова колекција.
• Предмети - Обавезно. Један или више записа или табела које треба додати у извор података.

Јасно( Колекција )

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

ЦлеарЦоллецт ( колекција , ставка , ... )

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

Примери

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

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

Формула	Опис	Резултат
ЦлеарЦоллецт ( Сладолед, { укус: "јагода", количина: 300 } )	Брише све податке из колекције IceCream, а затим додаје запис који укључује количину сладоледа од јагоде.	Колекција IceCream је такође измењена.
Цоллецт ( ИцеЦреам, { Укус: "Пистација", Количина: 40 }, { Укус: "Наранџаста", Количина: 200 } )	Додаје два записа у колекцију IceCream која укључује количину сладоледа од пистације и наранџе.	Колекција IceCream је такође измењена.
Јасно ( сладолед )	Уклања све записе из колекције IceCream.	Колекција IceCream је такође измењена.

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

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

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

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