Permet de façonner une table en ajoutant et en supprimant des colonnes, en les renommant et en les sélectionnant.

Vue d’ensemble

Ces fonctions façonnent une table en ajustant ses colonnes :

  • 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.
  • 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).
  • Vous renommez une colonne et lui donnez un nom plus pertinent pour les utilisateurs ou pour une utilisation dans des formules.

Dans PowerApps, une table n’est pas simplement une chaîne ou un nombre. C’est une valeur. Vous pouvez spécifier une table en tant qu’argument dans une formule, et les fonctions peuvent renvoyer une table comme résultat. Les fonctions décrites dans cette rubrique ne modifient pas les tables. Au lieu de cela, elles prennent une table en tant qu’argument et renvoient une nouvelle table en lui appliquant une transformation. Pour plus d’informations, voir Utilisation des tables.

Vous ne pouvez pas modifier les colonnes d’une source de données à l’aide de ces fonctions. Vous devez modifier les données à la source. Vous pouvez ajouter des colonnes à une collection avec la fonction Collect. Pour plus d’informations, voir Utilisation des sources de données.

Description

La fonction AddColumns ajoute une colonne à une table, tandis qu’une formule définit les valeurs de cette colonne. Les colonnes existantes restent inchangées.

La formule est évaluée pour chaque enregistrement de la table.

Les champs de l’enregistrement en cours de traitement sont disponibles dans la formule. Vous y faites simplement référence par nom comme vous le feriez pour toute autre valeur. Vous pouvez également référencer les propriétés de contrôle et d’autres valeurs à partir de votre application. Pour plus d’informations, consultez les exemples ci-dessous et la section relative à l’utilisation des étendues d’enregistrement.

La fonction DropColumns exclut des colonnes d’une table. Toutes les autres colonnes restent inchangées. DropColumns exclut des colonnes, tandis que ShowColumns en inclut.

La fonction RenameColumns renomme les colonnes d’une table. Toutes les autres colonnes conservent leur nom d’origine.

La fonction ShowColumns inclut les colonnes d’une table et supprime toutes les autres colonnes. Vous pouvez utiliser ShowColumns pour créer une table à une colonne à partir d’une table à plusieurs colonnes. ShowColumns inclut des colonnes, tandis que DropColumns en exclut.

Pour toutes ces fonctions, le résultat est une nouvelle table présentant une transformation. La table d’origine n’est pas modifiée.

Lorsqu’elles sont utilisées avec une source de données, ces fonctions ne peuvent pas être déléguées. Seule la première partie de la source de données est récupérée, puis la fonction est appliquée. Le résultat peut donc être incomplet. Un point bleu apparaît au moment de l’autorisation pour vous rappeler cette limitation et vous suggérer d’utiliser des fonctions équivalentes pouvant être déléguées lorsque vous le pouvez. Pour plus d’informations, consultez la vue d’ensemble des délégations.

Syntaxe

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

  • Table - Requis. Table à utiliser.
  • ColumnName(s) - Requis. Noms des colonnes à ajouter. Vous devez spécifier une chaîne (par exemple, "Name" entre guillemets doubles) pour cet argument.
  • *Formula* : requis. Formules à évaluer pour chaque enregistrement. Le résultat est ajouté en tant que valeur de la nouvelle colonne correspondante. Vous pouvez référencer d’autres colonnes de la table dans cette formule.

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

  • Table - Requis. Table à utiliser.
  • ColumnName(s) - Requis. Noms des colonnes à supprimer. Vous devez spécifier une chaîne (par exemple, "Name" entre guillemets doubles) pour cet argument.

RenameColumns( Table, OldColumneName, NewColumnName )

  • Table - Requis. Table à utiliser.
  • *OldColumnName* : requis. Nom de la colonne à renommer. Vous devez spécifier une chaîne (par exemple, "Name" entre guillemets doubles).
  • *NewColumnName* : requis. Nom utilisé en remplacement. Vous devez spécifier une chaîne (par exemple, "Customer Name" entre guillemets doubles) pour cet argument.

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

  • Table - Requis. Table à utiliser.
  • ColumnName(s) - Requis. Noms des colonnes à inclure. Vous devez spécifier une chaîne (par exemple, "Name" entre guillemets doubles) pour cet argument.

Exemples

Dans les exemples de cette section, nous allons utiliser la source de données IceCreamSales qui contient les données de cette table :

Aucun de ces exemples ne modifie la source de données IceCreamSales. Chaque fonction transforme la valeur de la source de données en table et renvoie cette valeur en tant que résultat.

Formule Description Résultat
AddColumns( IceCreamSales, "Revenue", UnitPrice * QuantitySold ) Ajoute une colonne Revenue au résultat. Pour chaque enregistrement, la valeur UnitPrice * QuantitySold est calculée, et le résultat placé dans la nouvelle colonne.
DropColumns( IceCreamSales, "UnitPrice" ) Exclut la colonne UnitPrice du résultat. Utilisez cette fonction pour exclure des colonnes et utilisez ShowColumns pour les inclure.
ShowColumns( IceCreamSales, "Flavor" ) Inclut uniquement la colonne Flavor dans le résultat. Utilisez cette fonction pour inclure des colonnes et utilisez DropColumns pour les exclure.
RenameColumns( IceCreamSales, "UnitPrice", "Price") Renomme la colonne UnitPrice dans le résultat.
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 :
  1. Ajoute une colonne Revenue qui dépend du calcul par enregistrement de UnitPrice * Quantity.
  2. Renomme UnitPrice en Price.
  3. Exclut la colonne Quantity.
Notez que l’ordre est important. Par exemple, nous ne pouvons pas effectuer de calcul avec la colonne UnitPrice après qu’elle a été renommée.

Étape par étape

  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.

  2. Ajoutez un bouton, puis définissez sa propriété OnSelect sur la formule suivante :

    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.

  4. Dans le menu Fichier, sélectionnez Collections.

  5. Vérifiez que vous avez créé une collection appelée 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.