Collect-, Clear- och ClearCollect-funktioner

Skapar och rensar samlingar och lägger till poster till alla datakällor.

Collect

Gäller: Arbetsyteappar Kort Dataverse plugin-program med lågkod Power Platform CLI

Collect-funktionen lägger till poster till en datakälla. Objekt som kan läggas till kan vara:

• Ett enstaka värde: värdet placeras i fältet Value i en ny post. Alla andra egenskaper lämnas blank.
• En post: varje namngiven egenskap placeras i motsvarande egenskap hos en ny post. Alla andra egenskaper lämnas blank.
• En tabell: varje post i tabellen läggs till som en separat post hos datakällan enligt beskrivningen ovan. Tabellen läggs inte till som en kapslad tabell i en post. För att åstadkomma detta omsluter du först tabellen i en post.

När den används tillsammans med en samling kan ytterligare kolumner skapas vid behov. Kolumnerna för andra datakällor är fixerade av datakällan och nya kolumner kan inte läggas till.

Om datakällan inte redan finns skapas en samling.

Samlingar används ibland för att spara globala variabler eller skapa en tillfällig kopia av en datakälla. Arbetsyteappar baseras på formler som automatiskt omberäknas när användaren interagerar med ett program. Samlingar har inte denna förmån och användningen av dem kan göra ditt program svårare att skapa och förstå. Innan du använder en samling i detta sätt kan du granska arbeta med variabler.

Du kan också använda funktionen Patch för att skapa poster i en datakälla.

Collect returnerar den modifierade datakällan som en tabell. Collect kan bara användas i en beteendeformel.

Clear

Gäller: Arbetsyteappar

Clear-funktionen tar bort alla poster i en samling. Samlingens kolumner finns kvar.

Observera att Clear endast fungerar på samlingar och inte andra datakällor. Du kan använda RemoveIf( DataSource, true ) för detta ändamål. Var försiktig eftersom detta tar bort alla poster från datakällans lagring och det kan påverka andra användare.

Du kan använda Remove-funktionen för att välja vilka poster som ska tas bort.

Clear har inget returvärde. Den kan bara användas i en beteendeformel.

ClearCollect

Gäller appar: Arbetsyteappar Modellbaserade program

ClearCollect-funktionen tar bort alla poster från en samling. En annan uppsättning poster läggs till i samma samling. Med en enda funktion erbjuder ClearCollect en kombination av Clear och därefter Collect.

ClearCollect returnerar den modifierade samlingen som en tabell. ClearCollect kan bara användas i en beteendeformel.

Delegering

Det går inte att delegera funktionerna när de används tillsammans med en datakälla. Endast den första delen av datakällan hämtas och sedan tillämpas funktionen. Resultatet kan inte representerar en fullständig överblick. En varning kan visas när du redigerar för att påminna dig om begränsningen och för att föreslå att du växlar till delegerbara alternativ när det är möjligt. Mer information finns i översikt över delegering.

Syntax

Collect( DataSource, Item, ... )

• DataSource – Krävs. Den datakälla som du vill lägga till data i. Om den inte redan finns, skapas en ny samling.
• Item(s) – obligatoriskt. En eller fler poster eller tabeller att lägga till datakällan.

Clear( Collection )

• Collection – Krävs. Den samling som du vill rensa.

ClearCollect( Collection, Item, ... )

• Collection – Krävs. Den samling som du vill rensa och därefter lägga till data i.
• Item(s) – obligatoriskt. En eller fler poster eller tabeller att lägga till datakällan.

Exempel

Rensa och lägga till poster till en datakälla

I de här exemplen kommer du att radera och lägga till i en samling som heter IceCream. Datakällan börjar med detta innehåll:

Formel	Beskrivning	Resultat
ClearCollect( IceCream , { Flavor: "Strawberry", Quantity: 300 } )	Tar bort alla data från IceCream-samlingen och lägger sedan till en post som inkluderar en kvantitet jordgubbsglass.	Samlingen IceCream har också ändrats.
Collect( IceCream , { Flavor: "Pistachio", Quantity: 40 }, { Flavor: "Orange", Quantity: 200 } )	Lägger till två poster till IceCream-samlingen som inkluderar en kvantitet pistaschmandel- och apelsinglass.	Samlingen IceCream har också ändrats.
Clear( IceCream )	Tar bort alla poster från IceCream-samlingen.	Samlingen IceCream har också ändrats.

Steg-för-steg-exempel på hur du skapar en samling finns i skapa och uppdatera en samling.

Poster och tabeller

Dessa exempel undersöker hur post- och tabellargument för hur Collect och ClearCollect hanteras.

Formel	Beskrivning	Resultat
ClearCollect( IceCream , { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } )	Rensar alla data och lägger sedan till två poster till IceCream-samlingen och lägger sedan till en kvantitet choklad- och vaniljglass. Posterna som ska läggas till visas som enskilda argument för funktionen.	Samlingen IceCream har också ändrats.
ClearCollect( IceCream , Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } ) )	Samma som i föregående exempel förutom att posterna kombineras i en tabell och skickas i ett enda argument. Innehållet i tabellen extraheras med en post innan den läggs till i samlingen för IceCream.	Samlingen IceCream har också ändrats.
ClearCollect( IceCream , { MyFavorites: Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } ) } )	Samma som i föregående exempel förutom att tabellen är omsluten i en post. Posterna i tabellen extraheras inte och i stället läggs hela tabellen till som en cell i posten.	Samlingen IceCream har också ändrats.