ColumnNames un Column funkcijas

Attiecas uz: Audekla programmas Copilot Studio Modeļa vadītas programmas Power Platform CLI Dataverse funkcijas

Izgūst kolonnu nosaukumus un vērtības no dinamiskās vērtības.

Apraksts

Funkcija ColumnNames atgriež visu dinamiskā ieraksta kolonnu nosaukumus, atgriežot tabulu ar visiem šī ieraksta nosaukumiem.

Funkcija Column atgriež rekvizīta vērtību no dinamiskā ieraksta ar norādīto kolonnas nosaukumu. Vērtība tiek atgriezta kā dinamiska vērtība.

Funkcijas and ColumnNamesColumn atgriež kļūdas, ja dinamiskā vērtība neatspoguļo ierakstu (t.i., ja tā apzīmē tabulu vai skalāru vai primitīvu vērtību).

Sintakse

ColumnNames( DynamicRecord )

• DynamicRecord — obligāts. Dinamiska vērtība, kas apzīmē ierakstu.

Column( DynamicRecord, ColumnName )

• DynamicRecord — obligāts. Dinamiska vērtība, kas apzīmē ierakstu.
• ColumnName- obligāts. No dotā ieraksta izgūstamās kolonnas nosaukums.

Piemēri

Piekļuve lauka vērtībām

Ņemot vērā šādu JSON virkni mainīgajā ar nosaukumu JsonString

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

1. Šī formula atgriež vienas kolonnas Value tabulu ar kolonnu, kurā ir šādas vērtības: "name", "population":

   ColumnNames( ParseJSON( JsonString ) )
   

2. Tālāk sniegtā formula atgriež skaitli 737000:

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

   • Ņemiet vērā, ka šī formula ir līdzīga dinamisko .ierakstu operatoram, taču kolonnas nosaukumam nav jābūt iepriekš zināmam.

3. Tālāk sniegtā formula atgriež teksta vērtību "name: Seattle, population: 737000":

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

Tukšs

Ņemot vērā šādu JSON virkni mainīgajā ar nosaukumu JsonString

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

1. Mēģinot piekļūt neeksistējošiem laukiem, tiek atgriezts Tukšs(). Formula atgriež true:

   IsBlank( Column( ParseJSON( JsonString ), "does not exist" ) )
   

2. JSON null vērtības tiek uzskatītas par Blank(). Formula atgriež true:

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

Nerekordi

Izsaucot Column funkcijas or ColumnNames ar dinamiskām vērtībām, kas neatspoguļo ierakstus, tiek atgriezta kļūda. Visi šie izteicieni šajā sarakstā ir kļūdaini:

Formula	Kļūdas iemesls
ColumnNames( ParseJSON ( "[1, 2, 3]" ) ) )	Dinamiskā vērtība apzīmē masīvu
Column( ParseJSON ( "23.45" ), "Vērtība" )	Dinamiskā vērtība apzīmē skaitli
ColumnNames( ParseJSON ( """sveiki""" ) )	Dinamiskā vērtība apzīmē tekstu
Column( ParseJSON ( "{""a"":false}" ).a, "a" )	Dinamiskā vērtība ir Būla vērtība