ColumnNames і Column функції

Застосовується до: Програми Canvas Copilot Studio Model-driven apps Power Platform CLI Dataverse functions

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

Опис

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

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

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

Синтаксис

ColumnNames( Динамічний запис )

Column( DynamicRecord, ColumnName )

  • DynamicRecord – обов'язковий аргумент. Динамічне значення, яке представляє запис.
  • ColumnName - обов’язковий. Ім’я стовпця, який потрібно отримати з заданого запису.

Приклади

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

З огляду на наступний рядок 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 вважаються Blank(). Наведена нижче формула повертає такий результат true: 
    IsBlank( Column( ParseJSON( JsonString ), "empty" ) )

Незаписи

Column Виклики або ColumnNames функції з динамічними значеннями, які не представляють записи, повертають помилку. Усі ці вирази в наведеному нижче списку помилкові:

Формула Причина помилки
ColumnNames( ParseJSON ( "[1, 2, 3]" ) Динамічне значення позначає масив
Column( ParseJSON ( "23.45" ), "Value" ) Динамічне значення позначає число
ColumnNames( ParseJSON ( ""привіт""" ) ) Динамічне значення позначає текст
Column( ParseJSON ( "{"a":false}" ).a, "a" ) Динамічне значення позначає логічне значення
  • Last updated on