Função ParseJSON

Aplica-se a: Aplicativos de tela CLI de aplicativos Power Pages Power Platform controlados por modelo

Interpreta uma cadeia JSON e obtém um objeto sem tipo.

Descrição

A função ParseJSON irá analisar uma cadeia JSON válida e obter um objeto sem tipo que representa a estrutura JSON.

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

Sintaxe

ParseJSON( JSONString )

• JSONString – Obrigatório. A estrutura JSON representada como texto.

Converter o tipo de dados de Objeto sem tipo

ParseJSON obtém um objeto sem tipo que requer a conversão explícita de valores de campo em tipos de dados suportados. A tabela seguinte lista os tipos de dados no Power Apps e um tipo de dados JSON correspondente e como convertê-lo.

Exemplos

Aceder a valores de campo

Tendo em atenção a seguinte cadeia JSON numa variável denominada JsonString

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

1. A fórmula seguinte obtém o texto text value:

   Text( ParseJSON( JsonString ).parent.child )
   

2. A fórmula seguinte obtém o número 567:

   Value( ParseJSON( JsonString ).number )
   

Caso um nome de campo seja composto por um nome de identificador inválido, pode colocar os nomes de campo entre plicas. Tendo em atenção a seguinte cadeia JSON numa variável denominada JsonString

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

1. A fórmula seguinte obtém o texto text value:

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

Espaços em branco

Tendo em atenção a seguinte cadeia JSON numa variável denominada JsonString

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

1. A tentativa de aceder a campos não existentes obtém Blank(). A fórmula que se segue obtém true:

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

2. Os valores JSON null são considerados Blank(). A fórmula que se segue obtém true:

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

Matrizes Simples

Tendo em atenção a seguinte cadeia JSON numa variável denominada JsonString

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

1. Aceder ao segundo número na tabela de coluna única do campo de matriz de objeto sem tipo e converter para um número utilizando Value() obtém 2:

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

2. Converter a tabela de coluna única de objeto sem tipo no campo de matriz para uma tabela de coluna única de números { Value: 1 }, { Value: 2 }, { Value: 3 }:

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

Matrizes de Registos

Tendo em atenção a seguinte cadeia JSON numa variável denominada JsonString

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

1. A conversão numa tabela com tipo de registos diretamente com a ForAll() pode ser feito utilizando ThisRecord.[fieldname] para aceder a campos de objeto sem tipo e convertê-los em tipos conhecidos:

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

Matriz para Tabela

1. Converter objeto sem tipo numa tabela utilizando a função Table() resulta numa tabela de coluna única de objetos sem tipo. O objeto precisa então de ser acedido através da utilização da coluna (única) Value e de ser convertido em tipos, conforme explicado anteriormente.

Tendo em atenção a seguinte cadeia JSON numa variável denominada JsonString

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

Table() retorna uma tabela de coluna única de objetos não tipados com um valor de coluna única para o 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 objetos não tipados que representa cada objeto json na matriz.

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