Funcțiile Collect, Clear și ClearCollect

Creează și șterge colecții și adaugă înregistrări la oricare sursă de date.

Collect

Se aplică pentru: Aplicații Canvas Carduri Dataverse pluginuri low-code Power Platform CLI Fluxuri desktop

Funcția Collect adaugă înregistrări la o sursă de date. Elementele care trebuie adăugate pot fi:

• O singură valoare: valoarea este plasată în câmpul Value al unei noi înregistrări. Toate celelalte proprietăți au rămas necompletate blank.
• O înregistrare: Fiecare proprietate numită este plasată în proprietatea corespunzătoare a unei noi înregistrări. Toate celelalte proprietăți au rămas necompletate.
• Un tabel: Fiecare înregistrare a tabelului este adăugată ca o înregistrare separată a sursei de date, așa cum este descris mai sus. Tabelul nu este adăugat ca un tabel imbricat la o înregistrare. Pentru a face acest lucru, imbricați mai întâi tabelul într-o înregistrare.

Când este utilizat cu o colecție, vor fi create coloane suplimentare, după nevoie. Coloanele pentru alte surse de date sunt fixate de sursa de date și nu pot fi adăugate coloane noi.

Dacă sursa de date nu există deja, se creează o colecție.

Uneori, colecțiile sunt folosite pentru a reține variabile globale sau pentru a face o copie temporară a unei surse de date. Aplicațiile proiectate pe pânză se bazează pe formule care se recalculează automat pe măsură ce utilizatorul interacționează cu o aplicație. Colecțiile nu se bucură de acest beneficiu, și utilizarea lor poate îngreuna crearea și înțelegerea aplicației dvs. Înainte de a utiliza o colecție în acest mod, consultați lucrul cu variabile.

Puteți utiliza, de asemenea, funcția Patch pentru a crea înregistrări într-un sursă de date.

Colectarea returnează sursa de date modificată ca un tabel. Colectarea poate fi folosită doar într-o formulă comportamentală.

Goliți

Se aplică pentru: aplicații Canvas

Funcția Clear șterge toate înregistrările unei colecții. Coloanele colecției vor rămâne.

Rețineți că Ștergeți operează numai pe colecții și nu pe alte surse de date. Puteți folosi RemoveIf( DataSource, true ) în acest scop. Aveți grijă deoarece acest lucru va elimina toate înregistrările din stocarea sursă de date și poate afecta alți utilizatori.

Puteți utiliza funcția Remove pentru a elimina selectiv înregistrările.

Ștergeți nu are valoare de returnare. Poate fi folosită doar într-o formulă comportamentală.

ClearCollect

Se aplică pentru: Aplicații Canvas Aplicații bazate pe model

Funcția ClearCollect șterge toate înregistrările dintr-o colecție. Și apoi adaugă un set diferit de înregistrări la aceeași colecție. Cu o singură funcție, ClearCollect oferă combinația de Clear și apoi Collect.

ClearCollect returnează colecția modificată ca un tabel. ClearCollect poate fi folosită doar într-o formulă comportamentală.

Delegare

Atunci când se folosesc cu o sursă de date, aceste funcții nu pot fi delegate. Doar prima porțiune a sursei de date va fi regăsită, apoi se va aplica funcția. Este posibil ca rezultatul să nu reprezinte întreaga situație. Poate apărea un avertisment la momentul creării, pentru a vă aminti de această limitare și pentru a sugera comutarea la alternative ce se pot delega, atunci când este posibil. Pentru mai multe informații, consultați prezentarea generală a delegării.

Sintaxă

Collect( DataSource, Element, ... )

• DataSource – Obligatoriu. Sursa de date la care doriți să adăugați date. Dacă nu există deja, se creează o nouă colecție.
• Element(e) - Obligatorii. Una sau mai multe înregistrări sau tabele de adăugat la sursa de date.

Ștergere( Colecție )

• Collection - Obligatoriu. Colecția pe care doriți să o ștergeți.

ClearCollect( Colecție, Element, ... )

• Collection - Obligatoriu. Colecția în care doriți să ștergeți și apoi să adăugați date.
• Element(e) - Obligatorii. Una sau mai multe înregistrări sau tabele de adăugat la sursa de date.

Exemple

Ștergerea și adăugarea înregistrărilor la un sursă de date

În aceste exemple, veți șterge și adăuga la o colecție numită Înghețată. Sursa de date începe cu acest conținut:

Formula	Descriere	Rezultat
ClearCollect( IceCream, { Flavor: "Strawberry", Quantity: 300 } )	Șterge toate datele din colecția Înghețată și apoi adaugă o înregistrare care include o cantitate de înghețată cu căpșuni.	Colecția Înghețată a fost, de asemenea, modificată.
Collect( IceCream, { Flavor: "Pistachio", Quantity: 40 }, { Flavor: "Orange", Quantity: 200 } )	Adaugă două înregistrări la colecția Înghețată care include o cantitate de înghețată cu fistic și portocale.	Colecția Înghețată a fost, de asemenea, modificată.
Clear( Înghețată )	Elimină toate înregistrările din colecția Înghețată.	Colecția Înghețată a fost, de asemenea, modificată.

Pentru exemple pas cu pas despre crearea unei colecții, consultați Creați și actualizați o colecție.

Înregistrări și tabele

Aceste exemple examinează modul în care sunt gestionate argumentele de înregistrare și de tabel pentru Collect și ClearCollect.

Formulă	Descriere	Rezultat
ClearCollect( IceCream, { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } )	Ștergeți toate datele și apoi adăugați două înregistrări la colecția Înghețată care include o cantitate de înghețată de ciocolată și vanilie. Înregistrările care trebuie adăugate sunt furnizate ca argumente individuale ale funcției.	Colecția Înghețată a fost, de asemenea, modificată.
ClearCollect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } ) )	La fel ca și exemplul anterior, cu excepția faptului că înregistrările sunt combinate într-un tabel și trecute printr-un singur argument. Conținutul tabelului este extras înregistrare prin înregistrare înainte de a fi adăugat la colecția Înghețata.	Colecția Înghețată a fost, de asemenea, modificată.
ClearCollect( IceCream, { MyFavorites: Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } ) } )	La fel ca și exemplul anterior, cu excepția faptului că tabelul este încadrat într-o înregistrare. Înregistrările tabelului nu sunt extrase și în schimb întregul tabel este adăugat ca o celulă a înregistrării.	Colecția Înghețată a fost, de asemenea, modificată.