Funzioni AddColumns, DropColumns, RenameColumns e ShowColumns in PowerAppsAddColumns, DropColumns, RenameColumns, and ShowColumns functions in PowerApps

Trasformano una tabella aggiungendo, rimuovendo, rinominando e selezionando le colonne.Shapes a table by adding, dropping, renaming, and selecting its columns.

PanoramicaOverview

Queste funzioni trasformano una tabella modificando le relative colonne:These functions shape a table by adjusting its columns:

  • Ridurre una tabella che contiene più colonne a una colonna singola per l'uso con funzioni di colonna singola, ad esempio Lower o Abs.Reduce a table that contains multiple columns down to a single column for use with single-column functions, such as Lower or Abs.
  • Aggiungere una colonna calcolata a una tabella, ad esempio, una colonna Total Price che visualizza il risultato della moltiplicazione di Quantity per Unit Price.Add a calculated column to a table (for example, a Total Price column that shows the results of multiplying Quantity by Unit Price).
  • Rinominare una colonna con nomi più significativi, per la visualizzazione agli utenti o da usare nelle formule.Rename a column to something more meaningful, for display to users or for use in formulas.

Una tabella è un valore in PowerApps, così come una stringa o un numero.A table is a value in PowerApps, just like a string or a number. È possibile specificare una tabella come argomento in una formula e le funzioni possono restituire una tabella come risultato.You can specify a table as an argument in a formula, and functions can return a table as a result. Le funzioni illustrate in questo argomento non modificano una tabella.The functions that this topic describes don't modify a table. Al contrario, usano una tabella come argomento e restituiscono una nuova tabella con la trasformazione applicata.Instead they take a table as an argument and return a new table with a transform applied. Per altre informazioni, vedere Working with tables (Utilizzo delle tabelle).See working with tables for more details.

Non è possibile modificare le colonne di un'origine dati tramite queste funzioni.You can't modify the columns of a data source by using these functions. È necessario modificare i dati all'origine.You must modify the data at its source. È possibile aggiungere colonne a una raccolta con la funzione Collect.You can add columns to a collection with the Collect function. Per informazioni dettagliate, vedere Working with data sources (Uso delle origini dati).See working with data sources for more details.

DescrizioneDescription

La funzione AddColumns aggiunge una colonna a una tabella e una formula definisce i valori della colonna.The AddColumns function adds a column to a table, and a formula defines the values in that column. Le colonne esistenti rimangano invariate.Existing columns remain unmodified.

La formula viene valutata per ogni record della tabella.The formula is evaluated for each record of the table.

Fields of the record currently being processed are available within the formula. You simply reference them by name as you would any other value. You can also reference control properties and other values from throughout your app. For more details, see the examples below and working with record scope.

La funzione DropColumns esclude colonne da una tabella.The DropColumns function excludes columns from a table. Le altre colonne rimangano invariate.All other columns remain unmodified. La funzione DropColumns esclude colonne e la funzione ShowColumns include colonne.DropColumns excludes columns, and ShowColumns includes columns.

La funzione RenameColumns rinomina le colonne di una tabella.The RenameColumns function renames columns of a table. Tutte le altre colonne conservano i nomi originali.All other columns retain their original names.

La funzione ShowColumns include colonne di una tabella ed esclude tutte le altre.The ShowColumns function includes columns of a table and drops all other columns. È possibile usare ShowColumns per creare una tabella a colonna singola da una tabella a più colonne.You can use ShowColumns to create a single-column table from a multi-column table. ShowColumns include colonne e DropColumns le esclude.ShowColumns includes columns, and DropColumns excludes columns.

Per tutte queste funzioni, il risultato è una nuova tabella con la trasformazione applicata.For all these functions, the result is a new table with the transform applied. La tabella originale non viene modificata.The original table isn't modified.

When used with a data source, these functions can't be delegated. Only the first portion of the data source will be retrieved and then the function applied. The result may not represent the complete story. A blue dot will appear at authoring time to remind you of this limitation and to suggest switching to delegable alternatives where possible. For more information, see the delegation overview.

SintassiSyntax

AddColumns( Tabella, NomeColonna1, Formula1 [, NomeColonna2, Formula2, ... ] )AddColumns( Table, ColumnName1, Formula1 [, ColumnName2, Formula2, ... ] )

  • Table - Obbligatorio.Table - Required. Tabella su cui eseguire le operazioni.Table to operate on.
  • ColumnName(s) - Obbligatorio.ColumnName(s) - Required. Nomi delle colonne da aggiungere.Name(s) of the column(s) to add. Per questo argomento è necessario specificare una stringa, ad esempio "Name" tra virgolette doppie.You must specify a string (for example, "Name" with double quotes included) for this argument.
  • Formula: obbligatorio.Formula(s) - Required. Formula da valutare per ogni record della tabella.Formula(s) to evaluate for each record. Il risultato viene aggiunto come valore della nuova colonna corrispondente.The result is added as the value of the corresponding new column. È possibile fare riferimento ad altre colonne della tabella in questa formula.You can reference other columns of the table in this formula.

DropColumns( Tabella, NomeColonna1 [, NomeColonna2, ... ] )DropColumns( Table, ColumnName1 [, ColumnName2, ... ] )

  • Table - Obbligatorio.Table - Required. Tabella su cui eseguire le operazioni.Table to operate on.
  • ColumnName(s) - Obbligatorio.ColumnName(s) - Required. Nomi delle colonne da rimuovere.Name(s) of the column(s) to drop. Per questo argomento è necessario specificare una stringa, ad esempio "Name" tra virgolette doppie.You must specify a string (for example, "Name" with double quotes included) for this argument.

RenameColumns( Tabella, NomeColonnaPrecedente, NomeColonnaNuova )RenameColumns( Table, OldColumneName, NewColumnName )

  • Table - Obbligatorio.Table - Required. Tabella su cui eseguire le operazioni.Table to operate on.
  • NomeColonnaPrecedente: obbligatorio.OldColumnName - Required. Nome della colonna da rinominare.Name of the column to rename. Questo argomento deve essere una stringa, ad esempio "Name" tra virgolette doppie.This name must be a string (for example "Name" with double quotes included).
  • NomeColonnaNuova: obbligatorio.NewColumnName - Required. Nome di sostituzione.Replacement name. Per questo argomento è necessario specificare una stringa, ad esempio "Customer Name" tra virgolette doppie.You must specify a string (for example, "Customer Name" with double quotes included) for this argument.

ShowColumns( Tabella, NomeColonna1 [, NomeColonna2, ... ] )ShowColumns( Table, ColumnName1 [, ColumnName2, ... ] )

  • Table - Obbligatorio.Table - Required. Tabella su cui eseguire le operazioni.Table to operate on.
  • ColumnName(s) - Obbligatorio.ColumnName(s) - Required. Nomi delle colonne da includere.Name(s) of the column(s) to include. Per questo argomento è necessario specificare una stringa, ad esempio "Name" tra virgolette doppie.You must specify a string (for example, "Name" with double quotes included) for this argument.

EsempiExamples

Gli esempi riportati di seguito usano l'origine dati IceCreamSales, che contiene i dati della tabella seguente:The examples in this section use the IceCreamSales data source, which contains the data in this table:

Nessuno di questi esempi modifica l'origine dati IceCreamSales.None of these examples modify the IceCreamSales data source. Ogni funzione trasforma il valore dell'origine dati come tabella e restituisce tale valore come risultato.Each function transforms the value of the data source as a table and returns that value as the result.

FormulaFormula DescrizioneDescription RisultatoResult
AddColumns( IceCreamSales, "Revenue", UnitPrice * QuantitySold )AddColumns( IceCreamSales, "Revenue", UnitPrice * QuantitySold ) Aggiunge la colonna Revenue al risultato.Adds a Revenue column to the result. Per ogni record, viene calcolato il valore UnitPrice * QuantitySold e il risultato viene inserito nella nuova colonna.For each record, UnitPrice * QuantitySold is evaluated, and the result is placed in the new column.
DropColumns( IceCreamSales, "UnitPrice" )DropColumns( IceCreamSales, "UnitPrice" ) Esclude la colonna UnitPrice dal risultato.Excludes the UnitPrice column from the result. Usare questa funzione per escludere colonne e usare ShowColumns per includerle.Use this function to exclude columns, and use ShowColumns to include them.
ShowColumns( IceCreamSales, "Flavor" )ShowColumns( IceCreamSales, "Flavor" ) Include solo la colonna Flavor nel risultato.Includes only the Flavor column in the result. Usare questa funzione per includere colonne e usare DropColumns per escluderle.Use this function include columns, and use DropColumns to exclude them.
RenameColumns( IceCreamSales, "UnitPrice", "Price")RenameColumns( IceCreamSales, "UnitPrice", "Price") Rinomina la colonna UnitPrice nel risultato.Renames the UnitPrice colum in the result.
DropColumns(
RenameColumns(
AddColumns( IceCreamSales, "Revenue",
UnitPrice * QuantitySold ),
"UnitPrice", "Price" ),
"Quantity" )
DropColumns(
RenameColumns(
AddColumns( IceCreamSales, "Revenue",
UnitPrice * QuantitySold ),
"UnitPrice", "Price" ),
"Quantity" )
Esegue le trasformazioni di tabella seguenti nell'ordine, a partire dall'interno della formula:Performs the following table transforms in order, starting from the inside of the formula:
  1. Aggiunge una colonna Revenue basata sul calcolo per ogni record di UnitPrice * Quantity.Adds a Revenue column based on the per-record calculation of UnitPrice * Quantity.
  2. Rinomina UnitPrice in Price.Renames UnitPrice to Price.
  3. Esclude la colonna Quantity.Excludes the Quantity column.
Si noti che l'ordine è importante.Note that order is important. Ad esempio, non è possibile eseguire calcoli con UnitPrice dopo che la colonna è stata rinominata.For example, we can't calculate with UnitPrice after it has been renamed.

Procedura dettagliataStep by step

  1. Importare o creare una raccolta denominata Inventory, come descritto nella prima sottoprocedura di Show text and images in a gallery (Visualizzare immagini e testo in una raccolta).Import or create a collection named Inventory as the first subprocedure in Show text and images in a gallery describes.
  2. Aggiungere un pulsante e impostarne la proprietà OnSelect su questa formula:Add a button, and set its OnSelect property to this formula:

    ClearCollect(Inventory2, RenameColumns(Inventory, "ProductName", "JacketID"))ClearCollect(Inventory2, RenameColumns(Inventory, "ProductName", "JacketID"))

  3. Premere F5, selezionare il pulsante appena creato e quindi premere ESC per tornare all'area di progettazione.Press F5, select the button that you just created, and then press Esc to return to the design workspace.
  4. Nel menu File selezionare Raccolte.On the File menu, select Collections.
  5. Verificare di avere creato una raccolta, denominata Inventory2.Confirm that you've created a collection, named Inventory2. La nuova raccolta contiene le stesse informazioni di Inventory ad eccezione del fatto che la colonna denominata ProductName in Inventory è denominata JacketID in Inventory2.The new collection contains the same information as Inventory except that the column named ProductName in Inventory is named JacketID in Inventory2.