Funció ParseJSON

S'aplica a: Aplicacions de llenç Aplicacions Power Pages Power Platform basades en models CLI

Interpreta una cadena JSON i retorna un objecte sense tipus.

Descripció

La funció ParseJSON analitzarà una cadena JSON vàlida i retornarà un objecte sense tipus que representi l'estructura JSON.

La funció ParseJSON pot retornar errors si el text no és vàlid JSON segons el format JavaScript Object Notation (JSON) descrit a ECMA-404 i IETF RFC 8259.

Sintaxi

ParseJSON( JSONString )

• JSONString: obligatori. L'estructura JSON representada com a text.

Convertir el tipus de dades d'objecte sense tipus

ParseJSON retorna un objecte sense tipus que requereix una conversió explícita de valors de camp en tipus de dades compatibles. A la taula següent s'enumeren els tipus de dades del Power Apps i un tipus de dades JSON corresponent i com convertir-les.

Tipus de dades	Exemples JSON	Descripció	Exemple de conversió
Boolean	{ "bool": true }	El booleà és un tipus explícit en JSON i es pot convertir directament.	Boolean( ParseJSON("{ ""bool"": true }").bool )
Color	{ "color": "#102030" } { "r": 255, "g": 128, "b": 0, "a": 0.5 }	No hi ha cap tipus de color al JSON. Els valors de color es poden crear a partir d'enters d'RGBA o cadenes hexadecimals.	ColorValue( ParseJSON( "{ ""color"": ""#102030"" }" ).color ) With( { uo: ParseJSON( "{ ""r"": 255, ""g"": 128, ""b"": 0, ""a"": 0.5 }" ) }, RGBA( Value( uo.r ), Value( uo.g ), Value( uo.b ), Value( uo.a ) ) )
Divisa, número	{ "numbervalue": 123.5 }	Els nombres es representen directament en JSON amb un punt (.) com a separador de decimals.	Value( ParseJSON("{ ""numbervalue"": 123.5 }").numbervalue )
Date, DateTime, Time	{ "start": "2022-05-10" } { "start": "23:12:49.000" }	JSON no té un tipus de data o hora, així que només pot representar les dates i les hores com a cadenes. Un objecte sense tipus es pot convertir directament d'una cadena en format ISO 8601 a una data, una hora o un datetime. Per a la resta de formats, convertiu primer el camp JSON en text utilitzant la funció Text() i després utilitzeu la funció DateValue(), TimeValue() o DateTimeValue(), que per defecte utilitzarà el llenguatge de la configuració de l'usuari actual.	DateValue( ParseJSON("{ ""appointment"": ""2022-05-10"" }").appointment ) DateValue( Text( ParseJSON("{ ""appointment"": ""May 5, 2022"" }").appointment ) )
GUID	{ "id": "123e4567-e89b-12d3-a456-426655440000" }	JSON no té un tipus de dades per als GUID, per la qual cosa només es poden representar com a cadenes.	GUID( ParseJSON("{ ""id"": ""123e4567-e89b-12d3-a456-426655440000"" }").id )
HyperLink, Image, Media	{ "URI": "https://northwindtraders.com/logo.jpg" }	Aquests tipus de dades són tipus de dades de text i es poden convertir en text i després utilitzar-se al Power Apps.	Text( ParseJSON("{ ""URI"": ""https://northwindtraders.com/logo.jpg"" }").URI )
Elecció	{ "status": 1 } { "status": "Closed" }	Les opcions es presenten com a cadenes loicalitzades, amb el suport d'un número. La funció JSON() serialitza l'opció al número de suport. No hi ha cap conversió directa de número o cadena a una opció, però les funcions Switch() o If() es poden utilitzar en el valor del text o el valor numèric.	Switch( Value( ParseJSON( "{ ""status"": 1 }" ).status ), 0, Status.Open, 1, Status.Closed )
Enregistra	{ "field": "value" }	No hi ha cap conversió directa d'un objecte JSON a una estructura de registres, però els camps individuals es poden recuperar de l'objecte sense tipus per formar un registre.	{ field: Text( ParseJSON( "{ ""field"": ""value"" }" ).field ) }
Referència de registre	n/d	Les referències de registre són úniques als orígens de dades i no es poden serialitzar ni no desserialitzar. Els valors de camp que representen claus úniques es poden utilitzar al JSON per identificar registres que després es poden cercar.	n/d
Table	[ { "id": 1, "name": "one" }, { "id": 2, "name": "two" } ] [1, 2, 3]	El JSON pot incloure matrius, que es poden convertir en taules. Aquests valors poden ser matrius de registres o matrius de valors que són efectivament taules d'una columna. Les matrius ParseJSON () només es poden convertir en una única taula de columnes d'objectes no tipusts i es poden utilitzar com atals o convertir-se en taules de registres escrites mitjançant ForAll().	ForAll( Table( ParseJSON( "[ { ""id"": 1, ""name"": ""one"" }, { ""id"": 2, ""name"": ""two"" } ]" ) ), { id: Value(ThisRecord.Value.id), name: Text(ThisRecord.Value.name) } )
SMS	{ "stringField": "this is text" }	El text és un tipus explícit en JSON i es pot convertir directament.	Text( ParseJSON( "{ ""stringField"": ""this is text"" }").stringField )
Dues opcions	{ "available": true } { "available": "Yes" }	Les dues opcions es presenten com a cadenes loicalitzades, amb el suport d'un booleà. La funció JSON() serialitza dues opcions al seu valor booleà. No hi ha cap conversió directa de booleà, número o cadena a dues opcions, però les funcions Switch() o If() es poden utilitzar en el valor del text, del booleà o el valor numèric.	Switch( Boolean( ParseJSON( "{ ""available"": true }" ).available ), false, Availability.No, true, Availability.Yes )

Exemples

Accedir als valors de camp

A partir de la següent cadena JSON en una variable anomenada JsonString

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

1. La fórmula següent retorna el text text value:

   Text( ParseJSON( JsonString ).parent.child )
   

2. La fórmula següent retorna el número 567:

   Value( ParseJSON( JsonString ).number )
   

En cas que un nom de camp consisteixi en un nom d'identificador no vàlid, podeu col·locar els noms dels camps en cometes simples. A partir de la següent cadena JSON en una variable anomenada JsonString

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

1. La fórmula següent retorna el text text value:

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

Buits

A partir de la següent cadena JSON en una variable anomenada JsonString

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

1. Si intenteu accedir als camps que no existeixen, es retorna Blank(). La fórmula següent retorna true:

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

2. Els valors JSON null es consideren Blank(). La fórmula següent retorna true:

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

Matrius simples

A partir de la següent cadena JSON en una variable anomenada JsonString

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

1. Accedir al segon número de la taula d'una única del camp de la matriu amb objectes sense tipus i convertir-lo en un número amb Value() retorna 2:

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

2. Convertir la taula d'una única columna de l'objecte sense tipus al camp de la matriu, en una taula d'una única columna amb els números { Value: 1 }, { Value: 2 }, { Value: 3 }:

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

Matrius de registres

A partir de la següent cadena JSON en una variable anomenada JsonString

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

1. La conversió en una taula amb tipus de registres directament amb ForAll() es pot fer mitjançant ThisRecord.[fieldname] per accedir als camps d'objectes sense tipus i convertir-los en tipus coneguts:

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

Matriu a taula

1. La conversió d'un objecte sense tipus en una taula mitjançant la funció Table() resulta en una taula d'una única columna amb objectes sense tipus. A continuació, cal accedir a l'objecte mitjançant una (única) columna Value i convertir-la en tipus tal com s'ha explicat anteriorment.

A partir de la següent cadena JSON en una variable anomenada JsonString

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

Table() retorna una taula d'una única columna amb objectes sense tipus amb un valor d'una columna per al número de la matriu...

 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 una taula d'una única columna amb objectes sense tipus que representa cada objecte JSON de la matriu.

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