Funzioni Remove e RemoveIf in Power AppsRemove and RemoveIf functions in Power Apps

• 04/02/2020
• 6 minuti per la lettura

Rimuove i record da un'origine dati.Removes records from a data source.

DescrizioneDescription

Funzione RemoveRemove function

Usare la funzione Remove per rimuovere uno o più record specifici da un'origine dati.Use the Remove function to remove a specific record or records from a data source.

Per le raccolte deve corrispondere l'intero record.For collections, the entire record must match. È possibile usare l'argomento All per rimuovere tutte le copie di un record; in caso contrario verrà rimossa solo una copia del record.You can use the All argument to remove all copies of a record; otherwise, only one copy of the record is removed.

Funzione RemoveIfRemoveIf function

Usare la funzione RemoveIf per rimuovere uno o più record in base a una condizione o un set di condizioni.Use the RemoveIf function to remove a record or records based on a condition or a set of conditions. Ogni condizione può essere qualsiasi formula che restituisce un valore true o false e può fare riferimento a colonne dell'origine dati in base al nome.Each condition can be any formula that results in a true or false and can reference columns of the data source by name. Ogni condizione viene valutata singolarmente per ogni record e il record viene rimosso se tutte le condizioni restituiscono true.Each condition is evaluated individually for each record, and the record is removed if all conditions evaluate to true.

Remove e RemoveIf restituiscono l'origine dati modificata come tabella.Remove and RemoveIf return the modified data source as a table. È possibile usare entrambe le funzioni solo in una formula di comportamento.You can use both functions only in behavior formulas.

È anche possibile usare la funzione Clear per rimuovere tutti i record presenti in un'origine dati.You can also use the Clear function to remove all of the records in a data source.

DelegaDelegation

Quando viene utilizzata con un'origine dati, queste funzioni non possono essere delegate.When used with a data source, these functions can't be delegated. Solo la prima parte dell'origine dati verrà recuperata e la funzione applicata.Only the first portion of the data source will be retrieved and then the function applied. Il risultato potrebbe non rappresentare la storia completa.The result may not represent the complete story. Un avviso potrebbe apparire al momento della creazione per ricordarti questo limite e per suggerire di passare ad alternative delegabili quando possibile.A warning may appear at authoring time to remind you of this limitation and to suggest switching to delegable alternatives where possible. Per ulteriori informazioni, consultare panoramica delega.For more information, see the delegation overview.

SintassiSyntax

Remove( DataSource; Record1 [; Record2; ... ] [; All ] )Remove( DataSource; Record1 [; Record2; ... ] [; All ] )

• DataSource: obbligatorio.DataSource – Required. L'origine dati che contiene i record da rimuovere.The data source that contains the record or records that you want to remove.
• Record: obbligatorio.Record(s) – Required. I record da rimuovere.The record or records to remove.
• All: facoltativo.All – Optional. In una raccolta, lo stesso record può essere presente più volte.In a collection, the same record may appear more than once. È possibile aggiungere l'argomento All per rimuovere tutte le copie del record.You can add the All argument to remove all copies of the record.

Remove( DataSource; Table [; All ] )Remove( DataSource; Table [; All ] )

• DataSource: obbligatorio.DataSource – Required. L'origine dati che contiene i record da rimuovere.The data source that contains the records that you want to remove.
• Table: obbligatorio.Table – Required. Tabella di record da rimuovere.A table of records to remove.
• All: facoltativo.All – Optional. In una raccolta, lo stesso record può essere presente più volte.In a collection, the same record may appear more than once. È possibile aggiungere l'argomento All per rimuovere tutte le copie del record.You can add the All argument to remove all copies of the record.

RemoveIf( DataSource; Condition [; ... ] )RemoveIf( DataSource; Condition [; ... ] )

• DataSource: obbligatorio.DataSource – Required. L'origine dati che contiene i record da rimuovere.The data source that contains the record or records that you want to remove.
• Condition: obbligatorio.Condition(s) – Required. Formula che restituisce true per i record da rimuovere.A formula that evaluates to true for the record or records to remove. È possibile usare i nomi di colonna di DataSource nella formula.You can use column names from the DataSource in the formula. Se si specificano più condizioni, devono tutte restituire true per i record da rimuovere.If you specify multiple Conditions, all must evaluate to true for the record or records to be removed.

Esempi-formule singoleExamples - single formulas

In questi esempi verranno rimossi record in un'origine dati denominata IceCream che inizia con i dati della tabella seguente:In these examples, you'll remove a record or records in a data source that's named IceCream and that starts with the data in this table:

Creare una raccolta con record di esempioCreate a collection with sample records

Per creare una raccolta con questi dati:To create a collection with this data:

1. Inserire un controllo Button .Insert a Button control.

2. Impostare la proprietà onselect del controllo Button sulla formula seguente:Set button control's OnSelect property to the below formula:

   ClearCollect( IceCream;
                 { ID: 1; Flavor: "Chocolate";  Quantity: 100 };
                 { ID: 2; Flavor: "Vanilla";    Quantity: 200 };
                 { ID: 3; Flavor: "Strawberry"; Quantity: 300 }
   )
   

3. Selezionare il pulsante tenendo premuto il tasto Alt:Select the button while holding down the Alt key:

Rimuovere i record di esempio dalla raccolta usando una formulaRemove sample records from collection using a formula

FormulaFormula	DescrizioneDescription	RisultatoResult
Remove( IceCream; First( Filter( IceCream; Flavor="Chocolate" ) ) )Remove( IceCream; First( Filter( IceCream; Flavor="Chocolate" ) ) )	Rimuove il record Chocolate dall'origine dati.Removes the Chocolate record from the data source.	L'origine dati IceCream è stata modificata.The IceCream data source has been modified.
Remove( IceCream; First( Filter( IceCream; Flavor="Chocolate" ) ) First( Filter( IceCream; Flavor="Strawberry" ) ) )Remove( IceCream; First( Filter( IceCream; Flavor="Chocolate" ) ) First( Filter( IceCream; Flavor="Strawberry" ) ) )	Rimuove due record dall'origine dati.Removes two records from the data source.	L'origine dati IceCream è stata modificata.The IceCream data source has been modified.
RemoveIf( IceCream; Quantity > 150 )RemoveIf( IceCream; Quantity > 150 )	Rimuove i record che hanno un valore Quantity maggiore di 150.Removes records that have a Quantity that's greater than 150.	L'origine dati IceCream è stata modificata.The IceCream data source has been modified.
RemoveIf( IceCream; Quantity > 150; Left( Flavor; 1 ) = "S" )RemoveIf( IceCream; Quantity > 150; Left( Flavor; 1 ) = "S" )	Rimuove i record che hanno un valore Quantity maggiore di 150 e un valore Flavor che inizia con S.Removes records that have a Quantity that's greater than 150 and Flavor starts with an S.	L'origine dati IceCream è stata modificata.The IceCream data source has been modified.
RemoveIf( IceCream; true )RemoveIf( IceCream; true )	Rimuove tutti i record dall'origine dati.Removes all records from the data source.	L'origine dati IceCream è stata modificata.The IceCream data source has been modified.

Esempi-pulsante Rimuovi all'esterno di una raccoltaExamples - remove button outside a gallery

In questo esempio si utilizzerà un controllo raccolta per elencare i record in una tabella.In this example, you'll use a Gallery control to list the records in a table. Quindi, usare la funzione Remove per rimuovere selettivamente un elemento.And then use the Remove function to selectively remove an item.

Preparare i dati di esempioPrepare for sample data

Questo esempio usa l'entità Contacts in Common Data Service disponibile con le app e i dati di esempio.This example uses the Contacts entity in Common Data Service available with the sample apps and data. È possibile distribuire le app e i dati di esempio quando si Crea un ambiente.You can deploy sample apps and data when you create an environment. È anche possibile usare qualsiasi altra origine dati.You can also use any other data source instead.

Pulsante Rimuovi all'esterno di una raccoltaRemove button outside a gallery

In questo esempio verrà rimosso un elemento usando un pulsante esterno alla raccolta.In this example, you'll remove an item by using a button that is outside the gallery.

1. Creare una nuova app Canvas vuota usando un layout telefonico.Create a new blank canvas app using a Phone layout.

   

2. Selezionare l' inserimento dal riquadro sinistro.Select the Insert from the left pane.

3. Selezionare raccolta verticale.Select Vertical gallery.
   Viene aggiunto un controllo raccolta allo schermo.A Gallery control is be added to your screen.

   

4. Viene richiesto di selezionare un'origine dati in cui è possibile selezionare un'origine dati dalle origini dati disponibili.You're prompted to select a data source where you can select a data source from the available data sources.
   Ad esempio, selezionare l'entità Contacts per usare i dati di esempio:For example, select the Contacts entity to use sample data:

   

   La raccolta Mostra gli elementi di questa entità:The gallery shows items from this entity:

   

5. Inserire un controllo Button dal riquadro sinistro:Insert a Button control from left pane:

   

6. Spostare il pulsante aggiunto sotto gli elementi della raccolta:Move the added button below the gallery items:

   

7. Aggiornare la proprietà testo del pulsante per rimuovere il record.Update button text property to Remove record. È anche possibile usare un testo di propria scelta:You can also use text of your choice:

   

8. Impostare la proprietà onselect per questo controllo Button sulla formula seguente:Set the OnSelect property for this button control to the following formula:

   Remove( Contacts; Gallery1.Selected )
   

   

   Il controllo raccolta rende disponibile il record attualmente selezionato utilizzando la proprietà selezionata .The gallery control makes the currently selected record available using Selected property. Remove Function fa riferimento a questo record selezionato per rimuoverlo.Remove function refers to this selected record to remove it.

9. Visualizzare in anteprima l'app usando il pulsante Riproduci in alto a destra oppure premere F5 sulla tastiera:Preview the app using the Play button on the top right, or press F5 on keyboard:

   

10. Selezionare un record da rimuovere, ad esempio il record di Nancyin questo esempio:Select a record to remove, such as Nancy's record in this example:

    

11. Selezionare Rimuovi record:Select Remove record:

    

    Selezionando il pulsante verrà rimosso il record selezionato (in questo esempio, il record di Nancy).Selecting the button removes the selected record (in this example, Nancy's record).

12. Chiudere l'anteprima dell'app.Close the app preview.

    Suggerimento

    È anche possibile usare il comportamento alternativo con il tasto Alt invece di usare l'anteprima dell'app con il pulsante Play o F5.You can also use alternate behavior with Alt key instead of using the app preview with Play button or F5.

Esempi-icona del cestino all'interno di una raccoltaExamples - trash can icon inside a gallery

In questo esempio verrà rimosso un elemento usando un' icona posizionata all'interno della raccolta.In this example, you'll remove an item by using an icon placed inside the gallery.

Creare una raccolta con dati di esempioCreate a collection with sample data

Se sono già stati preparati dati di esempio, ignorare questo passaggio e passare a Cestino icona all'interno di una raccolta.If you already have prepared sample data, skip this step and move to Trash can icon inside a gallery.

1. Aggiungere un controllo Button allo schermo.Add a Button control to your screen.

2. Impostare la proprietà OnSelect sulla formula seguente:Set the OnSelect property to the following formula:

   ClearCollect( SampleContacts; 
         { 'Full Name': "Yvonne McKay (sample)";      'Primary Email': "someone_a@example.com" };
         { 'Full Name': "Susanna Stubberod (sample)"; 'Primary Email': "someone_b@example.com" };
         { 'Full Name': "Nancy Anderson (sample)";    'Primary Email': "someone_c@example.com" };
         { 'Full Name': "Maria Campbell (sample)";    'Primary Email': "someone_d@example.com" };
         { 'Full Name': "Robert Lyon (sample)";       'Primary Email': "someone_e@example.com" };
         { 'Full Name': "Paul Cannon (sample)";       'Primary Email': "someone_f@example.com" };
         { 'Full Name': "Rene Valdes (sample)";       'Primary Email': "someone_g@example.com" } 
   )
   

3. Selezionare il pulsante tenendo premuto il tasto Alt.Select the button while holding down the Alt key.

Viene creata una raccolta di esempi che è possibile usare nell'esempio seguente.Sample collection is created that you can use in the following example.

Icona del cestino all'interno di una raccoltaTrash can icon inside a gallery

1. Creare una nuova app Canvas vuota usando un layout telefonico.Create a new blank canvas app using a Phone layout.

   

2. Selezionare l' inserimento dal riquadro sinistro.Select the Insert from the left pane.

3. Selezionare raccolta verticale.Select Vertical gallery.
   Viene aggiunto un controllo raccolta allo schermo.A Gallery control is be added to your screen.

   

4. Viene richiesto di selezionare un'origine dati in cui è possibile selezionare un'origine dati dalle origini dati disponibili.You're prompted to select a data source where you can select a data source from the available data sources.
   Ad esempio, selezionare l'entità Contacts per usare i dati di esempio:For example, select the Contacts entity to use sample data:

   

   Se è stata creata una raccolta, selezionare invece la raccolta:If you created a collection, select your collection instead:

   

5. Selezionare un controllo all'interno dell'elemento superiore della raccolta.Select a control within the top item in the gallery.
   

   Per assicurarsi che il passaggio successivo inserisca l'elemento nel modello della raccolta e non all'esterno della raccolta, assicurarsi di seguire questo passaggio prima di passare al passaggio successivo.To ensure next step inserts item into gallery's template and not outside the gallery, ensure you follow this step before moving to the next step.

   

6. Selezionare Aggiungi icona dal riquadro sinistro.Select Add icon from left pane.
   

   

   Nota

   Aggiungi icona inserisce un'icona + sul lato sinistro della raccolta, replicata per ogni elemento nella raccolta.Add icon inserts a + icon on the left side of the gallery, replicated for each item in the gallery.

7. Nell'elemento superiore spostare l'icona sul lato destro dello schermo.In the top item, move the icon to the right side of the screen.

   

8. Selezionare la proprietà icona per icona e impostarla sulla formula seguente per aggiornare l'immagine icona come icona Cestino:Select the Icon property for icon and set it to the following formula to update the icon image as trash icon:

   Icon.Trash
   

   Nota

   Icona.The Icon. il prefisso viene visualizzato solo quando si sta modificando attivamente la formula.prefix is only shown when you're actively editing the formula.

   

9. Impostare la proprietà OnSelect sulla formula seguente:Set the OnSelect property to the following formula:

   Remove( [@Contacts]; ThisItem )
   

   Nota

   È necessario utilizzare l'operatore di risoluzione dell' ambiguità globale [@ ... ] in questo esempio con dati di esempio che usano l'entità Contacts per evitare conflitti con una relazione uno-a-molti .You must use global disambiguation operator [@...] in this example with sample data that uses the Contacts entity to avoid conflict with a One-to-Many relationship. Se si utilizzano origini dati quali un elenco di SharePoint o una tabella SQL Server, non è necessario utilizzare l' operatore disambgulation globale .If you use data sources such as a SharePoint list or a SQL Server table, using global disambgulation operator is not required.

   

10. Visualizzare in anteprima l'app usando il pulsante Riproduci in alto a destra oppure premere F5 sulla tastiera.Preview the app using the Play button on the top right, or press F5 on keyboard.

11. Selezionare l'icona del cestino accanto a un record, ad esempio Maria:Select the trash icon next to a record, for example Maria's:

    

    Il record viene eliminato:The record is deleted:

    

12. Chiudere l'anteprima dell'app.Close the app preview.