ColumnNames та функції ColumnNames та Column

Стаття
07/12/2024

Застосовується до: програм Canvas Програм Power Platform CLI на основі моделі

Отримує імена та значення стовпців з нетипізованого об’єкта.

Опис

Функція ColumnNames повертає імена всіх стовпців з невведеного запису, повертаючи таблицю з усіма іменами з цього запису.

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

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

Синтаксис

ColumnNames( UntypedRecord )

UntypedRecord – обов’язковий. Tнетипізований об’єкт , який представляє запис.

Column(UntypedRecord,ColumnName )

UntypedRecord – обов’язковий. Tнетипізований об’єкт , який представляє запис.
ColumnName — обов'язковий аргумент. Ім’я стовпця, який потрібно отримати з даного запису.

Приклади

Доступ до значень полів

З огляду на наступний рядок JSON у змінної з іменем JsonString

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

Наступна формула повертає таблицю з одним стовпцем зі Value стовпцем, що містить такі значення: "назва", "населення":
```
ColumnNames( ParseJSON( JsonString ) )
```
Наступна формула повертає число 737000:
```
Value( Column( ParseJSON( JsonString ), "population" ) )
```
2.1. Зауважте, що цей параметр схожий на . оператор для невведених записів, але ім’я стовпця не обов’язково знати заздалегідь.

Наступна формула повертає текстове значення "name: Seattle, population: 737000":

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

Пусті значення

З огляду на наступний рядок JSON у змінної з іменем JsonString

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

Спроба отримати доступ до неіснуючих полів повертає Blank(). Наведена нижче формула повертає такий результат true:
```
IsBlank( Column( ParseJSON( JsonString ), "does not exist" ) )
```
Значення JSON null вважаються Blank(). Наведена нижче формула повертає такий результат true:
```
IsBlank( Column( ParseJSON( JsonString ), "empty" ) )
```

Нерекорди

Виклик функцій «Стовпець» або «Імена стовпців» з невведеними об’єктами, які не представляють записи, повертає помилку. Всі наведені нижче вирази помилкові:

Формула	Причина помилки
ColumnNames( ParseJSON ( "[1, 2, 3]" ) )	нетипізований об’єкт представляє масив
column( ParseJSON ( "23.45" ), "Value" )	нетипізований об’єкт представляє число
ColumnNames( ParseJSON ( """привіт""" )	нетипізований об’єкт являє собою текст
Column( ParseJSON ( "{""a"":false}" ).a, "a" )	нетипізований об’єкт представляє логічний значення

Поділитися через