IBSheet 데이터 연동

IBSheet에 조회된 데이터를 쉽게 차트로 표현할 수 있는 기능으로 sheet2chart 메소드를 이용하여 설정 합니다.
기본적으로 시트에서의 컬럼은 시리즈, 행은 데이터로 표현됩니다.

Syntax

sheet2chart(sheet, chart, params);

Info

name	type	required	description
`sheet`	`object`	Y 시트 객체
`chart`	`object`	Y 차트 객체
`params`	`object`		조회 옵션
`params.datadirection`	`string`	필수	데이터를 만들기 위해 시트의 내용을 읽어들이는 방향
`params.datarowcol`	`string` or `array<object>`	필수	데이터를 읽어들일 열 혹은 행, 읽어들이는 방향이 vertical인 경우에는 열을, horizontal인 경우에는 행을 구분자 "\|" 연결하여 넣는다. 행의 경우 IBSheet의 `row 객체`를 `array`로 담아 넣을 수 있다.
`params.legendseriesname`	`string` or `array<object>`	필수	범례에 나올 시리즈별 이름(datarowcol의 개수와 동일해야 함.) 행의 경우 IBSheet의 `row 객체`를 `array`로 담아 넣을 수 있다.
`params.legendtitle`	`string`	필수(범례)	범례 타이틀 범례 타이틀 문자열 (예: `"범례"`, 생략 시 IBLANG의 `text.legend` 값). ※ 현재 코드는 이 값을 읽기만 하고 차트에 반영하지 않습니다.
`params.startdatarowcol`	`number`	필수(시작행	시작열)
`params.enddatarowcol`	`number`	필수(마지막행	마지막열)
`params.labelrowcol`	`number` or `object`	필수	x축 레이블이 될 행이나 열 하나만 선택 한다. IBSheet의 행 객체를 넣을 수도 있습니다.
`params.startlabelrowcol`	`number`	필수	x축 레이블이 될 첫번째 행이나 열
`params.endlabelrowcol`	`number`	필수	x축 레이블이 될 마지막 행이나 열
`params.labeldirection`	`string`	필수	x축 레이블을 읽어 들이는 방향 `"vertical"`(기본값, 열 방향으로 레이블 읽기) 또는 `"horizontal"`(행 방향). 그 외 값은 무시되고 `"vertical"`로 처리됩니다.
`params.seriestype`	`array<string>`	필수	시리즈 유형 시리즈별 차트 유형을 datarowcol 순서대로 배열로 지정 (예: `["column", "line"]`). 값은 그대로 시리즈 `type`이 되므로 chart.type의 값을 사용합니다. 개수가 부족하면 나머지는 `"line"`으로 채워지며, legendseriesname이 지정된 경우에만 적용됩니다.

Enum

params.datadirection / params.labeldirection

value	description
vertical	세로로 데이터 조회
horizontal	가로로 데이터 조회

Example

myChart.setOptions({
  xAxis:{
    categories:true   //X축 라벨
  },
  plotOptions:{
    series:{
      dataLabels:{
        enabled:true   //데이터값 표시
      }
    }
  }
});

// IBSheet 연동
myChart.sheet2chart(mySheet, myChart, {
  datadirection: "horizontal",
  datarowcol: "1",
  legendseriesname: "" + mySheet18.GetRowData(1).sLineNm, // 시리즈의 이름을 sheet의 첫번째행에서 sLineNm의 값을 가져온다.
  legendtitle: "범례",
  startdatarowcol: 2,
  enddatarowcol: 5,
  labelrowcol: 0,
  startlabelrowcol: 2,
  endlabelrowcol: 5,
  labeldirection: "horizontal",
  seriestype: ["spline"]
});

Since

version	desc
7.3.0.0	`deprecated`