Funkce ColumnNames a Column

Článek
03/22/2024

Platí pro: aplikace plátna modelem řízené aplikace rozhraní příkazového řádku Power Platform

Načte názvy sloupců a hodnoty z netypového objektu.

Popis

Funkce ColumnNames vrací názvy všech sloupců z netypového záznamu a vrátí tabulku se všemi jmény z daného záznamu.

Funkce Column vrací hodnotu vlastnosti z netypového záznamu s daným názvem sloupce. Hodnota je vrácena jako netypový objekt.

Funkce ColumnNames a Column vrací chyby, pokud netypový objekt nepředstavuje záznam (tj. pokud představuje tabulku nebo skalární či primitivní hodnotu).

Syntaxe

ColumnNames( UntypedRecord )

UntypedRecord – Povinné. Netypový objekt představující záznam.

Column( UntypedRecord, ColumnName )

UntypedRecord – Povinné. Netypový objekt představující záznam.
NázevSloupce – povinné. Název sloupce, který má být z daného záznamu načten.

Příklady

Přístup k hodnotám polí

Když máme následující řetězec JSON v proměnné s názvem JsonString

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

Následující vzorec vrátí tabulku s jedním sloupcem se sloupcem Value obsahujícím následující hodnoty: "name", "population":
```
ColumnNames( ParseJSON( JsonString ) )
```
Následující vzorec vrátí číslo 737000:
```
Value( Column( ParseJSON( JsonString ), "population" ) )
```
2.1. Všimněte si, že se jedná o podobný operátor . pro netypové záznamy, ale název sloupce nemusí být znám předem.

Následující vzorec vrací hodnotu textu "name: Seattle, population: 737000":

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

Prázdné hodnoty

Když máme následující řetězec JSON v proměnné s názvem JsonString

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

Pokus o přístup k neexistujícím polím vrátí Blank(). Následující vzorec vrátí true:
```
IsBlank( Column( ParseJSON( JsonString ), "does not exist" ) )
```
Hodnoty JSON null se považují za Blank(). Následující vzorec vrátí true:
```
IsBlank( Column( ParseJSON( JsonString ), "empty" ) )
```

Bez záznamů

Volání funkcí Column nebo ColumnNames s objekty bez typu, které nepředstavují záznamy, vrátí chybu. Všechny níže uvedené výrazy jsou chybné:

Vzorec	Důvod chyby
ColumnNames( ParseJSON ( "[1, 2, 3]" ) )	Netypový objekt představuje pole
Column( ParseJSON ( "23.45" ), "Hodnota" )	Netypový objekt představuje číslo
ColumnNames( ParseJSON ( """hello""" ) )	Netypový objekt představuje text
Column( ParseJSON ( "{""a"":false}" ).a, "a" )	Netypový objekt představuje logickou hodnotu

Sdílet prostřednictvím