ColumnNames i funcions de columna

S'aplica a: Aplicacions de llenç CLI d'aplicacions Power Platform basades en models

Recupera els noms i els valors de les columnes d'un objecte sense tipus.

Descripció

La funció ColumnNames retorna els noms de totes les columnes d'un registre sense tipar, retornant una taula amb tots els noms d'aquest registre.

La funció Column retorna el valor d'una propietat d'un registre sense escriure amb el nom de columna donat. El valor es retorna com un objecte sense tipus.

Les funcions ColumnNames i Column retornen errors si l'objecte sense tipus no representa un registre (és a dir, si representa una taula o un valor escalar o primitiu).

Sintaxi

ColumnNames( UntypedRecord )

• UntypedRecord : obligatori. Un objecte sense tipus que representa un registre.

Columna(UntypedRecord,ColumnName )

• UntypedRecord : obligatori. Un objecte sense tipus que representa un registre.
• ColumnName : obligatori. Nom de la columna que s'ha de recuperar del registre donat.

Exemples

Accedir als valors de camp

A partir de la següent cadena JSON en una variable anomenada JsonString

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

1. La fórmula següent retorna una taula d'una sola columna amb una columna Value que conté els valors següents: "name", "population":

   ColumnNames( ParseJSON( JsonString ) )
   

2. La fórmula següent retorna el número 737000:

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

   2.1. Tingueu en compte que això és similar a l'operador . per als registres sense tipar, però el nom de la columna no s'ha de conèixer prèviament.

3. La fórmula següent retorna el valor "name: Seattle, population: 737000" de text:

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

Buits

A partir de la següent cadena JSON en una variable anomenada JsonString

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

1. L'intent d'accedir a camps inexistents retorna Blank(). La fórmula següent retorna true:

   IsBlank( Column( ParseJSON( JsonString ), "does not exist" ) )
   

2. Els valors JSON null es consideren Blank(). La fórmula següent retorna true:

   IsBlank( Column( ParseJSON( JsonString ), "empty" ) )
   

No registres

La crida a les funcions Column o ColumnNames amb objectes sense escriure que no representen registres retorna un error. Totes aquestes expressions següents són errònies:

Fórmula	Motiu de l'error
ColumnNames( ParseJSON ( "[1, 2, 3]" ) )	Objecte sense tipus representa una matriu
columna( parseJSON ( "23.45" ), "valor" )	Objecte sense tipus representa un nombre
ColumnNames( ParseJSON ( """"hola""" ) )	Objecte sense tipus representa un text
Columna( ParseJSON ( "{""a"":false}" ).a, "a" )	Objecte sense tipus representa un valor booleà