4D Doc Center : Selection to JSON

4D v14.3

JSON

Selection to JSON


Selection to JSON ( aTabela {; oCampo}{; oCampo2 ; ... ; oCampoN}{; modelo}) -> Resultado

Parâmetro	Tipo	Descrição
aTabela	Tabela	Tabela a serializar
oCampo	Campo	Campo(s) cujo(s) conteúdos devem ser serializados
modelo	Object	Objeto para a seleção de etiquetas e de campos
Resultado	Texto	Cadeia que contém o array JSON serializado

Descrição

O comando Selection to JSON devolve uma cadeia JSON que contém os valores dos campos da seleção atual de aTabela.

Caso passe só o parâmetro aTabela, o comando inclui, na cadeia JSON, os valores de todos os campos da tabela que podem ser expressados em JSON. Os campos tipo BLOB e imagem são ignorados.

Se não deseja incluir todos os campos de aTabela, pode utilizar o parâmetro oCampo ou o parâmetro modelo:

oCampo: passe um ou mais campos neste parâmetro. Só os valores dos campos definidos são incluídos na cadeia JSON.
modelo: passe um objeto 4D que contém um ou mais pares nome/valor onde valor contém um ponteiro a um campo à incluir (ver o exemplo 3).

Exemplo

Quer criar uma cadeia JSON que represente esta seleção:

1) Deseja incluir os valores de todos os campos da tabela [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) Deseja reduzir a seleção e só incluir dois campos na cadeia JSON utilizando a sintaxe baseada nos 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ó deseja incluir um campo na cadeia JSON utilizando a sintaxe do modelo:

 C_OBJECT($template)

 OB SET($template;"LastName";->[Members]LastName) // um só campo

 ALL RECORDS([Members])

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

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

  // {"LastName":"Leonard"},{"LastName":"Pradel"}]