Funciones AddColumns, DropColumns, CambiarNombreColumnas y MostrarColumnas en PowerAppsAddColumns, DropColumns, RenameColumns, and ShowColumns functions in PowerApps

Forma una tabla agregando, quitando, cambiando el nombre y seleccionando sus columnas.Shapes a table by adding, dropping, renaming, and selecting its columns.

Información generalOverview

Estas funciones dan forma a una tabla mediante el ajuste de sus columnas:These functions shape a table by adjusting its columns:

  • Reducción de una tabla que contiene varias columnas a una sola columna para su uso con las funciones de columna única, como Minusc 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.
  • Incorporación de una columna calculada a una tabla (por ejemplo, una columna Total Price que muestre el resultado de multiplicar Quantity por 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).
  • Cambio del nombre de una columna a algo más significativo, para mostrarla a los usuarios o para su uso en las fórmulas.Rename a column to something more meaningful, for display to users or for use in formulas.

Una tabla es un valor en PowerApps, como una cadena o un número.A table is a value in PowerApps, just like a string or a number. Puede especificar una tabla como un argumento en una fórmula, y las funciones pueden devolver una tabla como resultado.You can specify a table as an argument in a formula, and functions can return a table as a result. Las funciones que se describen en este tema no modifican una tabla.The functions that this topic describes don't modify a table. En su lugar, usan una tabla como un argumento y devuelven una nueva tabla con una transformación aplicada.Instead they take a table as an argument and return a new table with a transform applied. Consulte cómo trabajar con tablas para más detalles.See working with tables for more details.

No se pueden modificar las columnas de un origen de datos mediante el uso de estas funciones.You can't modify the columns of a data source by using these functions. Tiene que modificar los datos en su origen.You must modify the data at its source. Puede agregar columnas a una colección con la función Recopilar.You can add columns to a collection with the Collect function. Consulte cómo trabajar con fuentes de datos para más detalles.See working with data sources for more details.

DescripciónDescription

La función AddColumns agrega una columna a una tabla y una fórmula define los valores de esa columna.The AddColumns function adds a column to a table, and a formula defines the values in that column. Las columnas existentes permanecen sin modificar.Existing columns remain unmodified.

La fórmula se evalúa para cada registro de la tabla.The formula is evaluated for each record of the table.

Los campos del registro que se están procesando actualmente están disponibles en la fórmula.Fields of the record currently being processed are available within the formula. Solo tiene que hacer referencia a ellos por su nombre, como haría con cualquier otro valor.You simply reference them by name as you would any other value. También puede hacer referencia a propiedades de control y otros valores en toda la aplicación.You can also reference control properties and other values from throughout your app. Para obtener más información, consulte los siguientes ejemplos y la sección sobre cómo trabajar con ámbito de registro.For more details, see the examples below and working with record scope.

La función DropColumns excluye las columnas de una tabla.The DropColumns function excludes columns from a table. El resto de las columnas permanece sin modificar.All other columns remain unmodified. DropColumns excluye las columnas, y MostrarColumnas las incluye.DropColumns excludes columns, and ShowColumns includes columns.

La función CambiarNombreColumnas cambia el nombre de las columnas de una tabla.The RenameColumns function renames columns of a table. Todas las demás columnas mantienen sus nombres originales.All other columns retain their original names.

La función MostrarColumnas incluye columnas de una tabla y quita todas las demás columnas.The ShowColumns function includes columns of a table and drops all other columns. Puede usar MostrarColumnas para crear una tabla de una sola columna a partir de una tabla de varias columnas.You can use ShowColumns to create a single-column table from a multi-column table. MostrarColumnas incluye columnas, y DropColumns las excluye.ShowColumns includes columns, and DropColumns excludes columns.

Para todas estas funciones, el resultado es una nueva tabla con la transformación aplicada.For all these functions, the result is a new table with the transform applied. La tabla original no se modifica.The original table isn't modified.

Cuando se usa con un origen de datos, estas funciones no se pueden delegar.When used with a data source, these functions can't be delegated. Solo se recuperará la primera parte del origen de datos y, después, se aplicará la función.Only the first portion of the data source will be retrieved and then the function applied. Es posible que el resultado no represente la situación completa.The result may not represent the complete story. Aparecerá un punto azul durante la creación para recordarle esta limitación y sugerirle que cambie a alternativas que puedan delegarse siempre que sea posible.A blue dot will appear at authoring time to remind you of this limitation and to suggest switching to delegable alternatives where possible. Para más información, consulte la introducción a la delegación.For more information, see the delegation overview.

SintaxisSyntax

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

  • Table: requerido.Table - Required. La tabla sobre la cual se opera.Table to operate on.
  • ColumnName(s): requerido.ColumnName(s) - Required. Nombres de las columnas para agregar.Name(s) of the column(s) to add. Tiene que especificar una cadena (por ejemplo, "Name" entre comillas dobles incluidas) para este argumento.You must specify a string (for example, "Name" with double quotes included) for this argument.
  • Formula(s): requerido.Formula(s) - Required. La fórmula o fórmulas para evaluar para cada registro.Formula(s) to evaluate for each record. Se agregará el resultado como el valor de la nueva columna correspondiente.The result is added as the value of the corresponding new column. Puede hacer referencia a otras columnas de la tabla en esta fórmula.You can reference other columns of the table in this formula.

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

  • Table: requerido.Table - Required. La tabla sobre la cual se opera.Table to operate on.
  • ColumnName(s): requerido.ColumnName(s) - Required. Nombres de las columnas para excluir.Name(s) of the column(s) to drop. Tiene que especificar una cadena (por ejemplo, "Name" entre comillas dobles incluidas) para este argumento.You must specify a string (for example, "Name" with double quotes included) for this argument.

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

  • Table: requerido.Table - Required. La tabla sobre la cual se opera.Table to operate on.
  • OldColumnName: requerido.OldColumnName - Required. Nombre de la columna a la que se va a cambiar el nombre.Name of the column to rename. Este nombre tiene que ser una cadena (por ejemplo, "Name" entre comillas dobles incluidas).This name must be a string (for example "Name" with double quotes included).
  • NewColumnName: requerido.NewColumnName - Required. Nombre de reemplazo.Replacement name. Tiene que especificar una cadena (por ejemplo, "Customer Name" entre comillas dobles incluidas) para este argumento.You must specify a string (for example, "Customer Name" with double quotes included) for this argument.

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

  • Table: requerido.Table - Required. La tabla sobre la cual se opera.Table to operate on.
  • ColumnName(s): requerido.ColumnName(s) - Required. Nombres de las columnas para incluir.Name(s) of the column(s) to include. Tiene que especificar una cadena (por ejemplo, "Name" entre comillas dobles incluidas) para este argumento.You must specify a string (for example, "Name" with double quotes included) for this argument.

EjemplosExamples

En los ejemplos en esta sección, use el origen de datos IceCreamSales, que contiene los datos de esta tabla:The examples in this section use the IceCreamSales data source, which contains the data in this table:

Ninguno de estos ejemplos modificar el origen de datos IceCreamSales.None of these examples modify the IceCreamSales data source. Cada función transforma el valor del origen de datos como una tabla y devuelve ese valor como resultado.Each function transforms the value of the data source as a table and returns that value as the result.

FórmulaFormula DescripciónDescription ResultadoResult
AddColumns (IceCreamSales, "Revenue", UnitPrice * QuantitySold)AddColumns( IceCreamSales, "Revenue", UnitPrice * QuantitySold ) Agrega una columna Revenue al resultado.Adds a Revenue column to the result. Para cada registro, se evalúa UnitPrice * QuantitySold, y el resultado se coloca en la nueva columna.For each record, UnitPrice * QuantitySold is evaluated, and the result is placed in the new column.
DropColumns (IceCreamSales, "UnitPrice")DropColumns( IceCreamSales, "UnitPrice" ) Excluye la columna UnitPrice del resultado.Excludes the UnitPrice column from the result. Use esta función para excluir columnas y usar MostrarColumnas para incluirlas.Use this function to exclude columns, and use ShowColumns to include them.
MostrarColumnas (IceCreamSales, "Flavor")ShowColumns( IceCreamSales, "Flavor" ) Incluye solamente la columna Flavor en el resultado.Includes only the Flavor column in the result. Use esta función para incluir columnas y DropColumns para excluirlas.Use this function include columns, and use DropColumns to exclude them.
CambiarNombreColumnas (IceCreamSales, "UnitPrice", "Price")RenameColumns( IceCreamSales, "UnitPrice", "Price") Cambia el nombre de la columna UnitPrice en el resultado.Renames the UnitPrice colum in the result.
DropColumns(
CambiarNombreColumnas(
AddColumns( IceCreamSales, "Revenue",
UnitPrice * QuantitySold ),
"UnitPrice", "Price" ),
"Quantity" )
DropColumns(
RenameColumns(
AddColumns( IceCreamSales, "Revenue",
UnitPrice * QuantitySold ),
"UnitPrice", "Price" ),
"Quantity" )
Realiza las siguientes transformaciones de tabla en orden, comenzando desde el interior de la fórmula:Performs the following table transforms in order, starting from the inside of the formula:
  1. Agrega una columna Revenue basada en el cálculo por registro de UnitPrice * Quantity.Adds a Revenue column based on the per-record calculation of UnitPrice * Quantity.
  2. Cambia el nombre de UnitPrice a Price.Renames UnitPrice to Price.
  3. Excluye la columna Quantity.Excludes the Quantity column.
Tenga en cuenta que el orden es importante.Note that order is important. Por ejemplo, no se puede calcular con UnitPrice después de que se le haya cambiado el nombre.For example, we can't calculate with UnitPrice after it has been renamed.

Paso a pasoStep by step

  1. Importe o cree una colección denominada Inventory, como se describe en el primer subprocedimiento del artículo sobre visualización de imágenes y texto en una galería.Import or create a collection named Inventory as the first subprocedure in Show text and images in a gallery describes.
  2. Agregue un botón y establezca su propiedad OnSelect en esta fórmula:Add a button, and set its OnSelect property to this formula:

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

  3. Presione F5, seleccione el botón que acaba de crear y presione Esc para volver al área de trabajo de diseño.Press F5, select the button that you just created, and then press Esc to return to the design workspace.
  4. En el menú Archivo, seleccione Colecciones.On the File menu, select Collections.
  5. Confirme que ha creado una colección, denominada Inventory2.Confirm that you've created a collection, named Inventory2. La nueva colección contiene la misma información que Inventory salvo que la columna denominada ProductName en Inventory se denomina JacketID en Inventory2.The new collection contains the same information as Inventory except that the column named ProductName in Inventory is named JacketID in Inventory2.