Apkopošanas, notīrīšanas un ClearCollect funkcijas

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

Apkopot

Attiecas uz: Audekla programmām Kartes Dataverse zema koda spraudņi Power Platform CLI darbvirsmas plūsmas

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ā.

Apkopot atgriež modificēto datu avotu kā tabulu. Apkopot var izmantot tikai uzvedības formulā.

Notīrīt

Attiecas uz: Audekla programmām

Izmantojot funkciju Clear, tiek izdzēsti visi kolekcijas ieraksti. Kolekcijas kolonnas paliks.

Ņemiet vērā, ka Notīrīt darbojas tikai kolekcijās, 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.

Funkcijai Notīrīt nav atgrieztās vērtības. To var izmantot tikai uzvedības formulā.

ClearCollect

Attiecas uz: Pamatnes programmām Modeļa vadītas programmas

Izmantojot funkciju ClearCollect, tiek izdzēsti visi kolekcijas ieraksti. Un pēc tam tai pašai kolekcijai pievieno citu ierakstu kopu. Izmantojot vienu funkciju, ClearCollect piedāvā kombināciju ar Clear un pēc tam ar 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

Apkopot( DataSource, Elements, ... )

• DataSource – Obligāti. Datu avots, kuram vēlaties pievienot datus. Ja datu avots vēl neeksistē, tiek izveidota jauna kolekcija.
• Elements(-i) – nepieciešams. Vienu vai vairākus ierakstus vai tabulas, ko pievienot datu avotam.

Notīrīt( Kolekcija )

• Kolekcija – Obligāti. Kolekcija, kuru vēlaties notīrīt.

ClearCollect( Kolekcija, Elements, ... )

• Kolekcija – Obligāti. Kolekciju, kuru vēlaties notīrīt, un pēc tam pievienot datus.
• Elements(-i) – nepieciešams. 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( IceCream, { Flavor: "Strawberry", Quantity: 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( IceCream, { Garša: "Pistachio", Daudzums: 40 }, { Garša: "Orange", 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.
Notīrīt( IceCream )	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

Šie piemēri pārbauda, kā tiek apstrādāti ierakstu un tabulu argumenti, izmantojot funkciju Apkopot un ClearCollect.

Formula	Apraksts	Rezultāts
ClearCollect( IceCream, { Garša: "Chocolate", Daudzums: 100 }, { Garša: "Vanilla", Daudzums: 200 } )	Notīra visus datus un pēc tam pievieno divus ierakstus kolekcijai Saldējums, 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: "Chocolate", Daudzums: 100 }, { Garša: "Vanilla", 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( IceCream, { 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.