Creano e cancellano raccolte e aggiungono record a qualsiasi origine dati.

Descrizione

Collect

La funzione Collect aggiunge record a un'origine dati. Gli elementi da aggiungere possono essere:

  • Un valore singolo: il valore viene inserito nel campo Value di un nuovo record. Tutte le altre proprietà vengono lasciate blank.

  • Un record: ogni proprietà denominata viene inserita nella proprietà corrispondente di un nuovo record. Tutte le altre proprietà vengono lasciate blank.

  • Una tabella: ogni record della tabella viene aggiunto come record separato dell'origine dati, come descritto in precedenza. La tabella non viene aggiunta come tabella annidata in un record. A tale scopo, eseguire prima il wrapping della tabella in un record.

Quando si usa una raccolta, verranno create colonne aggiuntive, se necessario. Le colonne per le altre origini dati sono definite dall'origine dati e non è possibile aggiungere nuove colonne.

Se l'origine dati non esiste già, viene creata una raccolta.

Le raccolte vengono talvolta usate per contenere le variabili globali o creare una copia temporanea di un'origine dati. Le app PowerApps sono basate su formule che eseguono calcoli automatici durante l'interazione con un'app. Le raccolte non offrono questo vantaggio e la loro applicazione può rendere la creazione e l'uso dell'app più complessi. Prima di usare una raccolta in questo modo, vedere Working with variables (Uso delle variabili).

È anche possibile usare la funzione Patch per creare record in un'origine dati.

La funzione Collect restituisce l'origine dati modificata come tabella. Collect può essere usata solo in una formula comportamento.

Clear

La funzione Clear elimina tutti i record di una raccolta. Le colonne della raccolta verranno mantenuti.

Si noti che Clear opera solo su raccolte e non su altre origini dati. A questo scopo, è possibile usare RemoveIf( DataSource, true ). Prestare attenzione in quanto questa operazione rimuove tutti i record dall'archivio dell'origine dati e può influire sulle operazioni di altri utenti.

È possibile usare la funzione Remove per rimuovere i record in modo selettivo.

Clear non restituisce alcun valore. Può essere usata solo in una formula di comportamento.

ClearCollect

La funzione ClearCollect elimina tutti i record da una raccolta e quindi aggiunge un set di record diverso nella stessa raccolta. Con una singola funzione, ClearCollect offre la combinazione di Clear e Collect.

ClearCollect restituisce la raccolta modificata come tabella. ClearCollect può essere usata solo in una formula di comportamento.

Sintassi

Collect( OrigineDati, Elemento, ... )

  • OrigineDati: obbligatorio. L'origine dati a cui si vuole aggiungere dati. Se non esiste già, viene creata una nuova raccolta.
  • Elementi: obbligatorio. Uno o più record o tabelle da aggiungere all'origine dati.

Clear( Raccolta )

  • Raccolta: obbligatorio. La raccolta che si vuole cancellare.

ClearCollect( Raccolta, Elemento, ... )

  • Raccolta: obbligatorio. La raccolta che si vuole cancellare e a cui aggiungere dati.
  • Elementi: obbligatorio. Uno o più record o tabelle da aggiungere all'origine dati.

Esempi

Cancellazione e aggiunta di record a un'origine dati

In questi esempi, verrà eseguita la cancellazione e l'aggiunta di record a una raccolta denominata IceCream. L'origine dati di partenza ha il contenuto seguente:

Formula Descrizione Risultato
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).

L'origine dati IceCream è stata anche modificata.
Collect( IceCream, { Flavor: "Pistachio", Quantity: 40 }, { Flavor: "Orange", Quantity: 200 } ) Aggiunge due record alla raccolta IceCream che includono una quantità per il gelato (Ice cream) al pistacchio (pistachio) e all'arancia (Orange).

L'origine dati IceCream è stata anche modificata.
Clear( IceCream ) Rimuove tutti i record dalla raccolta IceCream.

L'origine dati IceCream è stata anche modificata.

Procedura dettagliata

  1. Aggiungere un pulsante e impostarne la proprietà OnSelect con questa funzione:
    Collect(Products, "Europa", "Ganymede", "Callisto")

    Questa funzione crea una raccolta denominata Products che contiene una riga per ogni nome di prodotto.

  2. Premere F5, fare clic sul pulsante e quindi premere ESC per tornare all'area di lavoro di progettazione.

  3. (Facoltativo) Per visualizzare un'anteprima della raccolta creata, fare clic su Raccolte nella scheda Contenuto.