ColumnNames and Column-functies

  • Artikel

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

ColumnNames( UntypedRecord )

Column( UntypedRecord, ColumnName )

  • UntypedRecord: vereist. Een niet-getypeerd object dat een record vertegenwoordigt.
  • ColumnName: vereist. 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 }

  1. De volgende formule retourneert een tabel met één kolom met een Value-kolom die de volgende waarden bevat: "naam", "populatie":

    ColumnNames( ParseJSON( JsonString ) )

  2. 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.

  3. 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 }
  1. 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" ) )
  2. 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
ColumnNames( ParseJSON ( "[1, 2, 3]" ) ) Niet-getypeerd object dat een matrix representeert
Column( ParseJSON ( "23,45" ), "Waarde" ) Niet-getypeerd object dat een nummer representeert
ColumnNames( ParseJSON ( """hallo""" ) ) Niet-getypeerd object dat een tekst representeert
Column( ParseJSON ( "{""a"":false}" ).a, "a" ) Niet-getypeerd object dat een booleaanse waarde representeert