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


TreeLayout Control 

Start Release No : 7.0.400.20230619 / Update Release No :

프로젝트명 : (BCRM#D1148) [AUD 7.3] 금융정보분석원 PoC TreeLayout 컴포넌트 신규 개발

작성자 : 한재모          / 검수자 : 

기능 정보
  • API Open
  • UI Open
  • Read Only
  • Not Use
  • Hidden
  • Not Recommend

기능 설명

  1. 실행 경로 : [i-AUD Designer > UI Bot > Add-In 컨트롤 생성 > 우측 PropertyGrid 의 "Class" 속성을 "TreeLayout" 으로 변경]

  2. 사용 방법
    1. i-AUD Designer > UI Bot > Add-In 컨트롤 생성 > 우측 PropertyGrid 의 "Class" 속성을 "TreeLayout" 으로 변경 ( 기본 컨트롤 생성 )



    2. Node, Link 관련 DataSet 생성

      1. TreeLayout 컨트롤을 구성하는 Node, Link 에 대한 DataSet 이 1개씩 필요

      2. Node 에 대한 DataSet 은 아래와 같은 구조의 컬럼을 가져야 한다.
        • 필수항목 : KEY, DEPTH
        • KEY 는 고유값으로 구성해야 한다.
        • DEPTH 는 왼쪽을 기준으로 DEPTH 가 0 을 의미하고, 오른쪽으로 갈수록 DEPTH 가 높아지는것을 의미한다.
        • CAPTION 이 빈 값인 경우, KEY 를 CAPTION 으로 표시.
        • Node 에 이미지를 표현하고 싶은 경우, "ICON" 컬럼명으로 설정하면 된다. ( 이미지는 반드시 base64 데이터 이미지로 설정해야 한다 )
        • 컬럼의 이름은 동일하지 않아도 가능하다.
        • 옵션을 통해, 특정 컬럼을 KEY, VALUE 등에 적용하도록 하는 기능을 지원하고 있다. ( ※ 명시하지 않으면, KEY, VALUE 라는 이름의 컬럼을 찾음 )



      3. Link 에 대한 DataSet 은 아래와 같은 구조의 컬럼을 가져야 한다.
        • 필수항목 : FROM, TO, VALUE
        • FROM : 보내는 Node KEY
        • TO : 받는 Node KEY
        • 컬럼의 이름은 동일하지 않아도 가능하다.
        • 옵션을 통해, 특정 컬럼을 KEY, VALUE 등에 적용하도록 하는 기능을 지원하고 있다. ( ※ 명시하지 않으면, KEY, VALUE 라는 이름의 컬럼을 찾음 )




    3. DataSet 연결 및 컨트롤 실행

      1. Script 에서 [TreeLayout] Class 불러오기
        1. OnLoadComplete 이벤트에서 아래와 같이 Add-In 컨트롤의 API 를 통해 TreeLayout Class 를 불러오기
        Example code
        /**************************************
         * 문서가 로드되고 AutoRefresh가 완료되는 시점에 발생합니다.
         * * arguments :  
         *		 bool	Success (Readonly:False) : 성공여부 
         *		 string	Message (Readonly:False) : 에러 메시지 
        **************************************/
         var OnLoadComplete  = function(sender, args){
        	var AddIn = Matrix.getObject("AddIn");
        	var TreeLayoutClass = AddIn.getScriptClass("TreeLayout");
        }
      2. TreeLayout 컨트롤에서 사용할 Node, Link DataSet 연결 후, 컨트롤의 Update 함수 호출

        Example code
        TreeLayout.NodeDataSet = [Node DataSet Object];
        TreeLayout.LinkDataSet = [Link DataSet Object];
        
        TreeLayout.Update();			// Network 컨트롤 Update



대분류기능 유형

세부 기능 명

내용
옵 션
Node


















keyField
  • Node 에서 [KEY] 필드로 사용할 데이터셋의 컬럼을 지정
  • String ( Default : undefined )
captionField
  • Node 에서 [CAPTION] 필드로 사용할 데이터셋의 컬럼을 지정
  • String ( Default : undefined )
valueField
  • Node 에서 [VALUE] 필드로 사용할 데이터셋의 컬럼을 지정
  • String ( Default : undefined )
colorField
  • Node 에서 [COLOR] 필드로 사용할 데이터셋의 컬럼을 지정
  • String ( Default : undefined )
borderColorField
  • Node 에서 [BORDER_COLOR] 필드로 사용할 데이터셋의 컬럼을 지정
  • String ( Default : undefined )
depthField
  • Node 에서 [DEPTH] 필드로 사용할 데이터셋의 컬럼을 지정
  • String ( Default : undefined )
sizeField
  • Node 에서 [SIZE] 필드로 사용할 데이터셋의 컬럼을 지정
  • String ( Default : undefined )
iconField
  • Node 에서 [ICON] 필드로 사용할 데이터셋의 컬럼을 지정
  • String ( Default : undefined )
shapeField
  • Node 에서 [SHAPE] 필드로 사용할 데이터셋의 컬럼을 지정
  • String ( Default : undefined )
borderWidth
  • Node 테두리 두께를 설정
  • Number ( Default : 1 )
highlightedBackColor
  • Highlighted Node 의 배경 색상을 지정
  • String ( Default : #FFB85A )
highlightedBorderColor
  • Highlighted Node 의 테두리 색상을 지정
  • String ( Default : #FF9436 )
captionuse
  • Node 의 Caption 사용 여부를 설정
  • Boolean ( Default : false )
selection


use
  • Selection 에 대한 사용 여부를 설정
  • Boolean ( Default : true )
backgroundColor
  • Selection 의 배경 색상을 지정
  • String ( Default : #1E90FF )
borderColor
  • Selection 의 배경 색상을 지정
  • String ( Default : #FFFFFF )
borderWidth
  • Selection 의 테두리 두께를 지정
  • Number ( Default : 3 )
tooltipuse
  • Node 의 Tooltip 사용 여부를 설정
  • Boolean ( Default : false )
formatter
  • 사용자 지정 Tooltip 설정
  • Function ( Default : undefined )
  • DOM 구조의 문자열을 return 하면, 해당 DOM 을 Tooltip 으로 표시

Example Code
/*
* args
*   : row (DataRow)
*/
formatter: function(args) {
    return "<div></div>"
}
  • arguments 정보
    1. idx [number] : 해당 Node 에 대한 Index 정보
    2. row [DataRow] : MouseOver Node 에 대한 DataRow 정보
    3. ds [DataSet] : 노드에 대한 전체 DataSet 정보
eventclick
  • Node Click 에 대한 이벤트 기능을 정의
  • Function ( Default : undefined )
  • 선택한 Node 및 하위 Node 들에 대한 정보를 전달

    Example Code
    click: function(s, args) {
        (...)
    }
  • arguments 정보
    1. s [TreeLayout] : 해당 TreeLayout Component 객체
    2. args
      1. selectObject [Node] : 선택한 Node
      2. subNodes [Array]
        1. idx [number] : Node Index
        2. row [DataRow] : Node 에 대한 데이터
      3. linkDataTable [DataTable] : Link 의 DataTable 정보
      4. dataSet [DataSet] : Node 전체 DataSet 정보
doubleClick
  • Node Double Click 에 대한 이벤트 기능을 정의
  • Function ( Default : undefined )
  • 선택한 Node 및 하위 Node 들에 대한 정보를 전달

Example Code
dobuleClick: function(s, args) {
    (...)
}
  • arguments 정보
    1. s [TreeLayout] : 해당 TreeLayout Component 객체
    2. args
      1. selectObject [Node] : 선택한 Node
      2. subNodes [Array]
        1. idx [number] : Node Index
        2. row [DataRow] : Node 에 대한 데이터
      3. linkDataTable [DataTable] : Link 의 DataTable 정보
      4. dataSet [DataSet] : Node 전체 DataSet 정보
Link



fromField
  • Link 에서 [FROM] 필드로 사용할 데이터셋의 컬럼을 지정
  • String ( Default : undefined )
toField
  • Link 에서 [TO] 필드로 사용할 데이터셋의 컬럼을 지정
  • String ( Default : undefined )
valueField
  • Link 에서 [VALUE] 필드로 사용할 데이터셋의 컬럼을 지정
  • String ( Default : undefined )
captionuse
  • Link 의 캡션 사용 여부를 결정
  • Boolean ( Default : false )
eventclick
  • Link Click 에 대한 이벤트 기능을 정의
  • Function ( Default : undefined )
  • 해당 Link 의 From, To 에 대한 Node 정보 전달

    Example Code
    click: function(args) {
        (...)
    }
  • arguments 정보
    1. s [TreeLayout] : 해당 TreeLayout Component 객체
    2. args
      1. selectObject [Link] : 선택한 Link
      2. subNodes [Array] : From, To 에 대한 Node 정보
        1. idx [number] : Node Index
        2. row [DataRow] : Node 에 대한 데이터
      3. dataSet [DataSet] : Node 전체 DataSet 정보
doubleClick
  • Link Double Click 에 대한 이벤트 기능을 정의
  • Function ( Default : undefined )
  • 해당 Link 의 From, To 에 대한 Node 정보 전달


Example Code
dobuleClick: function(args) {
    (...)
}
  • arguments 정보
    1. s [TreeLayout] : 해당 TreeLayout Component 객체
    2. args
      1. selectObject [Link] : 선택한 Link
      2. subNodes [Array] : From, To 에 대한 Node 정보
        1. idx [number] : Node Index
        2. row [DataRow] : Node 에 대한 데이터
      3. dataSet [DataSet] : Node 전체 DataSet 정보
Defaulteventclick
  • Diagram 의 빈 영역에서 Click 이벤트에 대한 기능 정의
  • Function ( Default : undefined )

    Example Code
    click: function(args) {
        (...)
    }
  • arguments 정보
      1. s [TreeLayout] : 해당 TreeLayout Component 객체

필수 옵션

  • 옵션 설정 방법
  • 옵션 값 별 정의

제약 사항

  • Node 의 DataSet 에서 DEPTH 에 대한 값이 undefined 이면, 0 으로 인식하면서, 가장 앞(왼쪽) 에 배치된다.
  • Script 를 통해 Node 에 대한 색상을 변경 후 다시 기본값으로 설정하고자 한다면, 해당 속성 값을 명시적으로 'undefined' 로 설정해야한다. ( HighlightedBgColor, HighlightedBorderColor )

샘플 정보

공유된 파일이 아직 없습니다.

변경 전/후 제품 버전

변경 전(제품 버전)

변경 전


변경 후

참고 자료

 여기를 클릭하여 펼치기...

  파일 변경됨
PNG 파일 Add-In.png 2023-06-19 by AUD팀
PNG 파일 image2023-6-19_15-1-11.png 2023-06-19 by AUD팀
PNG 파일 image2023-6-19_15-7-55.png 2023-06-19 by AUD팀
PNG 파일 image2023-6-19_15-13-32.png 2023-06-19 by AUD팀
PNG 파일 image2023-6-19_15-32-21.png 2023-06-19 by AUD팀

문서 수정 이력

버전 날짜 댓글
현재 버전 (v. 9) 2023-10-27 10:33 AUD팀
v. 8 2023-10-27 10:06 AUD팀
v. 7 2023-10-26 13:16 AUD팀
v. 6 2023-08-17 16:56 AUD팀
v. 5 2023-08-17 16:55 AUD팀
v. 4 2023-08-17 16:38 AUD팀
v. 3 2023-08-17 16:26 AUD팀
v. 2 2023-08-17 15:48 AUD팀
v. 1 2023-06-19 17:11 AUD팀

BCRM 정보

(BCRM접수번호)제목


...

  • 레이블 없음