ParseJSON Função

Aplica-se a: Aplicativos de tela Copilot Studio Aplicativos baseados em modelo Power Platform CLI Dataverse funções Power Pages

Interpreta uma cadeia de caracteres JSON e retorna um valor dinâmico ou um valor digitado específico se um tipo for fornecido.

Description

A ParseJSON função analisa uma cadeia de caracteres JSON válida e retorna um valor dinâmico que representa a estrutura JSON.

Como opção, use o segundo argumento para converter o JSON em um objeto tipado que pode ser usado diretamente em fórmulas do Power Fx. Isso torna o resultado mais fácil de consumir, pois conversões e coerções no ponto de uso não são mais necessárias. O JSON não tipado é mapeado para o tipo com estas regras:

• As colunas no tipo que não estão presentes no JSON são preenchidas com um espaço em branco.
• As colunas no JSON que não estão presentes no tipo são ignoradas.
• Colunas que estão no tipo e JSON, o valor JSON deve ser coercível para o tipo.

A ParseJSON função poderá retornar erros se o texto não for JSON válido de acordo com o formato JSON (JavaScript Object Notation) descrito em ECMA-404 e IETF RFC 8259.

Sintaxe

ParseJSON( JSONString [ , Tipo ] )

• JSONString – obrigatório. A estrutura JSON representada como texto.
• Tipo - Opcional. A definição do tipo de Power Fx para a estrutura JSON. Sem esse argumento, ParseJSON retorna um valor dinâmico; com ele, a função retorna um valor tipado específico.

Convertendo valores dinâmicos

Sem o segundo argumento, ParseJSON retorna um valor dinâmico que requer a conversão explícita de valores de campo em tipos de dados com suporte. A tabela a seguir lista os tipos de dados no Power Apps e um tipo de dados JSON correspondente e como convertê-los.

Exemplos

Acessar valores de campo

Considerando a seguinte cadeia de caracteres JSON em uma variável chamada JsonString

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

1. A fórmula a seguir retorna o texto text value:

   Text( ParseJSON( JsonString ).parent.child )
   

2. A fórmula a seguir retorna o número 567:

   Value( ParseJSON( JsonString ).number )
   

Caso um nome de campo consista em um nome de identificador inválido, você pode colocar os nomes dos campos entre aspas simples. Considerando a seguinte cadeia de caracteres JSON em uma variável chamada JsonString

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

1. A fórmula a seguir retorna o texto text value:

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

Em branco

Considerando a seguinte cadeia de caracteres JSON em uma variável chamada JsonString

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

1. A tentativa de acessar campos não existentes retorna Blank(). A fórmula a seguir retorna true:

   IsBlank( Text( ParseJSON( JsonString ).parent.child ) )
   

2. Os valores null JSON são considerados Blank(). A fórmula a seguir retorna true:

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

Matrizes Simples

Considerando a seguinte cadeia de caracteres JSON em uma variável chamada JsonString

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

1. Acessar o segundo número na tabela de coluna única do campo de matriz de valores dinâmicos e converter em um número usando Value() retorna 2:

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

2. Convertendo a tabela de coluna única de valores dinâmicos no campo de matriz em uma única tabela de colunas de números { Value: 1 }, { Value: 2 }, { Value: 3 }:

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

Matrizes de Registros

Considerando a seguinte cadeia de caracteres JSON em uma variável chamada JsonString

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

1. A conversão em uma tabela tipada de registros diretamente com ForAll() pode ser feita usando ThisRecord.[fieldname] para acessar campos dinâmicos e convertê-los em tipos específicos:

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

Matriz para tabela

1. Converter valores dinâmicos em uma tabela usando a função Table() resulta em uma tabela de coluna única de valores dinâmicos . Então, o objeto precisa ser acessado usando a coluna Value (único) e ser convertido em tipos conforme explicado anteriormente.

Considerando a seguinte cadeia de caracteres JSON em uma variável chamada JsonString

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

Table() retorna uma tabela de coluna única de valores dinâmicos com um valor de coluna única para número na 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() retorna uma tabela de coluna única de valores dinâmicos que representa cada objeto json na matriz.

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