ColumnNames- ja Sarake-funktiot

Koskee seuraavia: Pohjaan perustuvat sovellukset Mallipohjaiset sovellukset Power Platform CLI

Noutaa sarakkeiden nimet ja arvot tyypittämättömästä objektista.

Kuvaus

ColumnNames-funktio palauttaa kaikkien sarakkeiden nimet tyypittämättömästä tietueesta ja palauttaa taulukon, jossa on kaikki tietueen nimet.

Sarake-funktio palauttaa ominaisuuden arvon tyypittämättömästä tietueesta, jolla on annettu sarakkeen nimi. Arvo palautetaan tyypittämättömänä objektina.

ColumnNames- ja Sarake-funktiot palauttavat virheitä, jos tyypittämätön objekti ei edusta tietuetta (eli taulukkoa, skalaavaa tai alkeista arvoa).

Syntaksi

ColumnNames( UntypedRecord )

• UntypedRecord – Pakollinen. Tyypittämätön objekti, joka edustaa tietuetta.

Sarake( UntypedRecord, ColumnName )

• UntypedRecord – Pakollinen. Tyypittämätön objekti, joka edustaa tietuetta.
• ColumnName – Pakollinen. Annetusta tietueesta noudettavan sarakkeen nimi.

Esimerkkejä

Kenttäarvojen käyttäminen

Jos seuraava JSON-merkkijono on muuttujassa nimeltään JsonString

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

1. Seuraava kaava palauttaa yhden sarakkeen taulukon, jossa on seuraavat arvot sisältävä Value-sarake: "name", "population":

   ColumnNames( ParseJSON( JsonString ) )
   

2. Seuraava kaava palauttaa numeron 737000:

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

   2.1. Huomaa, että tämä on samanlainen kuin . operaattori, joka käyttää tyypittämättömiä tietueita, mutta sarakkeen nimeä ei tarvitse tietää aiemmin.

3. Seuraava kaava palauttaa tekstiarvon "name: Seattle, population: 737000":

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

Tyhjät arvot

Jos seuraava JSON-merkkijono on muuttujassa nimeltään JsonString

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

1. Jos muita kuin kenttiä yritetään käyttää, palautetaan arvo Tyhjä (). Seuraava kaava palauttaa arvon true:

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

2. JSON:n null-arvojen tulkitaan olevan Blank(). Seuraava kaava palauttaa arvon true:

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

Ei-tietueet

Kun Sarake- tai ColumnNames-funktioita, joissa on tyypittämättömiä objekteja kutsutaan toiminnoille, joiden objektit eivät vastaa tietueita, palauttavat virheen. Kaikki alla olevat lausekkeet ovat virheellisiä:

Kaava	Virheen syy
ColumnNames( ParseJSON ( "[1, 2, 3]" ) )	Tyypittämätön objekti esittää matriisia
Column( ParseJSON ( "23.45" ), "Value" )	Tyypittämätön objekti esittää numeroa
ColumnNames( ParseJSON ( """hello""" ) )	Tyypittämätön objekti esittää tekstiä
Column( ParseJSON ( "{""a"":false}" ).a, "a" )	Tyypittämätön objekti esittää totuusarvoa