4D Doc Center : Selection to JSON

4D v14.3

JSON

Selection to JSON


Selection to JSON ( aTable {; aField}{; aField2 ; ... ; aFieldN}{; template}) -> 戻り値

引数	型	説明
aTable	テーブル	シリアライズするテーブル
aField	フィールド	シリアライズするフィールドを指定
template	Object	プロパティ名と取り出したいフィールドを指定するポインターをオブジェクトで渡す
戻り値	テキスト	シリアライズされた JSON 配列を含む文字列

説明

Selection to JSONコマンドは、 aTable のカレントセレクションのためのフィールドの値を含んだJSON文字列を返します。

aTable 引数のみを渡した場合、テーブル内の、全てのフィールドの値のうち、 JSON で表現できるものを JSON 文字列で返します。BLOB フィールドとピクチャーフィールドは無視されます。

aTable 内の一部のフィールドのみ取り出したい場合、 aField 引数か、 template 引数を使ってその部分を指定することが出来ます:

aField: 一つ以上のフィールドをこの引数で指定して下さい。ここで指定したフィールドの値のみ JSON 文字列で返されます。
template: 一つ以上の名前/値のペアを含んだ 4D オブジェクトを渡して下さい。この値に、取り出したいフィールドを指定するポインターを入れて指定します。(例3を参照して下さい。)

例題

以下のセレクションを JSON 文字列で表現する場合:

1) [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) フィールドを指定して、取り出すフィールドを二つだけに限定したい場合:

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

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

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

3) template 表記を用いて、一つのフィールドだけを取り出したい場合:

 C_OBJECT($template)

 OB SET($template;"LastName";->[Members]LastName) // 単一のフィールドを指定

 ALL RECORDS([Members])

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

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