Forma una tabla agregando, quitando, cambiando el nombre y seleccionando sus columnas.

Información general

Estas funciones dan forma a una tabla mediante el ajuste de sus columnas:

  • 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.
  • 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).
  • Cambio del nombre de una columna a algo más significativo, para mostrarla a los usuarios o para su uso en las fórmulas.

Una tabla es un valor en PowerApps, como una cadena o un número. Puede especificar una tabla como un argumento en una fórmula, y las funciones pueden devolver una tabla como resultado. Las funciones que se describen en este tema no modifican una tabla. En su lugar, usan una tabla como un argumento y devuelven una nueva tabla con una transformación aplicada. Consulte cómo trabajar con tablas para más detalles.

No se pueden modificar las columnas de un origen de datos mediante el uso de estas funciones. Tiene que modificar los datos en su origen. Puede agregar columnas a una colección con la función Recopilar. Consulte cómo trabajar con fuentes de datos para más detalles.

Descripción

La función AddColumns agrega una columna a una tabla y una fórmula define los valores de esa columna. Las columnas existentes permanecen sin modificar.

La fórmula se evalúa para cada registro de la tabla.

Los campos del registro que se están procesando actualmente están disponibles en la fórmula. Solo tiene que hacer referencia a ellos por su nombre, como haría con cualquier otro valor. También puede hacer referencia a propiedades de control y otros valores en toda la aplicación. Para obtener más información, consulte los siguientes ejemplos y la sección sobre cómo trabajar con ámbito de registro.

La función DropColumns excluye las columnas de una tabla. El resto de las columnas permanece sin modificar. DropColumns excluye las columnas, y MostrarColumnas las incluye.

La función CambiarNombreColumnas cambia el nombre de las columnas de una tabla. Todas las demás columnas mantienen sus nombres originales.

La función MostrarColumnas incluye columnas de una tabla y quita todas las demás columnas. Puede usar MostrarColumnas para crear una tabla de una sola columna a partir de una tabla de varias columnas. MostrarColumnas incluye columnas, y DropColumns las excluye.

Para todas estas funciones, el resultado es una nueva tabla con la transformación aplicada. La tabla original no se modifica.

Cuando se usa con un origen de datos, estas funciones no se pueden delegar. Solo se recuperará la primera parte del origen de datos y, después, se aplicará la función. Es posible que el resultado no represente la situación completa. 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. Para más información, consulte la introducción a la delegación.

Sintaxis

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

  • Table: requerido. La tabla sobre la cual se opera.
  • ColumnName(s): requerido. Nombres de las columnas para agregar. Tiene que especificar una cadena (por ejemplo, "Name" entre comillas dobles incluidas) para este argumento.
  • Formula(s): requerido. La fórmula o fórmulas para evaluar para cada registro. Se agregará el resultado como el valor de la nueva columna correspondiente. Puede hacer referencia a otras columnas de la tabla en esta fórmula.

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

  • Table: requerido. La tabla sobre la cual se opera.
  • ColumnName(s): requerido. Nombres de las columnas para excluir. Tiene que especificar una cadena (por ejemplo, "Name" entre comillas dobles incluidas) para este argumento.

CambiarNombreColumnas( Table, OldColumneName, NewColumnName )

  • Table: requerido. La tabla sobre la cual se opera.
  • OldColumnName: requerido. Nombre de la columna a la que se va a cambiar el nombre. Este nombre tiene que ser una cadena (por ejemplo, "Name" entre comillas dobles incluidas).
  • NewColumnName: requerido. Nombre de reemplazo. Tiene que especificar una cadena (por ejemplo, "Customer Name" entre comillas dobles incluidas) para este argumento.

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

  • Table: requerido. La tabla sobre la cual se opera.
  • ColumnName(s): requerido. Nombres de las columnas para incluir. Tiene que especificar una cadena (por ejemplo, "Name" entre comillas dobles incluidas) para este argumento.

Ejemplos

En los ejemplos en esta sección, use el origen de datos IceCreamSales, que contiene los datos de esta tabla:

Ninguno de estos ejemplos modificar el origen de datos IceCreamSales. Cada función transforma el valor del origen de datos como una tabla y devuelve ese valor como resultado.

Fórmula Descripción Resultado
AddColumns (IceCreamSales, "Revenue", UnitPrice * QuantitySold) Agrega una columna Revenue al resultado. Para cada registro, se evalúa UnitPrice * QuantitySold, y el resultado se coloca en la nueva columna.
DropColumns (IceCreamSales, "UnitPrice") Excluye la columna UnitPrice del resultado. Use esta función para excluir columnas y usar MostrarColumnas para incluirlas.
MostrarColumnas (IceCreamSales, "Flavor") Incluye solamente la columna Flavor en el resultado. Use esta función para incluir columnas y DropColumns para excluirlas.
CambiarNombreColumnas (IceCreamSales, "UnitPrice", "Price") Cambia el nombre de la columna UnitPrice en el resultado.
DropColumns(
CambiarNombreColumnas(
AddColumns( IceCreamSales, "Revenue",
UnitPrice * QuantitySold ),
"UnitPrice", "Price" ),
"Quantity" )		 Realiza las siguientes transformaciones de tabla en orden, comenzando desde el interior de la fórmula:
  1. Agrega una columna Revenue basada en el cálculo por registro de UnitPrice * Quantity.
  2. Cambia el nombre de UnitPrice a Price.
  3. Excluye la columna Quantity.
Tenga en cuenta que el orden es importante. Por ejemplo, no se puede calcular con UnitPrice después de que se le haya cambiado el nombre.

Paso a paso

  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.

  2. Agregue un botón y establezca su propiedad OnSelect en esta fórmula:

    ClearCollect(Inventory2, CambiarNombreColumnas(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.

  4. En el menú Archivo, seleccione Colecciones.

  5. Confirme que ha creado una colección, denominada 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.