[i-AUD] 누적형 차트에 누적된 값에 대한 데이터레이블을 표현하는 기능

page no.  126779487

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 객체 하위 속성입니다.

      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	데이터레이블에 대한 배경 색상

      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 을 통해서 설정해야합니다.
         
         

      var CHART = Matrix.getObject("CHART");
      
      
      CHART.Y1Axis.StackLabelFormat = "{0:P0}";
      CHART.Draw();

      

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

      var CHART = Matrix.getObject("CHART");
      
      
      CHART.Y1Axis.StackLabelText = '총 텍스트';
      CHART.Draw();

      

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

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

      
      
      

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

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