Funcions Collect, Clear i ClearCollect

Crea i esborra col·leccions i afegeix registres a qualsevol font de dades.

Collect

S'aplica a: Aplicacions de llenç Targetes Dataverse connectors Power Platform de codi baix CLI Fluxos d'escriptori

La funció Collect afegeix registres a una font de dades. Els elements que s'afegiran poden ser:

• Un únic valor: el valor es col·loca en el camp Value d'un registre nou. La resta de propietats es deixen blank.
• Un registre: cada propietat amb nom es col·loca a la propietat corresponent d'un registre nou. La resta de propietats es deixen en blanc.
• Una taula: cada registre de la taula s'afegeix com a registre separat de la font de dades com s'ha descrit anteriorment. La taula no s'afegeix com a taula imbricada en un registre. Per fer-ho, primer heu d'inserir la taula en un registre.

Quan s'utilitza amb una col·lecció, es crearan columnes addicionals segons calgui. Les columnes d'altres fonts de dades estan fixades per la font de dades i les columnes noves no es poden afegir.

Si la font de dades encara no existeix, es crea una col·lecció.

Les col·leccions s'utilitzen de vegades per mantenir variables globals o per fer una còpia temporal d'una font de dades. Les aplicacions del llenç es basen en fórmules que es tornen a calcular automàticament a mesura que l'usuari interactua amb una aplicació. Les col·leccions de context no gaudeixen d'aquest benefici i utilitzar-les pot fer que l'aplicació sigui més difícil de crear i d'entendre. Abans d'utilitzar una col·lecció d'aquesta manera, reviseu com treballar amb variables.

També podeu utilitzar la funció Patch per crear registres en una font de dades.

Collect retorna la font de dades modificada com una taula. Collect només es pot utilitzar en una fórmula de comportament.

Esborra

S'aplica a: Aplicacions de llenç

La funció Clear suprimeix tots els registres d'una col·lecció. Les columnes de la col·lecció romandran.

Tingueu en compte que Clear només opera en col·leccions i no en altres fonts de dades. Podeu utilitzar RemoveIf( DataSource, true ) per a aquest propòsit. Utilitzeu-ho amb precaució, ja que se suprimiran tots els registres de l'emmagatzematge de la font de dades i poden afectar altres usuaris.

Podeu utilitzar la funció Remove per suprimir selectivament registres.

Clear no té valor de retorn. Només es pot utilitzar en una fórmula de comportament.

ClearCollect

S'aplica a: Aplicacions del llenç Aplicacions basades en models

La funció ClearCollect suprimeix tots els registres d'una col·lecció. I, a continuació, afegeix un conjunt de registres diferent a la mateixa col·lecció. Amb una única funció, ClearCollect ofereix la combinació de Clear i després Collect.

ClearCollect retorna la col·lecció modificada com una taula. ClearCollect només es pot utilitzar en una fórmula de comportament.

Delegació

Quan s'utilitza amb una font de dades, aquestes funcions no es poden delegar. Només es recuperarà la primera part de la font de dades i, a continuació, s'aplicarà la funció. És possible que el resultat no representi la història completa. És possible que aparegui un advertiment en el moment de la creació per recordar-vos aquesta limitació i suggerir-vos que canvieu a alternatives delegables sempre que sigui possible. Per obtenir més informació, vegeu la informació general sobre la delegació.

Sintaxi

Collect( DataSource, Item, ... )

• DataSource: obligatori. La font de dades a la que voleu afegir dades. Si encara no existeix, es crea una col·lecció nova.
• Item: obligatori. Un o més registres o taules per afegir a la font de dades.

Clear( Collection )

• Collection: obligatori. La col·lecció que voleu esborrar.

ClearCollect( Collection, Item, ... )

• Collection: obligatori. Recopilació que voleu esborrar i, a continuació, afegir-hi dades.
• Item: obligatori. Un o més registres o taules per afegir a la font de dades.

Exemples

Buidar i afegir registres a una font de dades

En aquests exemples, esborrareu i afegirem a una col·lecció que s'anomeni Gelat. El font de dades comença amb aquests continguts:

Fórmula	Descripció	Resultat
ClearCollect( Gelat, { Gust: "Maduixa", Quantitat: 300 } )	Suprimeix totes les dades de la col·lecció Gelat i després afegeix un registre que inclou una quantitat de gelat de maduixa.	També s'ha modificat la col·lecció Gelat.
Collect( Gelat, { Gust: "Festuc", Quantitat: 40 }, { Gust: "Taronja", Quantitat: 200 } )	Afegeix dos registres a la col·lecció Gelat que inclou una quantitat de gelat de festuc i de taronja.	També s'ha modificat la col·lecció Gelat.
Clear(Gelat)	Suprimeix tots els registres de la col·lecció Gelat.	També s'ha modificat la col·lecció Gelat.

Per obtenir exemples pas a pas sobre com crear una col·lecció, vegeu Crear i actualitzar una col·lecció.

Registres i taules

Aquests exemples examinen com es gestionen els arguments de registre i de taula per a Collect i ClearCollect.

Fórmula	Descripció	Resultat
ClearCollect( Gelat, { Gust: "Xocolata", Quantitat: 100 }, { Gust: "Vainilla", Quantitat: 200 } )	Suprimeix totes les dades i afegeix dos registres a la col·lecció Gelat que inclou una quantitat de gelat de xocolata i vainilla. Els registres que s'afegiran es proporcionen com a arguments individuals a la funció.	També s'ha modificat la col·lecció Gelat.
ClearCollect( Gelat, Table( { Gust:"Xocolata",Quantitat:100 }, { Gust:"Vainilla",Quantitat:200 } ) )	Igual que l'exemple anterior, tret que els registres es combinen en una taula i passen a través d'un únic argument. El contingut de la taula s'extreu registre per registre abans d'afegir-se a la col·lecció Gelat.	També s'ha modificat la col·lecció Gelat.
ClearCollect( Gelat, { MyFavorites: Table( { Gust: "Xocolata", Quantitat: 100 }, { Gust: "Vainilla", Quantitat: 200 } ) } )	Igual que l'exemple anterior, tret que la taula s'insereix en un registre. Els registres de la taula no s'extreuen i tota la taula s'afegeix com a cel·la del registre.	També s'ha modificat la col·lecció Gelat.