ColumnNames- ja Sarake-funktiot

Artikkeli
10/16/2024

Koskee seuraavia: Pohjaan perustuvat sovellukset Mallipohjaisten sovellusten 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 }

Seuraava kaava palauttaa yhden sarakkeen taulukon, jossa on seuraavat arvot sisältävä Value-sarake: "name", "population":
```
ColumnNames( ParseJSON( JsonString ) )
```
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.

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 }

Jos muita kuin kenttiä yritetään käyttää, palautetaan arvo Tyhjä (). Seuraava kaava palauttaa arvon true:
```
IsBlank( Column( ParseJSON( JsonString ), "does not exist" ) )
```
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
Sarake( ParseJSON ( "23.45" ), "Arvo" )	Tyypittämätön objekti esittää numeroa
ColumnNames( ParseJSON ( ""hei"") )	Tyypittämätön objekti esittää tekstiä
Sarake( ParseJSON ( "{""a"":false}" ).a, "a" )	Tyypittämätön objekti esittää totuusarvoa

Jaa