DatasetオブジェクトのデータをJSON（JavaScript Object Notation）形式で処理するためのレイアウトについて説明します。

Dataset JSON layout

Dataset JSONは下記の形式で構成します。

version

Dataset Layoutのバージョンを明記します。

"version" : "1.0",

Parameters

パラメータの値を明記します。

"Parameters":
[
	{"id": "ErrorCode", "value":0}, 
	{"id": "ErrorMsg", "value":""},
	{"id": "param1", "value":0}, 
	{"id": "param2", "value":"0", "type":"string"}
]

• "ErrorCode", "ErrorMsg"項目は予約済みキーワードです。

• "ErrorCode"項目を未設定にした場合は0として処理されます。

• "ErrorMsg"項目を未設定にした場合、"ErrorCode"項目値が0であれば「SUCCESS」、それ以外の値であれば「FAILED」として処理されます。

Datasets

Datasetオブジェクトの情報を含む要素で、配列内のオブジェクト形式でDatasetを持ちます。

Dataset

1つのDatasetオブジェクトの情報を持つ要素で、Datasetオブジェクトの構造を表現するためのColumnInfoとDataset オブジェクトの実際のデータを持つRowsで構成されます。

Dataset形式の詳細

Datasetの各項目について説明します。

id

"id":"inData"

ColumnInfo > ConstColumn

"ColumnInfo": 
{
	"ConstColumn": 
	[
		{"id":"ConstCol1", "value":10},
		{"id":"ConstCol2", "type":"string", "size":"256", "value":10},
		{"id":"ConstCol3"}
	]
}

ColumnInfo > Column

"ColumnInfo": 
{
	"Column" : 
	[
		{"id":"Column0"},
		{"id":"Column1", "type":"string", "size":"256"},
		{"id":"Column2", "type":"string", "size":"256"}
	]
}

Rows

"Rows":
[
	{"_RowType_":"U", "Column0":"", "Column1":"zzz", "Column2":""},
	{"_RowType_":"O", "Column0":"", "Column2":""},
	{"_RowType_":"N", "Column0":"A", "Column1":"B", "Column2":""},
	{"_RowType_":"D", "Column0":"a", "Column1":"b", "Column2":"c"},
	{"_RowType_":"I", "Column0":"", "Column1":"", "Column2":""}
]

"Rows":
[
	{"Column0":"A", "Column1":"B"},
	{"Column0":"a", "Column1":"b", "Column2":"c"},
	{"Column0":"", "Column1":"", "Column2":""}
]

• Rowデータは順序に意味を持ちます。

• _RowType_ 属性値が「O」である場合は、1つ前のRowのOriginal rowを意味します。

  1つ前の_RowType_属性値「U」である場合にのみ正常動作します。

• _RowType_属性値が「O」であり、且つ1つ前のRowの_RowType_属性値が「U」以外の値である場合は、該当のRowは無視されます。また、1つ目のrowの_RowType_属性値が「O」である場合も、該当のRowは無視されます。

参考

type

Parameters、ConstColumn、Columnでtype項目値として使用できる値は下記の通りです。

JSONの例題

{
	"version" : "1.0",
	"Parameters":
	[
		{"id":"ErrorCode", "value":0}, 
		{"id":"ErrorMsg", "value":""},
		{"id":"param1", "value":0}, 
		{"id":"param2", "value":"0", "type":"string"} 
	],
	"Datasets" :
	[
		{
			"id":"indata",
			"ColumnInfo": 
			{
				"ConstColumn": 
				[
					{"id":"ConstCol1", "value":10},
					{"id":"ConstCol2", "type":"string", "size":"256", "value":10},
					{"id":"ConstCol3"}
				],
				"Column" : 
				[
					{"id":"Column0"},
					{"id":"Column1", "type":"string", "size":"256"},
					{"id":"Column2", "type":"string", "size":"256"}
				]
			},
			"Rows":
			[
				{"_RowType_":"U", "Column0":"", "Column1":"zzz", "Column2":""},
				{"_RowType_":"O", "Column0":"", "Column2":""},
				{"_RowType_":"N", "Column0":"A", "Column1":"B", "Column2":""},
				{"_RowType_":"D", "Column0":"a", "Column1":"b", "Column2":"c"},
				{"_RowType_":"I", "Column0":"", "Column1":"", "Column2":""}
			]
		}, 
		{
			"id": "indata2",
			"ColumnInfo": 
			{
				"Column": 
				[
					{"id":"Column0"},
					{"id":"Column1", "type":"string", "size":"256"},
					{"id":"Column2", "type":"string", "size":"256"}
				]
			},
			"Rows":
			[
				{"Column0":"A", "Column1":"B"},
				{"Column0":"a", "Column1":"b", "Column2":"c"},
				{"Column0":"", "Column1":"", "Column2":""}
			]
		}
	]
}