ColumnNames i Column funcions

S'aplica a: Aplicacions de llenç Copilot Studio Aplicacions basades en models CLI del Power Platform Funcions del Dataverse

Recupera els noms i els valors de les columnes d'un valor dinàmic.

Descripció

La ColumnNames funció retorna els noms de totes les columnes d'un registre dinàmic i retorna una taula amb tots els noms d'aquest registre.

La Column funció retorna el valor d'una propietat d'un registre dinàmic amb el nom de columna donat. El valor es retorna com a valor dinàmic.

Les ColumnNames funcions and Column retornen errors si el valor dinàmic no representa un registre (és a dir, si representa una taula o un valor escalar o primitiu).

Sintaxi

ColumnNames( Registre dinàmic )

• DynamicRecord : obligatori. Valor dinàmic que representa un registre.

Column( DynamicRecord, ColumnName )

• DynamicRecord : obligatori. Valor dinàmic 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" ) )
   

   • Tingueu en compte que aquesta fórmula és similar a l'operador . per als registres dinàmics, però no cal conèixer prèviament el nom de la columna.

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

En cridar les Column funcions or ColumnNames amb valors dinàmics que no representen registres, es retorna un error. Totes les expressions de la llista següent són errònies:

Fórmula	Motiu de l'error
ColumnNames( ParseJSON ( "[1, 2, 3]" ) )	El valor dinàmic representa una matriu
Column( ParseJSON ( "23.45" ), "Valor" )	El valor dinàmic representa un nombre
ColumnNames( ParseJSON ( """hola""" ) )	El valor dinàmic representa un text
Column( ParseJSON ( "{""a"":false}" ).a, "a" )	El valor dinàmic representa un valor booleà