Collect, Clearun ClearCollect funkcijas

Funkcija	Attiecas uz
Clear	Audekla programmas Darbvirsmas plūsmas Power Platform CLI Dataverse funkcijas
ClearCollect	Audekla programmas Darbvirsmas plūsmas Power Platform CLI
Collect	Audekla programmas Darbvirsmas plūsmas Modeļa vadītas programmas Power Platform CLI Dataverse funkcijas

Izveido un notīra kolekcijas un pievieno ierakstus jebkuram datu avotam.

Collect

Funkcija Collect pievieno ierakstus datu avotam. Pievienojamie elementi var būt:

• Viena vērtība: vērtība tiek ievietota jaunā ieraksta Value laukā. Visi pārējie rekvizīti tiek atstāti blank.
• Ieraksts: Katrs nosauktais rekvizīts tiek ievietots jaunā ieraksta atbilstošajā rekvizītā. Visi pārējie rekvizīti tiek atstāti tukši.
• Tabula : katrs tabulas ieraksts tiek pievienots kā atsevišķs datu avota ieraksts, kā aprakstīts iepriekš. Tabula netiek pievienota ierakstam kā ligzdota tabula. Lai to paveiktu, vispirms ietiniet šo tabulu ierakstā.

Izmantojot kopā ar kolekciju, pēc nepieciešamības tiks izveidotas papildu kolonnas. Datu avots fiksē citas datu avota kolonnas un jaunas kolonnas nevar pievienot.

Ja datu avots vēl neeksistē, tiek izveidota kolekcija.

Kolekcijas dažreiz tiek lietotas, lai ietvertu globālos mainīgos vai izveidotu datu avota pagaidu kopiju. Pamatnes programmas balstās uz formulām, kas tiek automātiski pārrēķinātas, lietotājam mijiedarbojoties ar programmu. Uz kolekcijām neattiecas šī priekšrocība, un to lietojums var apgrūtināt jūsu programmas izveidi un izpratni. Pirms izmantojat kolekciju šādā veidā, pārskatiet darbu ar mainīgajiem.

Varat arī izmantot Patch funkciju, lai izveidotu ierakstus datu avotā.

Collect Atgriež modificēto datu avotu kā tabulu. Collect Var izmantot tikai uzvedības formulā.

Clear

Funkcija Clear izdzēš visus kolekcijas ierakstus. Kolekcijas kolonnas paliks.

Ņemiet vērā, ka tas darbojas tikai kolekcijās, Clear nevis citos datu avotos. Šim nolūkam var izmantot RemoveIf( Datu avots, patiess). Esiet piesardzīgs, jo šādi tiks noņemti visi datu avota krātuves ieraksti, un tie var ietekmēt citus lietotājus.

Varat izmantot funkciju Remove, lai izlases veidā noņemtu ierakstus.

Clear nav atgrieztās vērtības. To var izmantot tikai uzvedības formulā.

ClearCollect

Šī ClearCollect funkcija izdzēš visus ierakstus no kolekcijas. Un pēc tam tai pašai kolekcijai pievieno citu ierakstu kopu. Ar vienu funkciju ClearCollect piedāvā kombināciju Clear un pēc tam Collect.

ClearCollect Atgriež modificēto kolekciju kā tabulu. ClearCollect Var izmantot tikai uzvedības formulā.

Deleģēšana

Ja tiek izmantots arī datu avots, šīs funkcijas nevar deleģēt. Tiks izgūta tikai pirmā datu avota daļa, un pēc tam tiks izmantota funkcija. Rezultātā var nebūt iekļauts viss saturs. Lai atgādinātu par šo ierobežojumu un ieteiktu pārslēgties uz deleģējamu alternatīvu (ja tas ir iespējams), autorēšanas laikā var tikt parādīts brīdinājums. Papildinformāciju skatiet sadaļā Pārskats par deleģēšanu.

Sintakse

Collect( Datu avots, vienums, ... )

• DataSource - Obligāts. Datu avots, kuram vēlaties pievienot datus. Ja datu avots vēl neeksistē, tiek izveidota jauna kolekcija.
• Preces - Obligāts. Vienu vai vairākus ierakstus vai tabulas, ko pievienot datu avotam.

Clear( Kolekcija )

• Kolekcija - Obligāts. Kolekcija, kuru vēlaties notīrīt.

ClearCollect( Kolekcija, priekšmets, ... )

• Kolekcija - Obligāts. Kolekciju, kuru vēlaties notīrīt, un pēc tam pievienot datus.
• Preces - Obligāts. Vienu vai vairākus ierakstus vai tabulas, ko pievienot datu avotam.

Piemēri

Ierakstu notīrīšana un pievienošana datu avotam

Šajos piemēros Jūs izdzēsīsit un pievienosit datus kolekcijai, kuras nosaukums ir IceCream. Datu avots sākas ar šo saturu:

Formula	Apraksts	Rezultāts
ClearCollect( Saldējums, { Garša: "Zemeņu", Daudzums: 300 } )	Notīra visus datus no kolekcijas Saldējums un pēc tam pievieno ierakstu, kurā ir iekļauts zemeņu saldējuma daudzums.	Kolekcija Saldējums arī tika modificēta.
Collect( Saldējums, { Garša: "Pistācijas", Daudzums: 40 }, { Garša: "Apelsīns", Daudzums: 200 } )	Pievieno divus ierakstus kolekcijai IceCream, kurā ir iekļauts pistāciju un apelsīnu saldējuma daudzums.	Kolekcija Saldējums arī tika modificēta.
Clear( Saldējums )	Noņem visus ierakstus no kolekcijas Saldējums.	Kolekcija Saldējums arī tika modificēta.

Detalizētus piemērus par to, kā izveidot kolekciju, skatiet tēmā Kolekcijas izveide un atjaunināšana.

Ieraksti un tabulas

Šajos piemēros tiek pārbaudīts, kā tiek apstrādāti ierakstu un tabulas argumenti CollectClearCollect .

Formula	Apraksts	Rezultāts
ClearCollect( Saldējums, { Garša: "Šokolāde", Daudzums: 100 }, { Garša: "Vaniļa", Daudzums: 200 } )	Clear visus datus un pēc tam pievieno divus ierakstus IceCream kolekcijai, kas ietver šokolādes un vaniļas saldējuma daudzumu. Pievienojamie ieraksti tiek sniegti kā atsevišķas funkcijas argumenti.	Kolekcija Saldējums arī tika modificēta.
ClearCollect( IceCream, Table( { Garša: "Šokolāde", Daudzums: 100 }, { Garša: "Vaniļa", Daudzums: 200 } ) )	Tāpat kā Iepriekšējā piemērā, izņemot to, ka ieraksti tiek apvienoti tabulā un nodoti, izmantojot atsevišķu argumentu. Šīs tabulas satura izvilkšana notiek ierakstu pa ierakstam, pirms pievienošanas Saldējuma kolekcijai.	Kolekcija Saldējums arī tika modificēta.
ClearCollect( Saldējums, { MyFavorites: Table( { Garša: "Chocolate", Daudzums: 100 }, { Garša: "Vanilla", Daudzums: 200 } ) } )	Tāpat kā iepriekšējā piemērā, izņemot to, ka tabulā ir ietīts ieraksts. Tabulas ieraksti netiek izvilkti, un tā vietā tiek pievienota visa tabula kā ieraksta šūna.	Kolekcija Saldējums arī tika modificēta.