ColumnNames and Column-functies

Artikel
10/16/2024

Van toepassing op: Canvas-apps Modelgestuurde apps Power Platform CLI

Haalt kolomnamen en waarden op uit een niet-getypeerd object.

Omschrijving

De functie ColumnNames retourneert de namen van alle kolommen uit een niet-getypeerd record en retourneert een tabel met alle namen uit dat record.

De functie Column retourneert de waarde van een eigenschap uit een niet-getypeerd record met de opgegeven kolomnaam. De waarde wordt geretourneerd als een niet-getypeerd object.

De functies ColumnNames en Column retourneren fouten als het niet-getypeerde object geen record vertegenwoordigt (dat wil zeggen, als het een tabel of een scalaire of primitieve waarde vertegenwoordigt).

Syntaxis

Kolomnamen( UntypedRecord )

UntypedRecord – Vereist. Een niet-getypeerd object dat een record vertegenwoordigt.

Kolom( Niet-getypeerdeRecord, Kolomnaam )

UntypedRecord – Vereist. Een niet-getypeerd object dat een record vertegenwoordigt.
Kolomnaam - Verplicht. De naam van de kolom die uit het opgegeven record moet worden opgehaald.

Voorbeelden

Veldwaarden openen

Gegeven de volgende JSON-tekenreeks in een variabele met de naam JsonString

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

De volgende formule retourneert een tabel met één kolom met een Value-kolom die de volgende waarden bevat: "naam", "populatie":
```
ColumnNames( ParseJSON( JsonString ) )
```
Retourneert de volgende formule het getal 737000:
```
Value( Column( ParseJSON( JsonString ), "population" ) )
```
2.1. Merk op dat dit vergelijkbaar is met de .-operator voor niet-getypeerde records, maar de kolomnaam hoeft niet vooraf bekend te zijn.

De volgende formule retourneert de tekstwaarde "name: Seattle, population: 737000":

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

Lege waarden

Gegeven de volgende JSON-tekenreeks in een variabele met de naam JsonString

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

Bij een poging om toegang te krijgen tot niet-bestaande velden, wordt Blank() geretourneerd. De volgende formule retourneert true:
```
IsBlank( Column( ParseJSON( JsonString ), "does not exist" ) )
```
JSON null-waarden worden beschouwd als Blank(). De volgende formule retourneert true:
```
IsBlank( Column( ParseJSON( JsonString ), "empty" ) )
```

Niet-records

Het aanroepen van de functies Column of ColumnNames met niet-getypeerde objecten die geen records vertegenwoordigen, retourneert een fout. Al deze onderstaande uitdrukkingen zijn onjuist:

Formule	Reden van fout
Kolomnamen( ParseJSON( "[1, 2, 3]" ) )	Niet-getypeerd object dat een matrix representeert
Kolom( ParseJSON ("23.45"), "Waarde")	Niet-getypeerd object dat een nummer representeert
Kolomnamen( ParseJSON ( """hallo""" ) )	Niet-getypeerd object dat een tekst representeert
Kolom( ParseJSON( "{""a"":false}" ).a, "a" )	Niet-getypeerd object dat een booleaanse waarde representeert

Delen via