Fonction ParseJSON

S’applique à : Applications canevas Applications pilotées par modèle Power Pages Power Platform CLI

Interprète une chaîne JSON et renvoie un objet sans type ou un objet typé.

Description

La fonction ParseJSON analyse une chaîne JSON valide et renvoie un objet sans type représentant la structure JSON.

Vous pouvez également utiliser le deuxième argument pour convertir le JSON en objet typé qui peut être directement utilisé dans des formules Power Fx. Cela rend le résultat plus facile à consommer, car les conversions et les coercitions au point d’utilisation ne sont plus nécessaires. Le JSON sans type est mappé au type avec ces règles :

• Les colonnes du type qui ne sont pas présentes dans le JSON sont remplies d’espaces vides.
• Les colonnes du JSON qui ne sont pas présentes dans le type sont ignorées.
• Pour les colonnes qui sont à la fois dans le type et dans JSON, la valeur JSON doit être coercitive par rapport au type.

La fonction ParseJSON peut renvoyer des erreurs si le texte n’est pas un JSON valide selon le format JavaScript Object Notation (JSON) décrit dans ECMA-404 et IETF RFC 8259.

Syntaxe

ParseJSON( JSONString [ , Type ] )

• JSONString : Obligatoire. Structure JSON représentée sous forme de texte.
• Type : facultatif. Définition de type Power Fx pour la structure JSON. Sans cet argument, ParseJSON renvoie un objet sans type ; avec lui, la fonction renvoie un objet fortement typé.

Conversion du type de données d’objet sans type

Avec le deuxième argument, ParseJSON renvoie un objet sans type qui nécessite une conversion explicite des valeurs de champ dans les types de données pris en charge. La table suivante répertorie les types de données dans Power Apps et un type de données JSON correspondant et comment le convertir.

Examples

Accéder aux valeurs de champ

Étant donné la chaîne JSON suivante dans une variable nommée JsonString

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

1. La formule suivante renvoie le texte text value :

   Text( ParseJSON( JsonString ).parent.child )
   

2. La formule suivante renvoie le nombre 567 :

   Value( ParseJSON( JsonString ).number )
   

Si un nom de champ se compose d’un nom d’identifiant invalide, vous pouvez mettre les noms de champ entre guillemets simples. Étant donné la chaîne JSON suivante dans une variable nommée JsonString

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

1. La formule suivante renvoie le texte text value :

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

Vide

Étant donné la chaîne JSON suivante dans une variable nommée JsonString

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

1. Essayer d’accéder à des champs inexistants renvoie Blank(). La formule suivante renvoie true :

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

2. Les valeurs null JSON sont considérées comme Blank(). La formule suivante renvoie true :

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

Tableaux simples

Étant donné la chaîne JSON suivante dans une variable nommée JsonString

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

1. Accéder au deuxième nombre dans la table à une seule colonne du champ tableau de l’ objet sans type et convertir en un nombre en utilisant Value() renvoie 2 :

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

2. Conversion de la table à colonne unique de l’ objet sans type dans le champ tableau, à une table à colonne unique de nombres { Value: 1 }, { Value: 2 }, { Value: 3 } :

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

Tableaux d’enregistrements

Étant donné la chaîne JSON suivante dans une variable nommée JsonString

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

1. La conversion en une table typée d’enregistrements directement avec ForAll() peut être faite en utilisant ThisRecord.[fieldname] pour accéder aux champs objet sans type et convertissez-les en types connus :

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

Du tableau à la table

1. La conversion de l’objet sans type en une table à la fonction Table() entraîne une table à colonne unique d’objets sans type. L’objet doit ensuite être accessible à l’aide de la colonne (unique) Value et être converti en types comme expliqué précédemment.

Étant donné la chaîne JSON suivante dans une variable nommée JsonString

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

Table() renvoie une table à colonne unique d’objets sans type avec une valeur à colonne unique pour le nombre dans le tableau...

 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() renvoie une table à colonne unique d’objets sans type qui représente chaque objet json dans le tableau.

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