Функции "Събиране", "Изчистване" и "ClearCollect"

Създава и изчиства колекции и добавя записи до всеки източник на данни.

Collect

Отнася се за: Canvas apps Cards Dataverse low-code plug-ins Power Platform CLI Desktop flows

Функцията 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) - Задължително. Един или повече записи или таблици, които да добавите към източник на данни.

Примери

Изчистване и добавяне на записи към източник на данни

В тези примери ще изтриете и добавите към колекция с име Сладолед. Източник на данни започва с това съдържание:

Формула	Описание	Резултат
ClearCollect( IceCream, { Flavor: "Strawberry", Quantity: 300 } )	Изчиства всички данни от колекцията Сладолед и след това добавя запис, който включва количество сладолед от ягоди.	Колекцията Сладолед също е модифицирана.
Collect( IceCream, { Flavor: "Pistachio", Quantity: 40 }, { Flavor: "Orange", Quantity: 200 } )	Добавя два записа към колекцията Сладолед, която включва количество сладолед от шам-фъстък и портокал.	Колекцията Сладолед също е модифицирана.
Clear( IceCream )	Премахва всички записи от колекцията Сладолед.	Колекцията Сладолед също е модифицирана.

Вижте стъпка по стъпка примери за създаване на колекция вижте Създайте и актуализирайте колекция.

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

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

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