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

하나의 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” 인 경우는 바로 앞 Row 의 Original row 임을 의미합니다.

  바로 앞의 _RowType_ 속성값이 “U” 인 경우에만 정상 동작합니다.

• _RowType_ 속성값이 “O”이고 바로 앞 Row 의 _RowType_ 속성값이 "U"가 아닌 경우 해당 Row는 무시합니다. 또한 첫번째 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":""}
			]
		}
	]
}