Fonctions AddColumns, DropColumns, RenameColumns et ShowColumns dans PowerAppsAddColumns, DropColumns, RenameColumns, and ShowColumns functions in PowerApps

Permet de façonner une table en ajoutant et en supprimant des colonnes, en les renommant et en les sélectionnant.Shapes a table by adding, dropping, renaming, and selecting its columns.

Vue d’ensembleOverview

Ces fonctions façonnent une table en ajustant ses colonnes :These functions shape a table by adjusting its columns:

  • Vous transformez une table contenant plusieurs colonnes en une table contenant une seule colonne que vous utiliserez avec des fonctions à colonne unique, par exemple Lower ou Abs.Reduce a table that contains multiple columns down to a single column for use with single-column functions, such as Lower or Abs.
  • Vous ajoutez une colonne calculée à une table (par exemple, une colonne Prix total dont les résultats correspondent à la quantité multipliée par le prix unitaire).Add a calculated column to a table (for example, a Total Price column that shows the results of multiplying Quantity by Unit Price).
  • Vous renommez une colonne et lui donnez un nom plus pertinent pour les utilisateurs ou pour une utilisation dans des formules.Rename a column to something more meaningful, for display to users or for use in formulas.

Dans PowerApps, une table n’est pas simplement une chaîne ou un nombre. C’est une valeur.A table is a value in PowerApps, just like a string or a number. Vous pouvez spécifier une table en tant qu’argument dans une formule, et les fonctions peuvent renvoyer une table comme résultat.You can specify a table as an argument in a formula, and functions can return a table as a result. Les fonctions décrites dans cette rubrique ne modifient pas les tables.The functions that this topic describes don't modify a table. Au lieu de cela, elles prennent une table en tant qu’argument et renvoient une nouvelle table en lui appliquant une transformation.Instead they take a table as an argument and return a new table with a transform applied. Pour plus d’informations, voir Utilisation des tables.See working with tables for more details.

Vous ne pouvez pas modifier les colonnes d’une source de données à l’aide de ces fonctions.You can't modify the columns of a data source by using these functions. Vous devez modifier les données à la source.You must modify the data at its source. Vous pouvez ajouter des colonnes à une collection avec la fonction Collect.You can add columns to a collection with the Collect function. Pour plus d’informations, voir Utilisation des sources de données.See working with data sources for more details.

DescriptionDescription

La fonction AddColumns ajoute une colonne à une table, tandis qu’une formule définit les valeurs de cette colonne.The AddColumns function adds a column to a table, and a formula defines the values in that column. Les colonnes existantes restent inchangées.Existing columns remain unmodified.

La formule est évaluée pour chaque enregistrement de la table.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 fonction DropColumns exclut des colonnes d’une table.The DropColumns function excludes columns from a table. Toutes les autres colonnes restent inchangées.All other columns remain unmodified. DropColumns exclut des colonnes, tandis que ShowColumns en inclut.DropColumns excludes columns, and ShowColumns includes columns.

La fonction RenameColumns renomme les colonnes d’une table.The RenameColumns function renames columns of a table. Toutes les autres colonnes conservent leur nom d’origine.All other columns retain their original names.

La fonction ShowColumns inclut les colonnes d’une table et supprime toutes les autres colonnes.The ShowColumns function includes columns of a table and drops all other columns. Vous pouvez utiliser ShowColumns pour créer une table à une colonne à partir d’une table à plusieurs colonnes.You can use ShowColumns to create a single-column table from a multi-column table. ShowColumns inclut des colonnes, tandis que DropColumns en exclut.ShowColumns includes columns, and DropColumns excludes columns.

Pour toutes ces fonctions, le résultat est une nouvelle table présentant une transformation.For all these functions, the result is a new table with the transform applied. La table d’origine n’est pas modifiée.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.

SyntaxeSyntax

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

  • Table - Requis.Table - Required. Table à utiliser.Table to operate on.
  • ColumnName(s) - Requis.ColumnName(s) - Required. Noms des colonnes à ajouter.Name(s) of the column(s) to add. Vous devez spécifier une chaîne (par exemple, "Name" entre guillemets doubles) pour cet argument.You must specify a string (for example, "Name" with double quotes included) for this argument.
  • Formula : requis.Formula(s) - Required. Formules à évaluer pour chaque enregistrement.Formula(s) to evaluate for each record. Le résultat est ajouté en tant que valeur de la nouvelle colonne correspondante.The result is added as the value of the corresponding new column. Vous pouvez référencer d’autres colonnes de la table dans cette formule.You can reference other columns of the table in this formula.

DropColumns( Table, ColumnName1 [, ColumnName2, ... ] )DropColumns( Table, ColumnName1 [, ColumnName2, ... ] )

  • Table - Requis.Table - Required. Table à utiliser.Table to operate on.
  • ColumnName(s) - Requis.ColumnName(s) - Required. Noms des colonnes à supprimer.Name(s) of the column(s) to drop. Vous devez spécifier une chaîne (par exemple, "Name" entre guillemets doubles) pour cet argument.You must specify a string (for example, "Name" with double quotes included) for this argument.

RenameColumns( Table, OldColumneName, NewColumnName )RenameColumns( Table, OldColumneName, NewColumnName )

  • Table - Requis.Table - Required. Table à utiliser.Table to operate on.
  • OldColumnName : requis.OldColumnName - Required. Nom de la colonne à renommer.Name of the column to rename. Vous devez spécifier une chaîne (par exemple, "Name" entre guillemets doubles).This name must be a string (for example "Name" with double quotes included).
  • NewColumnName : requis.NewColumnName - Required. Nom utilisé en remplacement.Replacement name. Vous devez spécifier une chaîne (par exemple, "Customer Name" entre guillemets doubles) pour cet argument.You must specify a string (for example, "Customer Name" with double quotes included) for this argument.

ShowColumns( Table, ColumnName1 [, ColumnName2, ... ] )ShowColumns( Table, ColumnName1 [, ColumnName2, ... ] )

  • Table - Requis.Table - Required. Table à utiliser.Table to operate on.
  • ColumnName(s) - Requis.ColumnName(s) - Required. Noms des colonnes à inclure.Name(s) of the column(s) to include. Vous devez spécifier une chaîne (par exemple, "Name" entre guillemets doubles) pour cet argument.You must specify a string (for example, "Name" with double quotes included) for this argument.

ExemplesExamples

Dans les exemples de cette section, nous allons utiliser la source de données IceCreamSales qui contient les données de cette table :The examples in this section use the IceCreamSales data source, which contains the data in this table:

Aucun de ces exemples ne modifie la source de données IceCreamSales.None of these examples modify the IceCreamSales data source. Chaque fonction transforme la valeur de la source de données en table et renvoie cette valeur en tant que résultat.Each function transforms the value of the data source as a table and returns that value as the result.

FormuleFormula DescriptionDescription RésultatResult
AddColumns( IceCreamSales, "Revenue", UnitPrice * QuantitySold )AddColumns( IceCreamSales, "Revenue", UnitPrice * QuantitySold ) Ajoute une colonne Revenue au résultat.Adds a Revenue column to the result. Pour chaque enregistrement, la valeur UnitPrice * QuantitySold est calculée, et le résultat placé dans la nouvelle colonne.For each record, UnitPrice * QuantitySold is evaluated, and the result is placed in the new column.
DropColumns( IceCreamSales, "UnitPrice" )DropColumns( IceCreamSales, "UnitPrice" ) Exclut la colonne UnitPrice du résultat.Excludes the UnitPrice column from the result. Utilisez cette fonction pour exclure des colonnes et utilisez ShowColumns pour les inclure.Use this function to exclude columns, and use ShowColumns to include them.
ShowColumns( IceCreamSales, "Flavor" )ShowColumns( IceCreamSales, "Flavor" ) Inclut uniquement la colonne Flavor dans le résultat.Includes only the Flavor column in the result. Utilisez cette fonction pour inclure des colonnes et utilisez DropColumns pour les exclure.Use this function include columns, and use DropColumns to exclude them.
RenameColumns( IceCreamSales, "UnitPrice", "Price")RenameColumns( IceCreamSales, "UnitPrice", "Price") Renomme la colonne UnitPrice dans le résultat.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" )
Effectue les transformations de table suivantes dans l’ordre, à partir de celles figurant dans la formule :Performs the following table transforms in order, starting from the inside of the formula:
  1. Ajoute une colonne Revenue qui dépend du calcul par enregistrement de UnitPrice * Quantity.Adds a Revenue column based on the per-record calculation of UnitPrice * Quantity.
  2. Renomme UnitPrice en Price.Renames UnitPrice to Price.
  3. Exclut la colonne Quantity.Excludes the Quantity column.
Notez que l’ordre est important.Note that order is important. Par exemple, nous ne pouvons pas effectuer de calcul avec la colonne UnitPrice après qu’elle a été renommée.For example, we can't calculate with UnitPrice after it has been renamed.

Étape par étapeStep by step

  1. Importez ou créez une collection appelée Inventory comme le décrit la première sous-procédure de l’article Afficher des images et du texte dans une galerie.Import or create a collection named Inventory as the first subprocedure in Show text and images in a gallery describes.
  2. Ajoutez un bouton, puis définissez sa propriété OnSelect sur la formule suivante :Add a button, and set its OnSelect property to this formula:

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

  3. Appuyez sur F5, sélectionnez le bouton que vous venez de créer, puis appuyez sur ÉCHAP pour revenir à l’espace de conception.Press F5, select the button that you just created, and then press Esc to return to the design workspace.
  4. Dans le menu Fichier, sélectionnez Collections.On the File menu, select Collections.
  5. Vérifiez que vous avez créé une collection appelée Inventory2.Confirm that you've created a collection, named Inventory2. La nouvelle collection contient les mêmes informations que Inventory à ceci près que la colonne appelée ProductName dans Inventory est appelée JacketID dans Inventory2.The new collection contains the same information as Inventory except that the column named ProductName in Inventory is named JacketID in Inventory2.