Del via


Funksjonene ColumnNames og Column

Gjelder: Lerretsapper Modelldrevne apper Power Platform CLI

Henter kolonnenavn og verdier fra et typeløst objekt.

Bekrivelse

ColumnNames-funksjonen returnerer navnene på alle kolonner fra en typeløs oppføring, og returnerer en tabell med alle navnene fra den oppføringen.

Column-funksjonen returnerer verdien for en egenskap fra en typeløs oppføring inn, med det angitte kolonnenavnet. Verdien returneres som et typeløst objekt.

Funksjonene ColumnNames og Column returnerer feil hvis det typeløse objektet representerer en oppføring (det vil si hvis det representerer en tabell, en skalarverdi eller primitiv verdi).

Syntaks

ColumnNames( UntypedRecord )

  • UntypedRecord – Obligatorisk. Et typeløst objekt som representerer en oppføring.

Column( UntypedRecord, ColumnName )

  • UntypedRecord – Obligatorisk. Et typeløst objekt som representerer en oppføring.
  • ColumnName - obligatorisk. Navnet på kolonnen som skal hentes fra den angitte oppføringen.

Eksempler

Tilgang til feltverdier

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

{ "name": "Seattle", "population": 737000 }
  1. Følgende formel returnerer en tabell med én kolonne med en Value-kolonne som inneholder følgende verdier: "navn", "populasjon":

    ColumnNames( ParseJSON( JsonString ) )
    
  2. Følgende formel returnerer tallet 737000:

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

    2.1. Legg merke til at dette ligner på .-operatoren for typeløse oppføringer, men kolonnenavnet trenger ikke å være kjent på forhånd.

  3. Følgende formel returnerer tekstverdien "name: Seattle, population: 737000":

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

Mellomrom

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

{ "text": "text value" , "number": 567, "empty": null }
  1. Hvis du prøver å få tilgang til felter som ikke finnes, returneres Tom(). Følgende formel returnerer true:
    IsBlank( Column( ParseJSON( JsonString ), "does not exist" ) )
    
  2. JSON null-verdier regnes som Blank(). Følgende formel returnerer true:
    IsBlank( Column( ParseJSON( JsonString ), "empty" ) )
    

Ikke-oppføringer

Hvis du kaller funksjonene Column eller ColumnNames med typeløse objekter som ikke representerer oppføringer, returneres en feil. Alle uttrykkene nedenfor er feil:

Formel Årsak til feilen
ColumnNames( ParseJSON ( "[1, 2, 3]" ) ) Typeløst objekt representerer en matrise
Column( ParseJSON ( "23.45" ), "Value" ) Typeløst objekt representerer et tall
ColumnNames( ParseJSON ( """hello""" ) ) Typeløst objekt representerer en tekst
Column( ParseJSON ( "{""a"":false}" ).a, "a" ) Typeløst objekt representerer en boolsk verdi