Функции AddColumns, DropColumns, RenameColumns и ShowColumns в Microsoft PowerAppsAddColumns, DropColumns, RenameColumns, and ShowColumns functions in PowerApps

Изменение формата таблицы путем добавления, удаления, переименования и выбора ее столбцов.Shapes a table by adding, dropping, renaming, and selecting its columns.

ОбзорOverview

С помощью этих функций вы можете изменить таблицу и настройки ее столбцов.These functions shape a table by adjusting its columns:

  • Сократите до одного столбца таблицу, состоящую из нескольких столбцов, чтобы использовать ее в функции, принимающей один столбец, например Lower или Abs.Reduce a table that contains multiple columns down to a single column for use with single-column functions, such as Lower or Abs.
  • Добавьте в таблицу вычисляемый столбец (например, столбец Общая цена с результатами умножения значений из столбцов Количество и Цена за единицу).Add a calculated column to a table (for example, a Total Price column that shows the results of multiplying Quantity by Unit Price).
  • Переименуйте столбец, чтобы его имя было более понятным в представлениях для пользователей или в формулах.Rename a column to something more meaningful, for display to users or for use in formulas.

Таблица в PowerApps считается значением, как любая строка или число.A table is a value in PowerApps, just like a string or a number. Таблицы можно использовать в качестве аргумента формулы, и функции могут возвращать таблицу.You can specify a table as an argument in a formula, and functions can return a table as a result. Функции, которые описаны в этом разделе, не изменяют входную таблицу.The functions that this topic describes don't modify a table. Они принимают таблицу в качестве аргумента и возвращают новую таблицу, применив к ней запрошенное преобразование.Instead they take a table as an argument and return a new table with a transform applied. Подробнее это описано здесь.See working with tables for more details.

Вы не можете с помощью этих функций изменять столбцы источника данных.You can't modify the columns of a data source by using these functions. Такие данные следует изменять прямо в источнике данных.You must modify the data at its source. Вы можете добавить столбцы к коллекции с помощью функции Collect.You can add columns to a collection with the Collect function. Подробнее это описано здесь.See working with data sources for more details.

ОписаниеDescription

Функция AddColumns добавляет столбец к таблице и с помощью формулы определяет значения для этого столбца.The AddColumns function adds a column to a table, and a formula defines the values in that column. Существующие столбцы сохраняются без изменений.Existing columns remain unmodified.

Формула вычисляется отдельно для каждой записи этой таблицы.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.

Функция DropColumns исключает столбцы из таблицы.The DropColumns function excludes columns from a table. Все остальные столбцы сохраняются без изменений.All other columns remain unmodified. DropColumns исключает столбцы, а ShowColumns включает новые столбцы.DropColumns excludes columns, and ShowColumns includes columns.

Функция RenameColumns изменяет имя столбца в таблице.The RenameColumns function renames columns of a table. Все остальные столбцы сохраняют первоначальные имена.All other columns retain their original names.

Функция ShowColumns включает в результат указанные столбцы таблицы и удаляет все остальные.The ShowColumns function includes columns of a table and drops all other columns. Функцию ShowColumns можно использовать для выделения одного столбца из таблицы с несколькими столбцами.You can use ShowColumns to create a single-column table from a multi-column table. ShowColumns включает столбцы, а DropColumns исключает столбцы.ShowColumns includes columns, and DropColumns excludes columns.

Все эти функции возвращают новую таблицу, к которой применено соответствующее преобразование.For all these functions, the result is a new table with the transform applied. Исходная таблица сохраняется без изменений.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.

СинтаксисSyntax

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

  • Table — обязательный аргумент.Table - Required. Таблица, для которой выполняется операция.Table to operate on.
  • ColumnName — обязательный аргумент.ColumnName(s) - Required. Имена столбцов для добавления.Name(s) of the column(s) to add. Этот аргумент принимает строку (например, "Name" в двойных кавычках).You must specify a string (for example, "Name" with double quotes included) for this argument.
  • Formula(s) — обязательный параметр.Formula(s) - Required. Формула или формулы, вычисляемые для каждой записи таблицы.Formula(s) to evaluate for each record. Результат добавляется в итоговую таблицу как значение соответствующего нового столбца.The result is added as the value of the corresponding new column. Вы можете использовать в этой формуле ссылки на другие столбцы таблицы.You can reference other columns of the table in this formula.

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

  • Table — обязательный аргумент.Table - Required. Таблица, для которой выполняется операция.Table to operate on.
  • ColumnName — обязательный аргумент.ColumnName(s) - Required. Имена столбцов для исключения.Name(s) of the column(s) to drop. Этот аргумент принимает строку (например, "Name" в двойных кавычках).You must specify a string (for example, "Name" with double quotes included) for this argument.

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

  • Table — обязательный аргумент.Table - Required. Таблица, для которой выполняется операция.Table to operate on.
  • OldColumnName — обязательный аргумент.OldColumnName - Required. Имя столбца, который следует переименовать.Name of the column to rename. Этот аргумент принимает строку (например, "Name" в двойных кавычках).This name must be a string (for example "Name" with double quotes included).
  • NewColumnName — обязательный аргумент.NewColumnName - Required. Имя, которое нужно использовать вместо старого.Replacement name. Этот аргумент принимает строку (например, "Customer Name" в двойных кавычках).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 — обязательный аргумент.Table - Required. Таблица, для которой выполняется операция.Table to operate on.
  • ColumnName — обязательный аргумент.ColumnName(s) - Required. Имена столбцов для включения.Name(s) of the column(s) to include. Этот аргумент принимает строку (например, "Name" в двойных кавычках).You must specify a string (for example, "Name" with double quotes included) for this argument.

ПримерыExamples

В следующих примерах мы будем использовать источник данных IceCreamSales, который содержит данные в такой таблице:The examples in this section use the IceCreamSales data source, which contains the data in this table:

Ни один из этих примеров не изменяет исходную таблицу источника данных IceCreamSales.None of these examples modify the IceCreamSales data source. Каждая функция преобразует ее в новую таблицу и возвращает полученную таблицу в результате.Each function transforms the value of the data source as a table and returns that value as the result.

ФормулаFormula ОписаниеDescription Возвращаемый результатResult
AddColumns( IceCreamSales, "Revenue", UnitPrice * QuantitySold )AddColumns( IceCreamSales, "Revenue", UnitPrice * QuantitySold ) Добавляет к результату столбец Revenue.Adds a Revenue column to the result. Для каждой записи вычисляется выражение UnitPrice × QuantitySold. Результат вычисления помещается в новый столбец.For each record, UnitPrice * QuantitySold is evaluated, and the result is placed in the new column.
DropColumns( IceCreamSales, "UnitPrice" )DropColumns( IceCreamSales, "UnitPrice" ) Исключает из результата столбец UnitPrice.Excludes the UnitPrice column from the result. Эта функция позволяет исключить столбцы, а ShowColumns включает их.Use this function to exclude columns, and use ShowColumns to include them.
ShowColumns( IceCreamSales, "Flavor" )ShowColumns( IceCreamSales, "Flavor" ) Включает в результат только столбец Flavor.Includes only the Flavor column in the result. Эта функция позволяет включить столбцы, а DropColumns исключает их.Use this function include columns, and use DropColumns to exclude them.
RenameColumns( IceCreamSales, "UnitPrice", "Price")RenameColumns( IceCreamSales, "UnitPrice", "Price") Переименовывает столбец UnitPrice в итоговой таблице.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" )
Поочередно выполняет следующие преобразования, начиная с "внутренней стороны" формулы.Performs the following table transforms in order, starting from the inside of the formula:
  1. Добавляет столбец Revenue заполняемый данными по формуле UnitPrice × Quantity.Adds a Revenue column based on the per-record calculation of UnitPrice * Quantity.
  2. Переименовывает столбец UnitPrice в Price.Renames UnitPrice to Price.
  3. Исключает столбец Quantity.Excludes the Quantity column.
Обратите внимание, что порядок выполнения имеет значение.Note that order is important. Например, мы не сможем вычислить UnitPrice после того, как переименуем его.For example, we can't calculate with UnitPrice after it has been renamed.

Шаг за шагомStep by step

  1. Импортируйте или создайте коллекцию с именем Inventory, как описано в первом шаге демонстрации текста и изображений в коллекции.Import or create a collection named Inventory as the first subprocedure in Show text and images in a gallery describes.
  2. Добавьте кнопку и задайте следующую формулу в качестве значения свойства OnSelect:Add a button, and set its OnSelect property to this formula:

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

  3. Нажмите клавишу F5, нажмите только что созданную кнопку, затем нажмите клавишу Esc, чтобы вернуться в рабочую область конструирования.Press F5, select the button that you just created, and then press Esc to return to the design workspace.
  4. В меню Файл выберите Коллекции.On the File menu, select Collections.
  5. Убедитесь, что создана коллекция с именем Inventory2.Confirm that you've created a collection, named Inventory2. Новая коллекция содержит те же сведения, что и Inventory, но столбец с именем ProductName из коллекции Inventory теперь называется JacketID в новой коллекции Inventory2.The new collection contains the same information as Inventory except that the column named ProductName in Inventory is named JacketID in Inventory2.