ColumnNamesfunciones y Column

Se aplica a: Aplicaciones de lienzo Copilot Studio Aplicaciones controladas por modelos de funciones de Dataverse de la CLI de Power Platform

Recupera los nombres de columna y los valores de un valor dinámico.

Descripción

La ColumnNames función devuelve los nombres de todas las columnas de un registro dinámico, devolviendo una tabla con todos los nombres de ese registro.

La Column función devuelve el valor de una propiedad de un registro dinámico con el nombre de columna especificado. El valor se devuelve como un valor dinámico.

Las ColumnNames funciones y Column devuelven errores si el valor dinámico no representa un registro (es decir, si representa una tabla o un valor escalar o primitivo).

Sintaxis

ColumnNames( DynamicRecord )

• DynamicRecord : obligatorio. Valor dinámico que representa un registro.

Column( DynamicRecord, ColumnName )

• DynamicRecord : obligatorio. Valor dinámico que representa un registro.
• ColumnName - Obligatorio. El nombre de la columna que se recuperará del registro dado.

Ejemplos

Acceso a valores de campos

Dada la siguiente cadena JSON en una variable llamada JsonString

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

1. La siguiente fórmula devuelve una tabla de una sola columna con una columna Value que contiene los siguientes valores: "nombre", "población":

   ColumnNames( ParseJSON( JsonString ) )
   

2. La fórmula siguiente devuelve el número 737000:

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

   • Tenga en cuenta que esta fórmula es similar al . operador para los registros dinámicos, pero el nombre de columna no tiene que conocerse de antemano.

3. La fórmula siguiente devuelve el valor de texto "name: Seattle, population: 737000":

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

Valores en blanco

Dada la siguiente cadena JSON en una variable llamada JsonString

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

1. El intento de acceder a campos no existentes devuelve Blank(). La fórmula siguiente devuelve true:

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

2. Los valores JSON null se consideran Blank(). La fórmula siguiente devuelve true:

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

No registros

Llamar a las Column funciones o ColumnNames con valores dinámicos que no representan registros devuelven un error. Todas esas expresiones de la lista siguiente son erróneas: