TreeDataLoader.load를 이용하면 서버로 부터 가져온 여러 형식의 원본 데이터를 TreeDataSet으로 로드할 수 있다.
Code -1
new TreeDataLoader(dataSet).load('csv', data, {
start: 1,
quoted: true,
...
});
load 메소드의 첫번째는 데이터 형식을 지정한다. 현재, 'csv', 'json', 'xml' 세 가지를 지원한다. data는 원본 데이터인데, 첫 매개변수에 지정한 형식에 따라 문자열이거나 Json 객체, 혹은 XML 도큐먼트 객체일 수 있다.
기존에 있던 데이터행들을 모두 제거한 후 새로운 행들을 생성하고, 로드 완료 후 onRowCountChanged 이벤트가 발생된다.
1. Csv 데이터
아래와 같은 형식으로 저장된 csv 파일을 서버로부터 가져와 트리 데이터셋을 구성한다. 첫 째 줄은 필드 이름들이 들어 있으므로 로드 옵션의 start는 1이 된다. 또, 값을 쌍 따옴표로 묶은 필드들이 존재하므로 quoted를 true로 지정하고, NUMBER 필드의 값에 숫자가 아닌 문자가 들어 있으므로 currency를 true로 지정한다. 옵션에 지정할 수 있는 값들에 대한 자세한 설명은 TreeDataLoader.load 토픽을 참조한다.
중요한 옵션은 treeField와 useTreeField인데 아래 파일에서는 두 번째 필드에 트리 정보가 있으므로 treeField는 1이 되고, 이 필드 값들은 데이터셋에 저장되지 않도록 useTreeField는 false가 된다. 보다 자세한 설명은 load 토픽을 참조한다.
아래와 같은 Json 배열을 데이터셋으로 로드하기 위해서는 먼저 타입을 "json"으로 지정하고, rows, childRows 옵션을 지정하면 된다. rows 는 최상위 행으로 가져올 객체들이 어떤 것들인 지를 지정하는 것이고, childRows는 그 이후로 자식행의 배열이 어떤 속성에 들어 있는 지를 지정하는 것이다. 이 예제에서는 배열의 최상위 항목을 데이터셋의 최상위 행들로 생성하기 위해 rows를 빈 문자열로 지정하고, "rows" 속성으로 지정된 json 배열을 자식행들로 가져오기 위해 childRows는 "rows"로 지정한다.
아래와 같이 Xml 텍스트 파일로 전달된 데이터를 트리 데이터셋으로 로드하기 위해서는 먼저 타입을 "xml"로 지정하고, rows, childRows 옵션을 지정하면 된다. Json의 경우와 속성 이름은 동일하지만 지시하는 내용은 다르다.
rows는 데이터행으로 가져올 xml element들의 tag 이름이다. 아래 예제에서는 row다. childRows는 자식 행들을 가져올 element들을 포함한 element의 tag 이름이다. 예제에서는 rows다. 이 속성은 지정하지 않을 수도 있는데 자식 element들을 포함하는 상위 element가 따로 존재하지 않고, 바로 아래 rows로 지정한 element들이 포함되어 있는 경우다.