ColumnNames a Column funkce

Platí pro: Aplikace plátna Copilot Studio Modelem řízené aplikacemi Power Platform CLI – funkce Dataverse

Načte názvy sloupců a hodnoty z dynamické hodnoty.

Popis

Funkce ColumnNames vrátí názvy všech sloupců z dynamického záznamu a vrátí tabulku se všemi názvy z tohoto záznamu.

Funkce Column vrátí hodnotu vlastnosti z dynamického záznamu s daným názvem sloupce. Hodnota se vrátí jako dynamická hodnota.

Funkce ColumnNames vrací chyby, pokud dynamická hodnota nepředstavuje záznam (to znamená, že představuje tabulku nebo skalární nebo primitivní Column hodnotu).

Syntaxe

ColumnNames( Dynamickýzáznam )

• Dynamickýzáznam – povinné. Dynamická hodnota, která představuje záznam.

Column( DynamicRecord, ColumnName )

• Dynamickýzáznam – povinné. Dynamická hodnota, která představuje záznam.
• ColumnName – 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 }

1. 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 ) )
   

2. Následující vzorec vrátí číslo 737000:

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

   • Všimněte si, že tento vzorec je podobný operátoru .dynamických záznamů, ale název sloupce nemusí být předem znám.

3. 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 }

1. 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" ) )
   

2. Hodnoty JSON null se považují za Blank(). Následující vzorec vrátí true:

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

Bez záznamů

Column Volání nebo ColumnNames funkce s dynamickými hodnotami, které nepředstavují záznamy, vrací chybu. Všechny tyto výrazy v následujícím seznamu jsou chybné:

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