페이지 트리
메타 데이터의 끝으로 건너뛰기
메타 데이터의 시작으로 이동

page no.  97623635

Start Release No : 7.0.500.20250109-11 / Update Release No : 7.0.500.20250109-11


작성자 :  한재모  / 검수자 :  이승우


  1. 기능 설명
    1. Chart 컨트롤에서 계열의 특정 데이터 색상을 변경하는 기능을 제공합니다.
      1. ColorByPoint Script API 속성을 통해, 데이터 순서에 따른 Palette 기능을 제공합니다.
      2. SetPointColor Script API 함수를 통해, 특정 순서에 해당하는 데이터 색상을 설정하는 기능을 제공합니다.
  2. 사용 방법
    1. ColorByPoint
      1. 계열의 [ColorByPoint] 속성을 true 로 설정합니다.

      2. ChartOption 의 SetCustomPalette 를 통해 지정한 색상 팔레트 순서가 계열의 데이터에 적용됩니다.

      3. 해당 옵션을 true 로 설정한 경우, 아래 우측 차트와 같이 하나의 계열의 데이터가 설정한 Palette 가 반복적으로 데이터에 적용 됩니다.

        sample code
        /**************************************
         * 컨트롤에 데이터셋이 바인딩된 후 발생합니다.
         * * arguments :  
         *		 string	Id (Readonly:False) : 컨트롤이름 
         *		 int	RecordCount (Readonly:False) : 데이터셋의 레코드 수량 
        **************************************/
         var OnDataBindEnd  = function(sender, args){
         	if(args.Id === 'Chart') {
        		var Chart = Matrix.getObject('Chart');
        		
        		var colors = ['#FFE08C', '#B5B2FF'];
        		Chart.ChartOptions.SetCustomPalette(colors);
        		
        		var series = Chart.SeriesInfo.Get('DEPT_VAL');
        		series.ColorByPoint = true;
        		Chart.Update();
        	}
        	if(args.Id === 'Chart5') {
        		var Chart = Matrix.getObject('Chart5');
        		
        		var colors = ['#FFE08C', '#B5B2FF'];
        		Chart.ChartOptions.SetCustomPalette(colors);
        	}
         }


      4. 계열이 여러 개인 경우, 설정한 대상 계열을 제외한 나머지 항목은 설정한 Palette 순서로 색상이 지정됩니다.
        1. [YEAR_VAL], [MON_VAL] 의 경우, 설정한 Palette 순서로 반복되는 것을 확인할 수 있습니다.
      5. 다만, 범례의 색상은 무조건 회색으로 설정됩니다.
    2. SetPointColor
      1. 계열의 특정 순서에 해당하는 항목의 색상을 변경하는 함수입니다.

        1. 아래와 같은 경우, 계열의 Index 1 에 해당하는 항목에 대한 차트 색상이 설정됩니다.

        2. ColorByIndex 와 다르게, 범례의 색상은 계열의 Palette 색상을 그대로 유지합니다.
        sample code
        Series.SetPointColor(1, '#FF5E00');		// 1: 설정한 데이터 Index, #FF5E00: 설정할 color


주의 사항

  • ColorByPoint 는 보고서 상에 저장되지만, SetPointColor 함수를 통해 설정한 항목은 보고서 상에 저장되지 않습니다.
  • 따라서, SetPointColor 함수로 색상을 설정한 후 스크립트를 제거하고 보고서를 저장한 경우, 보고서를 오픈 시 해당 내용이 초기화 될 수 있습니다.
  • ColorByPoint 는 범례의 색상이 회색으로 고정됩니다.

기능 정보
  • API Open
  • UI Open
  • Read Only
  • Not Use
  • Hidden
  • Not Recommend
  • 해당 없음
시작 버전 정보
  • Release No : 7.0.500.20250109-11