페이지 이력

page no. 

1. 기능 설명
   1. 차트의 유형이 누적형인 경우, X 축에 해당하는 누적된 데이터에 대한 데이터레이블을 표현할 수 있는 기능을 제공합니다.
   2. 기본 차트의 Script API 를 통해 해당 기능을 사용할 수 있습니다.
   3. 해당 기능은 차트 컨트롤 실행 시, 런타임 환경에서 실행되고 보고서에 저장되지 않습니다.
      (※ 설정 후, 스크립트 상에서 해당 Script API 를 제거 시, 다음 보고서 실행 시 적용되지 않습니다.)
   4. 해당 기능을 사용해도 차트 유형이 누적형이 아닌 경우, 해당 기능은 적용되지 않습니다.
      
      
      
      
2. 사용 방법

   1. 해당 기능과 관련한 Script API 기능들은 아래와 같습니다.

      구 분	API 이름	타 입	설 명
      1	UseStackLabel	Boolean	누적 데이터레이블 사용 여부
      2	StackLabelStyle	Object	누적 데이터레이블에 대한 스타일 객체
      3	StackLabelFormat	String	누적 데이터레이블로 표현되는 값에 대한 서식
      4	StackLabelText	String	누적 데이터레이블로 표현되는 텍스트
      5	StackLabelOffsetX	Number	누적 데이터레이블로 표현되는 X Offset 정보
      6	StackLabelOffsetY	Number	누적 데이터레이블로 표현되는 Y Offset 정보

      
      

   2. 차트 컨트롤의 UseStackLabel 를 true 로 설정하면, 아래와 같은 누적된 값이 데이터레이블로 표현됩니다.

      1. 해당 속성은 차트의 YAxis 객체 하위 속성입니다.

      코드 블럭
      language js
      var CHART = Matrix.getObject("CHART"); CHART.Y1Axis.UseStackLabel = true; CHART.Draw();

      
      
      
      

   3. StackLabelStyle 를 통해서 데이터레이블에 대한 스타일 설정이 가능하고, 제공되는 스타일 속성을 아래와 같습니다.

      
      

      구분	속성명	타 입	설 명
      1	Color	String	데이터레이블 텍스트 글자 색상
      2	FontSize	Number	데이터레이블 텍스트의 글자 크기
      3	FontWeight	String	데이터레이블 텍스트 글자 굵기
      4	FontStyle	String	데이터레이블 텍스트의 기울기 관련 스타일
      5	FontFamily	String	데이터레이블 텍스트의 Font 유형
      6	Opacity	Number	데이터레이블 투명도
      7	BorderWidth	Number	데이터레이블 테두리에 대한 굵기
      8	BorderStyle	String	데이터레이블 테두리에 대한 스타일
      9	BorderColor	String	데이터레이블 테두리에 대한 색상
      10	BorderRadius	Number	데이터레이블 테두리에 대한 Radius
      11	Padding	Number	데이터레이블에 대한 Padding
      12	BackgroundColor	String	데이터레이블에 대한 배경 색상

      
      

      코드 블럭
      language js
      var CHART = Matrix.getObject("CHART"); CHART.Y1Axis.StackLabelStyle.Color = "#FF0000"; CHART.Y1Axis.StackLabelStyle.FontSize = 14; CHART.Y1Axis.StackLabelStyle.FontWeight = "bold"; CHART.Y1Axis.StackLabelStyle.FontStyle = "italic"; CHART.Y1Axis.StackLabelStyle.Opacity = "1"; CHART.Y1Axis.StackLabelStyle.BorderWidth = 2; CHART.Y1Axis.StackLabelStyle.BorderStyle = "solid"; CHART.Y1Axis.StackLabelStyle.BorderColor = "#FFBB00"; CHART.Y1Axis.StackLabelStyle.BorderRadius = 20; CHART.Draw();

      

   4. 표현될 데이터레이블의 서식을 StackLabelFormat (기본값 : {N:0}) Script API 속성을 통해 설정할 수 있습니다.
      1. 해당 속성은 차트 전체에 적용되는 개념이고, 개별 개별적인 텍스트에 대한 서식을 적용하려면 StackLabelText 을 통해서 설정해야합니다.
         
         

      코드 블럭
      language js
      var CHART = Matrix.getObject("CHART"); CHART.Y1Axis.StackLabelFormat = "{0:P0}"; CHART.Draw();

      

   5. StackLabelText Script API 를 통해, 사용자가 원하는 텍스트로 데이터레이블을 표현할 수 있습니다.

      코드 블럭
      language js
      var CHART = Matrix.getObject("CHART"); CHART.Y1Axis.StackLabelText = '총 텍스트'; CHART.Draw();

      

   6. StackLabelText 에서는 예약어를 통해, 합계 뿐 아니라 평균, 최대, 최소값에 대한 내용을 표시할 수 있습니다.
      1. 합계(<@SUM@>), 평균(<@AVG@>), 최대(<@MAX@>), 최소(<@MIN@>)
      2. 특정 값에 대해서 별도의 서식을 적용하고 싶으면 예약어 상에 예시와 같이 서식을 작성하면 됩니다. ( ex. <@SUM|{0:N0}@> )
      3. 서식을 별도로 설정하지 않은 경우, StackLabelFormat 에서 설정된 서식으로 적용됩니다.

      코드 블럭
      language js
      var CHART = Matrix.getObject("CHART"); CHART.Y1Axis.StackLabelText = '최대 <@MAX|{0:N2}@>'; CHART.Draw();

      
      
      

   7. 특정 계열에 대한 데이터에 대한 값을 표현할 수 있습니다.

      코드 블럭
      language js
      var CHART = Matrix.getObject("CHART"); CHART.Y1Axis.StackLabelText = '계열 NTX 값 : <@[NTX|{0:N3}]@>'; CHART.Draw();

      
       

변경 사항