ParseJSON Fonction

S’applique à : Applications Canevas Copilot Studio Basées sur des modèles , applications Power Platform CLI Dataverse fonctions Power Pages

Interprète une chaîne JSON et retourne une valeur dynamique ou une valeur typée spécifique si un type est fourni.

Description

La ParseJSON fonction analyse une chaîne JSON valide et retourne une valeur dynamique 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 ParseJSON fonction peut retourner des erreurs si le texte n’est pas valide JSON conformément au format JSON (JavaScript Object Notation) 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 retourne une valeur dynamique ; avec elle, la fonction retourne une valeur typée spécifique.

Conversion de valeurs dynamiques

Sans le deuxième argument, ParseJSON retourne une valeur dynamique qui nécessite une conversion explicite de 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. L’accès au deuxième nombre dans la table à colonne unique du champ tableau des valeurs dynamiques et la conversion en nombre à l’aide de Value() retourne 2:

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

2. Conversion de la table à colonne unique de valeurs dynamiques dans le champ de tableau, en une seule table de colonnes 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 d’enregistrements typée directement avec ForAll() peut être effectuée en utilisant ThisRecord.[fieldname] pour accéder aux champs dynamiques et les convertir en types spécifiques :

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

Du tableau à la table

1. La conversion de valeurs dynamiques en table à l’aide de la fonction Table() entraîne une table à colonne unique de valeurs dynamiques . 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() retourne une table à colonne unique de valeurs dynamiques 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() retourne une table à colonne unique de valeurs dynamiques qui représente chaque objet json dans le tableau.

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