ColumnNames és Column függvények

A következőkre vonatkozik: Vászonalapú alkalmazások Modellvezérelt alkalmazások Power Platform CLI

Oszlopneveket és -értékeket olvas be egy be nem írt objektum.

Description

A ColumnNames függvény egy nem beírt rekord összes oszlopának nevét adja vissza, és egy olyan táblát ad vissza, amely az adott rekord összes nevét tartalmazza.

A Column függvény egy tulajdonság értékét adja vissza egy nem típusos rekordból a megadott oszlopnévvel. Az értéket a rendszer an be nem írt objektum ként adja vissza.

A ColumnNames és a Column függvény hibákat ad vissza, ha a be nem írt objektum nem rekordot képvisel (azaz táblát, skaláris vagy primitív értéket képvisel).

Szintaxis

ColumnNames( UntypedRecord )

• UntypedRecord – Kötelező. Egy be nem írt objektum , amely egy rekordot képvisel.

Column(UntypedRecord,ColumnName )

• UntypedRecord – Kötelező. Egy be nem írt objektum , amely egy rekordot képvisel.
• ColumnName – Kötelező. Az adott rekordból beolvasandó oszlop neve.

Példák

Mezőértékekhez való hozzáférés

Vegyük a következő JSON-sztringet egy JsonString nevű változóban

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

1. A következő képlet egy egyoszlopos táblázatot ad vissza egy Value oszloppal, amely a következő értékeket tartalmazza: "név", "népesség":

   ColumnNames( ParseJSON( JsonString ) )
   

2. A következő képlet a számot 737000 adja eredményül:

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

   2.1. Figyelje meg, hogy ez hasonló a . nem gépelt rekordok operátorához, de az oszlop nevét nem kell előzetesen ismerni.

3. A következő képlet a szöveges értéket "name: Seattle, population: 737000" adja eredményül:

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

Üres értékek

Vegyük a következő JSON-sztringet egy JsonString nevű változóban

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

1. A nem létező mezők elérésének megkísérlése a Blank() függvényt adja vissza. Az alábbi képlet visszaadott értéke true:

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

2. A null JSON-értékek Blank() értékeknek minősülnek. Az alábbi képlet visszaadott értéke true:

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

Nem rekordok

A Column vagy a ColumnNames függvények nem típusos objektumokkal való hívása, amelyek nem rekordokat képviselnek, hibát ad vissza. Az alábbi kifejezések mindegyike hibás:

Képlet	A hiba oka
ColumnNames( ParseJSON ( "[1, 2, 3]" ) )	Be nem írt objektum tömböt jelöl
Column( ParseJSON ( "23.45" ), "Value" )	Be nem írt objektum egy számot jelöl
ColumnNames( ParseJSON ( """hello""" ) )	Be nem írt objektum szöveget jelöl
Column( ParseJSON ( "{""a"":false}" ).a, "a" )	Be nem írt objektum logikai értéket képvisel