ColumnNames и Column функции

Применимо к: Функции Power Platform CLI Dataverse приложений На основе моделей На основе холста приложений Copilot Studio

Извлекает имена столбцов и значения из динамического значения.

Описание

Функция ColumnNames возвращает имена всех столбцов из динамической записи, возвращая таблицу со всеми именами из этой записи.

Функция Column возвращает значение свойства из динамической записи с заданным именем столбца. Значение возвращается в виде динамического значения.

Функции ColumnNames возвращают ошибки, если динамическое значение не представляет запись (то есть, если она представляет таблицу или скалярное или примитивное Column значение).

Синтаксис

ColumnNames( DynamicRecord )

• DynamicRecord — обязательный. Динамическое значение, представляющее запись.

Column( DynamicRecord, ColumnName )

• DynamicRecord — обязательный. Динамическое значение, представляющее запись.
• Имя столбца - Обязательно. Имя столбца, которое нужно получить из данной записи.

Примеры

Доступ к значениям полей

Учитывая следующую строку JSON в переменной с именем JsonString

{ "name": "Seattle", "population": 737000 }

1. Следующая формула возвращает таблицу с одним столбцом, в которой столбец Value содержит следующие значения: «имя», «заполнение».

   ColumnNames( ParseJSON( JsonString ) )
   

2. Следующая формула возвращает число 737000:

   Value( Column( ParseJSON( JsonString ), "population" ) )
   

   • Обратите внимание, что эта формула аналогична . оператору динамических записей, но имя столбца не должно быть известно заранее.

3. Следующая формула возвращает текстовое "name: Seattle, population: 737000":

   With(
       { untyped: ParseJSON( JsonString ) },
       Concat(
           ColumnNames( untyped ),
           $"{Value}: {Column( untyped, Value )}",
           ", "))
   

Пустые значения

Учитывая следующую строку JSON в переменной с именем JsonString

{ "text": "text value" , "number": 567, "empty": null }

1. Попытка доступа к несуществующим полям возвращает Blank(). Следующая формула возвращает значение true:

   IsBlank( Column( ParseJSON( JsonString ), "does not exist" ) )
   

2. Значения JSON null считаются Пустыми. Следующая формула возвращает значение true:

   IsBlank( Column( ParseJSON( JsonString ), "empty" ) )
   

Не записи

Column Вызов функций с ColumnNames динамическими значениями, которые не представляют записи, возвращают ошибку. Все эти выражения в следующем списке являются ошибочными: