JSON

Syntaxe

Paramètres

Description

Cette fonction permet de générer une chaîne de texte JSON pour une table, un enregistrement ou une valeur.

Remarques

• Conversion pratique vers un format d'échange universel : La fonction JSON permet de transformer une structure de données Power Fx (table, enregistrement ou valeur simple) en une chaîne JSON. Ce format est largement utilisé dans les échanges entre systèmes, les appels API ou l'entreposage de données, rendant cette fonction essentielle dans les scénarios d'intégration.
• Utile pour les appels à des connecteurs personnalisés : Lorsqu'on utilise Power Automate ou des connecteurs HTTP personnalisés, les données doivent souvent être transmises sous forme de JSON. Grâce à la fonction JSON, on peut préparer rapidement et dynamiquement le corps de la requête avec les bonnes structures sans devoir coder manuellement chaque propriété.
• Prise en charge du formatage lisible ou compact : Le deuxième paramètre optionnel permet de choisir entre un JSON lisible (avec indentations et sauts de ligne) ou un JSON compact, utile lorsqu'on cherche à économiser de l'espace ou à intégrer la chaîne dans une URL ou une requête. Cette flexibilité améliore la lisibilité ou l'efficacité selon le besoin.
• Fonction très utile pour le débogage : Dans un contexte de test ou de développement, il est fréquent d'utiliser JSON pour afficher le contenu d'un enregistrement ou d'une table dans un contrôle de texte. Cela permet d'inspecter rapidement les données contenues dans des structures complexes et d'identifier les éventuels problèmes.
• Compatibilité avec les structures imbriquées : La fonction gère correctement les structures hiérarchiques (tables contenant des enregistrements, enregistrements contenant d'autres tables,...). Cela permet de sérialiser des modèles de données complexes en une seule chaîne JSON exploitable dans des environnements extérieurs ou pour des analyses.
• Nécessité de bien comprendre le format de sortie : La chaîne retournée par JSON est conforme au standard JSON, mais certaines particularités propres à Power Fx (comme les types de données ou les noms de colonnes) peuvent surprendre. Il est donc recommandé de tester et valider le format généré avant de l'envoyer à des systèmes tiers.
• Permet l'exportation facile de données : La fonction peut être utilisée pour transformer des données issues de collections ou de galeries en texte JSON, pouvant ensuite être exporté, sauvegardé ou transmis. Cela ouvre la voie à des scénarios comme l'archivage, l'interopérabilité ou la synchronisation avec d'autres plateformes.
• Non réversible directement sans fonction de décodage : Bien que JSON permette de sérialiser des données, Power Fx ne propose pas de fonction native ParseJSON aussi souple pour reconstruire exactement la structure d'origine. Il faut souvent écrire des expressions supplémentaires pour interpréter le JSON, surtout en l'absence de schéma strict.