ParseJSON Función

Se aplica a: Aplicaciones de lienzo Copilot Studio Aplicaciones controladas por modelos de Power Platform Funciones de Power Platform Dataverse Power Pages

Interpreta una cadena JSON y devuelve un valor dinámico o un valor con tipo específico si se proporciona un tipo.

Description

La ParseJSON función analiza una cadena JSON válida y devuelve un valor dinámico que representa la estructura JSON.

Opcionalmente, use el segundo argumento para convertir el JSON en un objeto con tipo que se pueda usar directamente en las fórmulas Power Fx. Esto hace que el resultado sea más fácil de consumir, ya que ya no se requieren conversiones ni coerciones en el punto de uso. El JSON sin tipo se asigna al tipo con estas reglas:

• Las columnas del tipo que no están presentes en el JSON se rellenan con espacios en blanco.
• Las columnas del JSON que no están presentes en el tipo se omiten.
• Para las columnas que están en el tipo y en el JSON, el valor JSON debe poder ser convertido al tipo.

La ParseJSON función puede devolver errores si el texto no es válido JSON según el formato de notación de objetos JavaScript (JSON) descrito en ECMA-404 e IETF RFC 8259.

Sintaxis

ParseJSON( JSONString [ , Type ] )

• JSONString: requerido. La estructura JSON representada como texto.
• Tipo - opcional. La definición de tipo de Power Fx para la estructura JSON. Sin este argumento, ParseJSON devuelve un valor dinámico; con ella, la función devuelve un valor con tipo específico.

Conversión de valores dinámicos

Sin el segundo argumento, ParseJSON devuelve un valor Dinámico que requiere la conversión explícita de valores de campo en tipos de datos admitidos. La siguiente tabla enumera los tipos de datos en Power Apps, un tipo de datos JSON correspondiente y cómo convertirlo.

Ejemplos

Acceso a valores de campos

Dada la siguiente cadena JSON en una variable llamada JsonString

{ "parent": { "child": "text value" }, "number": 567 }

1. La fórmula siguiente devuelve el texto text value:

   Text( ParseJSON( JsonString ).parent.child )
   

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

   Value( ParseJSON( JsonString ).number )
   

En caso de que el nombre de un campo consista en un nombre de identificador no válido, puede poner los nombres de los campos entre comillas simples. Dada la siguiente cadena JSON en una variable llamada JsonString

{ "0": { "child-field": "text value" } }

1. La fórmula siguiente devuelve el texto text value:

   Text( ParseJSON( JsonString ).'0'.'child-field' )
   

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( Text( ParseJSON( JsonString ).parent.child ) )
   

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

   IsBlank( Text( ParseJSON( JsonString ).empty ) )
   

Matrices simples

Dada la siguiente cadena JSON en una variable llamada JsonString

{ "array": [1, 2, 3] }

1. Obtener acceso al segundo número de la tabla de columna única del campo de matriz de valores dinámicos y convertir en un número mediante Value() devuelve 2:

   Value( Index( ParseJSON( JsonString ).array, 2 ) )
   

2. Convertir la tabla de una sola columna de valores dinámicos en el campo de matriz, en una sola tabla de columnas { Value: 1 }, { Value: 2 }, { Value: 3 }de números :

   ForAll( ParseJSON( JsonString ).array, Value( ThisRecord ) )
   

Matrices de registros

Dada la siguiente cadena JSON en una variable llamada JsonString

{ "array": [
    { "id": 1, "name": "One"},
    { "id": 2, "name": "Two"}
    ] }

1. La conversión a una tabla con tipo de registros directamente con ForAll() se puede realizar mediante ThisRecord.[fieldname] para acceder a campos dinámicos y convertirlos a tipos específicos:

   ForAll( ParseJSON( JsonString ).array, { id: Value(ThisRecord.id), name: Text(ThisRecord.name) })
   

Matriz a tabla

1. La conversión de valores dinámicos en una tabla mediante la función Table() da como resultado una tabla de una sola columna de valores dinámicos . Se debe entonces acceder al objeto usando la columna Value (única) y convertirlo en tipos como se explicó anteriormente.

Dada la siguiente cadena JSON en una variable llamada JsonString

{ "array": [1, 2, 3] }

Table() devuelve una tabla de una sola columna de valores dinámicos con un valor de columna única para el número de la matriz...

 Set(untypedTable, Table( ParseJSON( JsonString ).array ));
 
 Value( Index(untypedTable, 1).Value.Value )
 ```

Given the following JSON string in a variable named `JsonString`
```JSON
{ "array": [
 { "id": 1, "name": "One"},
 { "id": 2, "name": "Two"}
 ] }

Table() devuelve una tabla de una sola columna de valores dinámicos que representa cada objeto json de la matriz.

  Set(untypedTable, Table( ParseJSON( JsonString ).array ) );
  
  Text( Index(untypedTable, 1).Value.name )