ColumnNames ir Column funkcijos

Taikoma: "Canvas apps Copilot Studio Model", pagrįstos " Power Platform CLI Dataverse" funkcijomis

Nuskaito stulpelių pavadinimus ir reikšmes iš dinaminės reikšmės.

Aprašą

Funkcija ColumnNames grąžina visų stulpelių pavadinimus iš dinaminio įrašo, pateikia lentelę su visais to įrašo pavadinimais.

Funkcija Column pateikia ypatybės reikšmę iš dinaminio įrašo su pateiktu stulpelio pavadinimu. Reikšmė grąžinama kaip dinaminė reikšmė.

Funkcijos ColumnNames ir Column pateikia klaidas, jei dinaminė reikšmė nenurodo įrašo (t. y. jei jis nurodo lentelę arba skaliarinę ar primityviąją reikšmę).

Sintaksė

ColumnNames( DynamicRecord )

• DynamicRecord – būtinas. Dinaminė reikšmė, nurodanti įrašą.

Column( DynamicRecord, ColumnName )

• DynamicRecord – būtinas. Dinaminė reikšmė, nurodanti įrašą.
• ColumnName - būtinas. Stulpelio, kuris turi būti nuskaitytas iš duoto įrašo, pavadinimas.

Pavyzdžiai

Prieiga prie laukų reikšmių

Kintamajame pateikiama ši JSON eilutė pavadinimu JsonString

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

1. Toliau pateikta formulė pateikia vieno stulpelio lentelę su Value stulpeliu, kuriame yra šios reikšmės: "pavadinimas", "populiacija":

   ColumnNames( ParseJSON( JsonString ) )
   

2. Toliau pateikta formulė pateikia skaičių 737000:

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

   • Atkreipkite dėmesį, kad ši formulė panaši į .dinaminių įrašų operatorių, tačiau stulpelio pavadinimo iš anksto žinoti nereikia.

3. Toliau pateikta formulė pateikia teksto reikšmę "name: Seattle, population: 737000":

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

Tuščios reikšmės

Kintamajame pateikiama ši JSON eilutė pavadinimu JsonString

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

1. Bandant prieiti prie neegzistuojančių laukų, pateikiama Blank(). Ši formulė pateikia true:

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

2. JSON null reikšmės laikomos Blank(). Ši formulė pateikia true:

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

Neįrašai

Column Iškviečiant arba ColumnNames funkcijas su dinaminėmis reikšmėmis, kurios neatspindi įrašų, pateikiama klaida. Visi šie reiškiniai toliau pateiktame sąraše yra klaidingi:

Formulė	Klaidos priežastis
ColumnNames( ParseJSON ( "[1, 2, 3]" ) )	Dinaminė reikšmė nurodo masyvą
Column( ParseJSON ( "23.45" ), "Value" )	Dinaminė reikšmė nurodo skaičių
ColumnNames( ParseJSON ( ""labas"" ) )	Dinaminė reikšmė nurodo tekstą
Column( ParseJSON ( "{"a":false}" ).a, "a" )	Dinaminė reikšmė nurodo Bulio logikos reikšmę