ColumnNames és Column függvények

A következőkre vonatkozik: Vászonalapú alkalmazások Copilot Studio Modellalapú alkalmazások Power Platform CLI Dataverse-függvények

Oszlopneveket és értékeket kér le egy dinamikus értékből.

Description

A ColumnNames függvény egy dinamikus rekord összes oszlopának nevét adja vissza, és visszaad egy táblát, amelyen az adott rekord összes neve szerepel.

A Column függvény egy tulajdonság értékét adja vissza egy adott oszlopnévvel rendelkező dinamikus rekordból . Az érték dinamikus értékként lesz visszaadva.

A ColumnNames függvények Column akkor adnak vissza hibákat, ha a dinamikus érték nem egy rekordot jelöl (vagyis ha egy táblát, skaláris vagy primitív értéket jelöl).

Szintaxis

ColumnNames( DynamicRecord )

Column( DynamicRecord, ColumnName )

  • DynamicRecord – Kötelező. Egy rekordot jelképező dinamikus érték .
  • 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" ) )
    
    • Figyelje meg, hogy ez a képlet hasonlít a .dinamikus rekordok operátorához, de az oszlop nevét nem kell előre 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

Column A rekordokat nem képviselő dinamikus értékekkel rendelkező vagy ColumnNames függvények meghívása hibaüzenetet ad vissza. Az alábbi listában szereplő kifejezések mindegyike hibás:

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