4D Doc Center : Selection vers JSON

4D v14.3

JSON

Selection vers JSON


Selection vers JSON ( laTable {; leChamp}{; leChamp2 ; ... ; leChampN}{; template}) -> Résultat

Paramètre	Type	Description
laTable	Table	Table à sérialiser
leChamp	Champ	Champ(s) dont le contenu doit être sérialisé
template	Objet	Objet pour la sélection de libellés et de champs
Résultat	Texte	Chaîne contenant le tableau JSON sérialisé

Description

La commande Selection vers JSON retourne une chaîne JSON contenant les valeurs des champs de la sélection courante de laTable.

Si vous passez uniquement le paramètre laTable, la commande inclut dans la chaîne JSON les valeurs de tous les champs de la table exprimables en JSON. Les champs de type BLOB et image sont ignorés.

Si vous ne souhaitez pas inclure tous les champs de laTable, vous pouvez utiliser soit le paramètre leChamp soit le paramètre template :

leChamp : passez un ou plusieurs champ(s) dans ce paramètre. Seules les valeurs des champs définis seront incluses dans la chaîne JSON.
template : passez un objet 4D contenant une ou plusieurs paire(s) nom/valeur où valeur contient un pointeur vers un champ à inclure (cf. exemple 3).

Exemple

Vous voulez créer une chaîne JSON représentant cette sélection :

1) Vous souhaitez inclure les valeurs de tous les champs de la table [Adhérents] :

 $jsonString :=Selection vers JSON([Adhérents])

     // $jsonString = [{"Nom":"Durant","Prénom":"Marc","Adresse":"25 rue du

     //parc","Code postal":"95000","Ville":"Pontoise"},{"Nom":"Smith",

     //"Prénom":"John","Adresse":"24, rue Philibert-Delorme ","Code postal":

     //"75017","Ville":"Paris"},{"Nom":"Auquart","Prénom":"Adémart",

     //"Adresse":"37, quai de l´Iton","Code postal":"37100","Ville":"Tours"},...]

2) Vous souhaitez réduire la sélection et n’inclure que deux champs dans la chaîne JSON en utilisant la syntaxe basée sur les champs :

 CHERCHER([Adhérents];[Adhérents]Nom="A@")

 $jsonString :=Selection vers JSON([Adhérents];[Adhérents]Nom;[Adhérents]Ville)

     // $jsonString = [{"Nom":"Auquart","Ville":"Tours"},{"Nom":"Aubert","Ville":"Paris"}]

3) Vous souhaitez n’inclure qu’un champ dans la chaîne JSON en utilisant la syntaxe template :

 C_OBJET($template)

 OB FIXER($template;"Nom";->[Adhérents]Nom) //un seul champ

 TOUT SELECTIONNER([Adhérents])

 $jsonString :=Selection vers JSON([Adhérents];$template)

     // $jsonString = [{"Nom":"Durant"},{"Nom":"Smith"},{"Nom":"Auquart"},{"Nom":"Aubert"},{"Nom":"Lenuze"},{"Nom":"Pradel"}]