Споделяне чрез


ColumnNames и Column функции

Отнася се за: Приложения за платно Copilot Studio Приложения, управлявани от модели, функции Power Platform CLI Dataverse

Извлича имена на колони и стойности от динамична стойност.

Описание

Функцията 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 ( """hello""" ) Динамична стойност представя текст
Column( ParseJSON ( "{"a""":false}" ).a, "a" ) Динамична стойност представлява булева стойност