Funzioni Collect, Clear e ClearCollect in Power AppsCollect, Clear, and ClearCollect functions in Power Apps

Creano e cancellano raccolte e aggiungono record a qualsiasi origine dati.Creates and clears collections and adds records to any data source.

DescriptionDescription

CollectCollect

La funzione Collect aggiunge record a un'origine dati.The Collect function adds records to a data source. Gli elementi da aggiungere possono essere:The items to be added can be:

  • Un valore singolo: il valore viene inserito nel campo Value di un nuovo record.A single value: The value is placed in the Value field of a new record. Tutte le altre proprietà vengono lasciate blank.All other properties are left blank.
  • Un record: ogni proprietà denominata viene inserita nella proprietà corrispondente di un nuovo record.A record: Each named property is placed in the corresponding property of a new record. Tutte le altre proprietà vengono lasciate blank.All other properties are left blank.
  • Una tabella: ogni record della tabella viene aggiunto come record separato dell'origine dati, come descritto in precedenza.A table: Each record of the table is added as a separate record of the data source as described above. La tabella non viene aggiunta come tabella annidata in un record.The table is not added as a nested table to a record. A tale scopo, eseguire prima il wrapping della tabella in un record.To accomplish this, wrap the table in a record first.

Quando si usa una raccolta, verranno create colonne aggiuntive, se necessario.When used with a collection, additional columns will be created as needed. Le colonne per le altre origini dati sono definite dall'origine dati e non è possibile aggiungere nuove colonne.The columns for other data sources are fixed by the data source and new columns cannot be added.

Se l'origine dati non esiste già, viene creata una raccolta.If the data source doesn't already exist, a collection is created.

Le raccolte vengono talvolta usate per contenere le variabili globali o creare una copia temporanea di un'origine dati.Collections are sometimes used to hold global variables or make a temporary copy of a data source. Le app Power sono basate su formule che vengono ricalcolate automaticamente quando l'utente interagisce con un'app.Power Apps are based on formulas that automatically recalculate as the user interacts with an app. Le raccolte non offrono questo vantaggio e la loro applicazione può rendere la creazione e l'uso dell'app più complessi.Collections do not enjoy this benefit and their use can make your app harder to create and understand. Prima di usare una raccolta in questo modo, vedere Working with variables (Uso delle variabili).Before using a collection in this manner, review working with variables.

È anche possibile usare la funzione Patch per creare record in un'origine dati.You can also use the Patch function to create records in a data source.

La funzione Collect restituisce l'origine dati modificata come tabella.Collect returns the modified data source as a table. Collect può essere usata solo in una formula comportamento.Collect can only be used in a behavior formula.

ClearClear

La funzione Clear elimina tutti i record di una raccolta.The Clear function deletes all the records of a collection. Le colonne della raccolta verranno mantenuti.The columns of the collection will remain.

Si noti che Clear opera solo su raccolte e non su altre origini dati.Note that Clear only operates on collections and not other data sources. A questo scopo, è possibile usare RemoveIf( DataSource, true ) .You can use RemoveIf( DataSource, true ) for this purpose. Prestare attenzione in quanto questa operazione rimuove tutti i record dall'archivio dell'origine dati e può influire sulle operazioni di altri utenti.Use caution as this will remove all records from the data source's storage and can affect other users.

È possibile usare la funzione Remove per rimuovere i record in modo selettivo.You can use the Remove function to selectively remove records.

Clear non restituisce alcun valore.Clear has no return value. Può essere usata solo in una formula di comportamento.It can only be used in a behavior formula.

ClearCollectClearCollect

La funzione ClearCollect elimina tutti i record da una raccolta e quindi aggiunge un set di record diverso nella stessa raccolta.The ClearCollect function deletes all the records from a collection and then adds a different set of records to the same collection. Con una singola funzione, ClearCollect offre la combinazione di Clear e Collect.With a single function, ClearCollect offers the combination of Clear and then Collect.

ClearCollect restituisce la raccolta modificata come tabella.ClearCollect returns the modified collection as a table. ClearCollect può essere usata solo in una formula di comportamento.ClearCollect can only be used in a behavior formula.

SintassiSyntax

Collect( OrigineDati, Elemento, ... )Collect( DataSource, Item, ... )

  • DataSource: obbligatorio.DataSource – Required. L'origine dati a cui si vuole aggiungere dati.The data source that you want to add data to. Se non esiste già, viene creata una nuova raccolta.If it does not already exist, a new collection is created.
  • Elementi: obbligatorio.Item(s) - Required. Uno o più record o tabelle da aggiungere all'origine dati.One or more records or tables to add to the data source.

Clear( Raccolta )Clear( Collection )

  • Raccolta: obbligatorio.Collection – Required. La raccolta che si vuole cancellare.The collection that you want to clear.

ClearCollect( Raccolta, Elemento, ... )ClearCollect( Collection, Item, ... )

  • Raccolta: obbligatorio.Collection – Required. La raccolta che si vuole cancellare e a cui aggiungere dati.The collection that you want to clear and then add data to.
  • Elementi: obbligatorio.Item(s) - Required. Uno o più record o tabelle da aggiungere all'origine dati.One or more records or tables to add to the data source.

EsempiExamples

Cancellazione e aggiunta di record a un'origine datiClearing and adding records to a data source

In questi esempi, verrà eseguita la cancellazione e l'aggiunta di record a una raccolta denominata IceCream.In these examples, you'll erase and add to a collection that's named IceCream. L'origine dati di partenza ha il contenuto seguente:The data source begins with these contents:

Origine dati di esempio

FormulaFormula DescriptionDescription RisultatoResult
ClearCollect( IceCream, { Flavor: "Strawberry", Quantity: 300 } )ClearCollect( IceCream, { Flavor: "Strawberry", Quantity: 300 } ) Cancella tutti i dati della raccolta IceCream e quindi aggiunge un record che include una quantità per il gelato (Ice cream) alla fragola (Strawberry).Clears all data from the IceCream collection and then adds a record that includes a quantity of strawberry ice cream. tabella con un record Table with one record

Anche la raccolta di gelato è stata modificata.The IceCream collection has also been modified.
Collect( IceCream, { Flavor: "Pistachio", Quantity: 40 }, { Flavor: "Orange", Quantity: 200 } )Collect( IceCream, { Flavor: "Pistachio", Quantity: 40 }, { Flavor: "Orange", Quantity: 200 } ) Aggiunge due record alla raccolta di gelati che include una quantità di ghiaccio pistacchio e un gelato arancione.Adds two records to the IceCream collection that includes a quantity of pistachio and orange ice cream. tabella con due recordTable with two records

Anche la raccolta di gelato è stata modificata.The IceCream collection has also been modified.
Clear( IceCream )Clear( IceCream ) Rimuove tutti i record dalla raccolta IceCream.Removes all records from the IceCream collection. tabella vuotaEmpty table

Anche la raccolta di gelato è stata modificata.The IceCream collection has also been modified.

Per esempi dettagliati su come creare una raccolta, vedere creare e aggiornare una raccolta.For step-by-step examples of how to create a collection, see Create and update a collection.

Record e tabelleRecords and tables

In questi esempi viene esaminato il modo in cui vengono gestiti gli argomenti di record e tabella da raccogliere e ClearCollect .These examples examine how record and table arguments to Collect and ClearCollect are handled.

FormulaFormula DescriptionDescription RisultatoResult
ClearCollect (gelato, { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 })ClearCollect( IceCream, { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } ) Cancellare tutti i dati e aggiungere due record alla raccolta di gelati che include una quantità di cioccolato e gelato vaniglia.Clear all data and then adds two records to the IceCream collection that includes a quantity of chocolate and vanilla ice cream. I record da aggiungere vengono forniti come singoli argomenti alla funzione.The records to be added are provided as individual arguments to the function. i record Chocolate e Vanilla aggiunti alla raccoltaChocolate and Vanilla records added to collection

Anche la raccolta di gelato è stata modificata.The IceCream collection has also been modified.
ClearCollect (gelato, tabella ({ Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 })ClearCollect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } ) ) Uguale all'esempio precedente, ad eccezione del fatto che i record vengono combinati in una tabella e passati tramite un singolo argomento.Same as the previous example except that the records are combined in a table and passed in through a single argument. Il contenuto della tabella viene estratto dal record prima di essere aggiunto alla raccolta di gelato .The contents of the table are extracted record by record before being added to the IceCream collection. i record Chocolate e Vanilla aggiunti alla raccoltaChocolate and Vanilla records added to collection

Anche la raccolta di gelato è stata modificata.The IceCream collection has also been modified.
ClearCollect (gelato,
{ preferiti: tabella ({ Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 })})
ClearCollect( IceCream,
{ MyFavorites: Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } ) } )
Uguale all'esempio precedente, ad eccezione del fatto che la tabella è racchiusa in un record.Same as the previous example except that the table is wrapped in a record. I record della tabella non vengono estratti ed è invece possibile aggiungere l'intera tabella come tabella secondaria del record.The records of the table are not extracted and instead the entire table is added as a sub-table of the record. i record Chocolate e Vanilla aggiunti alla raccoltaChocolate and Vanilla records added to collection

Anche la raccolta di gelato è stata modificata.The IceCream collection has also been modified.