Funktionerne ColumnNames og Column

Artikel
03/22/2024

Gælder for: Lærred-apps Modeldrevne apps Power Platform CLI

Henter kolonnenavne og værdier fra en objektdatatype uden type

Beskrivelse

Funktionen ColumnNames returnerer navnene på alle kolonner fra en post uden type og returnerer en tabel med alle navnene fra den pågældende post.

Funktionen Column returnerer værdien for en egenskab fra en post uden type med det givne kolonnenavn. Værdien returneres som et objekt uden type.

Funktionerne ColumnNames og Column returnerer fejl, hvis objektet uden type ikke repræsenterer en post (det vil sige, hvis det repræsenterer en tabel eller en skalarværdi eller primitiv værdi).

Syntaks

ColumnNames( UntypedRecord )

UntypedRecord – påkrævet. Et objekt uden type, der repræsenterer en post.

Column( UntypedRecord, ColumnName )

UntypedRecord – påkrævet. Et objekt uden type, der repræsenterer en post.
ColumnName – påkrævet. Navnet på den kolonne, der skal hentes fra den angivne post.

Eksempler

Adgang til feltværdier

Givet følgende JSON-streng i en variabel med navnet JsonString

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

Følgende formel returnerer en tabel med en enkelt kolonne med en Value-kolonne, der indeholder følgende værdier: "navn", "udfyldning":
```
ColumnNames( ParseJSON( JsonString ) )
```
Følgende formel returnerer tallet 737000:
```
Value( Column( ParseJSON( JsonString ), "population" ) )
```
2.1. Bemærk, at dette svarer til operatoren . for poster uden type, men kolonnenavnet behøver ikke at være kendt på forhånd.

Følgende formel returnerer tekstværdien "name: Seattle, population: 737000":

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

Blanke værdier

Givet følgende JSON-streng i en variabel med navnet JsonString

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

Forsøg på at få adgang til ikke-eksisterende felter returnerer Blank(). Følgende formel returnerer true:
```
IsBlank( Column( ParseJSON( JsonString ), "does not exist" ) )
```
JSON null-værdier betragtes som Blank(). Følgende formel returnerer true:
```
IsBlank( Column( ParseJSON( JsonString ), "empty" ) )
```

Ikke-poster

Hvis du kalder funktionerne Column eller ColumnNames med objekter uden type, der ikke repræsenterer poster, returneres der en fejl. Alle disse udtryk nedenfor er forkerte:

Formel	Årsag til fejl
ColumnNames( ParseJSON ( "[1, 2, 3]" ) )	Objekt uden type repræsenterer en matrix
Column( ParseJSON ( "23.45" ), "Value" )	Objekt uden type repræsenterer et tal
ColumnNames( ParseJSON ( """hello""" ) )	Objekt uden type repræsenterer en tekst
Column( ParseJSON ( "{""a"":false}" ).a, "a" )	Objekt uden type repræsenterer en boolesk værdi

Share via