Selection to JSON

4D v15 R3

JSON

Selection to JSON


Selection to JSON ( laTabla {; elCampo}{; elCampo2 ; ... ; elCampoN}{; template}) -> Resultado

Parámetro	Tipo	Descripción
laTabla	Tabla	Tabla a serializar
elCampo	Campo	Campo(s) cuyo(s) contenidos deben ser serializados
template	Objeto	Objeto para la selección de etiquetas y de campos
Resultado	Texto	Cadena que contiene el array JSON serializado

Descripción

El comando Selection to JSON devuelve una cadena que contiene un array JSON con tantos elementos como registros hay en la selección actual de laTabla. Cada elemento del array es un objeto JSON que contiene las etiquetas y los valores de los campos de la selección.

Si sólo pasa el parámetro laTabla, el comando incluye en el array JSON, los valores de todos los campos de la tabla que se pueden expresar en JSON. Los campos tipo BLOB e imagen se ignoran.

Si no desea incluir todos los campos de laTabla, puede utilizar el parámetro elCampo o el parámetro plantilla:

unCampo: pase uno o más campos en este parámetro. Sólo los valores de los campos definidos se incluyen en el array JSON.
plantilla: pase un objeto 4D que contenga uno o más pares nombre/valor donde el nombre puede ser todo nombre de atributo valido y el valor contiene un puntero a un campo a incluir. Esta sintaxis le permite personalizar las etiquetas de campos en el array JSON.

Este comando soporta campos de tipo de objeto: los datos de estos campos se convierte automáticamente en formato JSON. Tenga en cuenta que la siguiente instrucción 4D será interpretado como "producir JSON a partir de todos los valores de campoObjeto en la selección actual de la tabla":

Selection to JSON([aTable];objectField)

Ejemplo

Quiere crear una cadena JSON que represente esta selección:

1) Desea incluir los valores de todos los campos de la tabla [Members]:

 $jsonString :=Selection to JSON([Members])

  // $jsonString =[{"LastName":"Durant","FirstName":"Mark","Address":

  //"25 Park St","Zip code":"15205","City":"Pittsburgh"},{"LastName":

  //"Smith","FirstName":"John","Address":"24 Philadelphia Ave","Zip code":

  //"75203","City":"Dallas"},{"LastName":"Anderson","FirstName"

  //:"Adeline","Address":"37 Market St","Zip code":"45205","City":"Cincinnati"},...]

2) Desea reducir la selección y sólo incluir dos campos en la cadena JSON utilizando la sintaxis basada en los campos:

 QUERY([Members];[Members]LastName="A@")

 $jsonString :=Selection to JSON([Members];[Members]LastName;[Members]City)

  // $jsonString = [{"LastName":"Anderson","City":"Cincinnati"},{"LastName":"Albert","City":"Houston"}]

3) Sólo desea incluir un campo en la cadena JSON y utilizar una etiqueta diferente.
Puede utilizar la sintaxis template:

 C_OBJECT($template)

 OB SET($template;"Member";->[Members]LastName) //etiqueta personalizada y un campo sencillo

 ALL RECORDS([Members])

 $jsonString :=Selection to JSON([Members];$template)

  // $jsonString = [{"Member":"Durant"},{"Member":"Smith"},{"Member":"Anderson"},

  // {"Member":"Albert"},{"Member":"Leonard"},{"Member":"Pradel"}]

Ver también

JSON TO SELECTION