WebSquare.uiplugin.dataList

데이터 통신 및 화면에서 사용할 여러 건의 데이터를 저장하는 객체
데이터컬렉션 하위에 생성되며 데이터의 구조를 정의하는 columnInfo 영역과 초기 값을 정의하는 데이터 영역으로 나뉨
columnInfo 영역(source : <w2:columnInfo>)은 컬럼의 정보가 있으며 아이디 속성에 컬럼의 이름을 정의하고 그 밖에 데이터 가공 등을 위한 속성들을 정의할 수 있음
데이터 영역(source : <w2:data>)은 컬럼의 초기 값을 정의하는 곳이며 use data가 체크되어 있어야(source : <w2:data use="true">) 초기값이 적용됨
행마다 사용자 제어에 따른 삽입/수정/삭제 등의 상태값을 가지고 있으며 getter API로 상태별 데이터를 꺼내올 수 있고 상세 내용은 아래와 같음 (상태값) status : R / statusValue : 0 - 초기 상태 (변화 없음) status : U / statusValue : 1 - 갱신 (update API 호출 시) status : C / statusValue : 2 - 삽입 (insert API 호출 시) status : D / statusValue : 3 - 삭제 (delete API 호출 시) status : V / statusValue : 4 - 삽입 후 삭제 (insert API 후 delete API 호출) status : E / statusValue : 5 - 제거 (remove API 호출 시)

Type

uiplugin

Property Summary

attributeMap: 데이터 타입이 XML일 경우만 적용이 되는 기능으로 rootNode에 추가 특성을 지정하고자 하는 DataMap의 이름
baseNode: [default:list] 데이터 타입이 XML일 경우만 적용되며, 데이터를 XML로 변환 시 rootNode로 정의할 XPath를 명시
getMatchedFromAllData: [default:false, true] Match 정보의 조회 시, 데이터 비교 방법 설정
id: DataList 아이디
idAttribute: 데이터 타입이 XML일 경우만 적용이 되는 기능
initRowPosition: DataList 생성 시 설정할 행의 인덱스
length: 컬럼의 데이터 길이
matchIgnoreCase: [default:false, true] Match 정보의 조회 시, 대소문자 구별 여부
nullYNType: 컬럼 속성이 nullYN인 컬럼에서 공백 값에 대한 처리를 지정하는 속성
removedDataMatch: [default:true, false] XML 조회 API 호출 시 반환되는 XML의 구조가 제거 상태인 것을 별도 구조로 할지에 대한 옵션
removeDummyRowStatus: [default:true, false] XML 조회 API 호출 시 반환하는 XML에 행의 상태값이 갱신에서 제거로 바뀐 데이터를 포함할지 여부
repeatNode: [default:map] 데이터 타입이 XML일 경우만 적용되며, 데이터를 XML로 변환 시 반복이 되는 데이터의 노드로 정의할 XPath를 명시
rowNumData: [default:false, true] 엔진 내부에서 행의 순서(인덱스+1)를 rowNum 속성으로 할당하여 반환할지의 여부
rowStatusNodeName: [default:rowStatus] JSON 또는 XML 형태로 데이터를 가져올 때 rowStatus 키 이름을 설정하는 기능
saveRemovedData: [default:false, true] 행의 상태값이 삭제인 데이터(removeRow API로 삭제한 데이터)를 관리할지의 여부
sortType: GridView의 sortable 속성 적용 시 데이터 정렬 기준 (GridView와 바인딩된 경우에 영향을 받는 속성)
undoRecursiveRow: GridView 컬럼의 inputType이 drilldown인 경우, undoRow() 함수 실행 시 대상이 되는 행과 그 하위의 모든 행들도 undoRow() 함수가 실행되도록 설정
userData1: 사용자 정의 데이터 속성
userData2: 사용자 정의 데이터 속성
userData3: 사용자 정의 데이터 속성
validateAllItemsetData: [default:false, true] selectbox 또는 autoComplete 컴포넌트와 연동된 상태에서, 필터가 된 경우에도 모든 데이터를 대상으로 유효성 검사를 할 지 여부
valueAttribute: 실제 데이터를 특성에 할당할 때 사용 (데이터 타입이 XML일 경우만 적용)

Event Summary

onaftercolumnfilterchange: 사용자에 의해서 컬럼에 적용된 필터가 변경된 이후에 이벤트가 발생
onbeforecelldatachange: 하나의 셀에 대한 값이 변경되기 직전에 발생하며 변경된 값을 DataList에 적용 여부를 정할 수 있음
onbeforecolumnfilterchange: 사용자에 의해서 컬럼에 적용된 필터가 바뀌기 직전에 이벤트가 발생
onbeforerowpositionchange: DataList의 행의 위치가 변경되기 직전에 발생하여 변경 적용 여부를 결정
oncelldatachange: 하나의 셀에 대한 값이 변경된 경우 발생
ondataload: DataList의 데이터가 전체적으로 변경(set)되는 경우 발생하며 데이터가 변경된 이후 이벤트가 발생
oninsertrow: 새로운 행이 추가된 후에 발생 (여러 행이 동시에 추가되면 한번만 발생)
onremoverow: 행이 제거된 후에 발생 (여러 행이 동시에 제거되면 한번만 발생)
onrowpositionchange: 행의 인덱스가 변경된 경우에 발생
onrowstatuschange: 사용자에 의해서 행의 상태가 변경되는 경우 이벤트가 발생

Method Summary

bind( eventType , function ): DataList의 이벤트를 동적으로 할당함
clearFilter( ): 현재 DataList에 적용된 필터링을 모두 해제
clearSort( ): 데이터의 정렬을 취소하며 GridView 컴포넌트의 정렬도 함께 취소됨
deleteRow( rowIndex ): rowIndex에 해당하는 행이 삭제되지 않으며 상태값만 삭제(D)로 변경됨
deleteRows( rowIndexArr ): 여러 건의 행의 인덱스가 담긴 배열을 통해 한번에 삭제(D)로 변경하고 가지고 있던 데이터를 2차원 배열로 반환
getAllArray( ): DataList의 전체 데이터를 컬럼의 정보와 1차원 배열로 변환된 실제 데이터를 JSON에 담아 반환함
getAllData( ): DataList의 전체 데이터를 1차원 배열로 반환함
getAllFilteredData( ): 필터가 적용된 데이터 전체를 배열로 반환
getAllFilteredJSON( ): 필터가 적용된 데이터 전체를 JSON이 담긴 배열로 반환
getAllFilteredXML( ): 필터가 적용된 데이터 전체를 XML로 반환
getAllJSON( ): DataList의 1row의 값을 JSON으로 변환하여 전체 데이터를 1차원 배열에 담아 반환함
getAllXML( ): DataList의 전체 데이터를 XML로 반환
getCellAllData( realRowIndex , colInfo ): 필터링되지 않은 rowIndex를 기준으로 getCellData를 실행
getCellData( rowIndex , colInfo ): rowIndex와 colInfo( 컬럼의 인덱스 또는 아이디 )에 해당하는 셀의 데이터를 반환
getColData( colInfo ): 컬럼의 인덱스 또는 아이디에 해당하는 열의 데이터(필터나 정렬이 적용 되지 않은)를 배열로 반환
getColumnDistinctDataArray( column ): 지정한 인덱스 또는 아이디에 해당하는 컬럼에서 중복된 데이터를 제거한 후, 오름차순으로 정렬된 데이터를 배열로 반환
getColumnID( colIndex ): DataList에 정의된 컬럼의 인덱스를 받아 컬럼의 아이디를 반환
getColumnIndex( colID ): DataList에 정의된 컬럼의 아이디를 받아 컬럼의 인덱스를 반환
getColumnInfo( columnID ): DataList 특정 컬럼의 세부 정보를 조회
getColumnName( columnInfo ): DataList에 정의된 컬럼의 인덱스 또는 아이디를 받아 컬럼에 정의된 이름을 반환
getDataRow( rowIndex ): rowIndex에 해당하는 행의 데이터를 컬럼의 아이디를 키(key)로 하는 해쉬 형태로 반환
getDeletedArray( ): 삭제 상태(상태값: D, E, V)인 행들의 정보가 담긴 JSON
getDeletedData( ): 삭제 상태(상태값: D, E, V)인 행들의 데이터가 담긴 2차원 배열
getDeletedIndex( ): 삭제 상태(상태값: D, V, 3, 4)인 행의 인덱스를 배열로 반환함 (삭제 API로 삭제된 E상태의 행은 반환되지 않음)
getDeletedJSON( ): 삭제 상태(상태값: D, E, V)인 행들의 데이터를 JSON으로 변환 후, 배열에 담아 반환함
getDeletedXML( ): 삭제 상태(상태값: D, E, V)인 행들의 데이터를 XML로 반환함
getFilteredColData( colInfo ): 필터 및 정렬이 적용된 열의 데이터를 배열로 반환
getFilteredRowIndex( realRowIndex ): 필터링된 상태의 행 인덱스를 반환
getFilterList( ): 필터링된 DataList의 컬럼 별 필터링 상태를 반환
getFusionChartData( chartType , labelNode , seriesColumns ): DataList를 FusionChart의 JSON 데이터로 반환함
getFusionChartSimpleData( chartType , labelNode , seriesNode , valueNode ): DataList의 데이터를 FusionChart의 simple 모드인 singleSerise, multiSeries 차트의 JSON 데이터로 반환
getID( ): DataList 객체의 아이디를 반환하고 객체의 아이디 속성과 동일한 값을 반환함
getInfo( ): DataList의 세부 정보를 조회
getInsertedArray( ): 삽입 상태(상태값: C)인 행들의 정보가 담긴 JSON
getInsertedData( ): 삽입 상태(상태값: C)인 행들의 데이터가 담긴 2차원 배열
getInsertedIndex( ): 삽입 상태(상태값: C)인 행의 인덱스를 배열에 담아 반환함
getInsertedJSON( ): 삽입 상태(상태값: C)인 행들의 데이터를 JSON으로 변환하여 배열에 담아 반환함
getInsertedXML( ): 삽입 상태(상태값: C)인 행들의 데이터를 XML로 반환함
getMatchedArray( colInfo , dataValue , exactMatch , stRowIndex , lastRowIndex ): stRowIndex부터 lastRowIndex까지의 범위의 행 중에서 colInfo에 해당하는 값이 dataValue와 같은 행들의 컬럼 정보 및 데이터를 담은 JSON을 반환함
getMatchedColumnData( matchCol , dataValue , targetCol , exactMatch , stRowIndex , lastRowIndex ): stRowIndex부터 lastRowIndex까지의 범위의 행 중에서 matchCol에 해당하는 값이 dataValue와 같은 행들을 찾아서 targetCol에 해당하는 값을 1차원 배열로 반환함
getMatchedData( colInfo , dataValue , exactMatch , stRowIndex , lastRowIndex ): stRowIndex부터 lastRowIndex까지의 범위의 행 중에서 colInfo의 값이 dataValue와 같은 행들의 데이터를 2차원 배열로 반환함
getMatchedIndex( colInfo , dataValue , exactMatch , stRowIndex , lastRowIndex ): stRowIndex부터 lastRowIndex까지의 범위의 행 중에서 colInfo의 값이 dataValue와 같은 행들의 인덱스를 반환함
getMatchedJSON( colInfo , dataValue , exactMatch , stRowIndex , lastRowIndex ): stRowIndex부터 lastRowIndex까지의 범위의 행 중에서 colInfo의 값이 dataValue와 같은 행들의 JSON 데이터를 배열에 담아 반환함
getMatchedXML( colInfo , dataValue , exactMatch , stRowIndex , lastRowIndex ): stRowIndex부터 lastRowIndex까지의 범위의 행 중에서 colInfo의 값이 dataValue와 같은 행들의 데이터를 XML로 반환함
getModifiedArray( ): 변경 상태(상태값: C, U, D, E)행들의 정보가 담긴 JSON
getModifiedData( ): 변경 상태(상태값: C, U, D, E)행들의 데이터를 배열로 반환
getModifiedIndex( ): 변경 상태(상태값: C, U, D)행들의 인덱스를 배열로 반환함
getModifiedJSON( options ): 데이터가 삽입, 갱신, 삭제, 제거된 상태(상태값: U, C, D, E, 1, 2, 3, 5)의 행들의 데이터를 JSON으로 변환하여 1차원 배열에 담아 반환함
getModifiedXML( options ): 데이터가 변경된 상태(상태값: U, C, D, E, 1, 2, 3, 5)의 행들의 데이터를 XML로 반환
getObjectType( ): 데이터컬렉션 형식 반환
getOnlyDeletedArray( ): 삭제 상태(상태값:D, E) 행들의 정보를 담은 JSON을 반환
getOnlyDeletedData( ): 삭제 상태(상태값: D, E) 행들의 배열 데이터를 배열에 담아 반환 (2차원 배열)
getOnlyDeletedIndex( ): 삭제 상태(상태값: D) 행들의 인덱스를 배열로 반환
getOnlyDeletedJSON( ): 삭제 상태(상태값:D, E) 행들의 JSON 데이터를 배열에 담아 반환
getOnlyDeletedXML( ): 삭제 상태(상태값: D, E) 행들의 데이터를 XML로 반환
getOption( attr ): 속성명으로 DataList에 정의된 속성의 값을 반환
getOriginalCellData( rowIndex , colIndex ): rowIndex와 colIndex에 해당하는 셀의 초기 데이터(최초의 데이터)를 반환
getParentRowIndex( rowIndex ): 드릴다운 사용 시 행 인덱스에 해당하는 행의 부모 행의 인덱스를 반환
getRangeArray( from , to ): from부터 to까지 인덱스 범위의 컬럼 정보와 데이터를 담은 JSON을 반환
getRangeData( from , to ): from부터 to까지 인덱스 범위 데이터를 1차원 배열로 반환
getRangeJSON( from , to ): from부터 to까지 인덱스 범위 JSON 데이터를 담은 1차원 배열 반환
getRangeXML( from , to ): from부터 to까지 인덱스 범위 데이터를 XML로 반환
getRealRowIndex( ): 실제 행의 인덱스를 반환
getRecursiveRowIndex( rowIndex ): depthColumn 사용 시 기준 rowIndex의 하위에 속한 모든 행의 인덱스를 배열로 반환
getRowArray( rowIndex ): rowIndex에 해당하는 행들의 정보가 담긴 JSON을 반환
getRowCount( ): 화면에 보여지는 행의 건수를 반환
getRowData( rowIndex ): rowIndex에 해당하는 행의 데이터를 배열로 반환
getRowIndexByStatus( statusStr ): 상태 코드가 일치하는 행의 인덱스를 배열로 반환
getRowJSON( rowIndex ): rowIndex에 해당하는 행의 데이터를 JSON 객체로 반환
getRowPosition( ): 현재 선택한 행 인덱스 확인
getRowStatus( rowIndex ): rowIndex에 해당하는 행의 상태 코드(문자) 반환 (초기상태:"R", 갱신:"U", 삽입:"C", 삭제:"D", 삽입 후 삭제:"V")
getRowStatusValue( rowIndex ): rowIndex에 해당하는 행의 상태 코드를 숫자로 반환 (초기상태:0, 갱신:1, 삽입:2, 삭제:3, 삽입 후 삭제:4)
getRowXML( rowIndex ): rowIndex에 해당하는 행의 데이터를 XML로 반환
getScope( ): 컴포넌트가 scope=true인 WFrame의 자식 컴포넌트일 때 해당 부모 WFrame 객체를 반환
getScopeWindow( ): 컴포넌트가 scope=true인 WFrame의 자식 컴포넌트일 때 해당 부모 WFrame의 Scope객체를 반환
getTotalCol( ): DataList에 정의된 컬럼 수를 반환
getTotalRow( ): DataList의 전체 행 수를 반환
getUnmatchedArray( col , dataValue , exactMatch , stRowIndex , lastRowIndex ): 입력된 col에 해당하는 컬럼의 행 인덱스가 stRowIndex부터 lastRowIndex까지의 범위 중에서 데이터가 dataValue와 다른 행들의 정보를 JSON으로 변환하여 반환
getUnmatchedColumnData( matchCol , dataValue , targetCol , exactMatch , stRowIndex , lastRowIndex ): matchCol에 해당하는 컬럼의 행 인덱스가 stRowIndex부터 lastRowIndex까지의 범위 중에서 데이터가 dataValue와 다른 행을 찾아서 targetCol에 해당하는 컬럼의 데이터를 배열로 반환
getUnmatchedData( col , dataValue , exactMatch , stRowIndex , lastRowIndex ): col에 해당하는 컬럼의 행의 인덱스가 stRowIndex부터 lastRowIndex까지 범위 중에서 데이터가 dataValue와 다른 행들의 데이터를 배열로 변환하여 배열에 담아 반환
getUnmatchedIndex( col , dataValue , exactMatch , stRowIndex , lastRowIndex ): col에 해당하는 컬럼의 행의 인덱스가 stRowIndex부터 lastRowIndex까지 범위 중에서 데이터가 dataValue와 다른 행들의 인덱스를 배열로 반환
getUnmatchedJSON( col , dataValue , exactMatch , stRowIndex , lastRowIndex ): col에 해당하는 컬럼의 rowIndex가 stRowIndex부터 lastRowIndex 까지의 범위 중 데이터가 dataValue와 다른 행들의 데이터를 JSON으로 변환하여 배열에 담아 반환
getUnmatchedXML( col , dataValue , exactMatch , stRowIndex , lastRowIndex ): col에 해당하는 컬럼의 행의 인덱스 stRowIndex부터 lastRowIndex까지 범위 중에서 데이터가 dataValue와 다른 행들의 데이터를 XML로 반환
getUpdatedArray( ): 갱신 상태(상태값: 1, U)인 행들의 데이터의 정보를 JSON으로 반환
getUpdatedData( ): 갱신 상태(상태값: 1, U)인 행들의 배열 데이터를 배열에 담아 반환
getUpdatedIndex( ): 갱신 상태(상태값: 1, U)인 행의 인덱스를 배열로 반환
getUpdatedJSON( ): 갱신 상태(상태값: 1, U)인 행들의 데이터를 JSON으로 변환하여 배열에 담아 반환
getUpdatedXML( ): 갱신 상태(상태값: 1, U)인 행들의 데이터를 XML로 반환
getVoidArray( ): 삽입 후 삭제 상태(상태값: 4, V)인 행들의 정보가 담긴 JSON을 반환
getVoidData( ): 삽입 후 삭제 상태(상태값: 4, V)인 행들을 배열 데이터를 배열에 담에 반환
getVoidIndex( ): 삽입 후 삭제 상태(상태값: 4, V)인 행의 인덱스를 배열로 반환
getVoidJSON( ): 삽입 후 삭제 상태(상태값: 4, V)인 행들의 JSON 데이터를 배열에 담아 반환
getVoidXML( ): 삽입 후 삭제 상태(상태값: 4, V)인 행들의 데이터를 XML로 반환
initRowStatus( ): DataList의 상태를 모두 초기 상태(상태값: R)로 변경
insertData( rowIndex , dataObj ): 지정한 인덱스에 다건의 행을 1차원 배열로 삽입
insertJSON( rowIndex , dataObj ): 지정한 인덱스에 다건의 행을 JSON 객체로 삽입
insertRow( rowIndex ): 1건의 행을 삽입 (데이터는 추가되지 않음)
insertXML( rowIndex , dataObj ): 지정한 인덱스에 다건의 행을 XML 데이터로 삽입
keepDataType( ): 데이터를 세팅할 때나 뷰를 통해 데이터를 수정하는 경우, dataType이 number인 데이터에 한해 number로 타입캐스팅하도록 하는 기능
keepRowPosition( ): JSON 데이터를 추가할 때 이전에 설정된 행의 위치를 유지할지 여부
loadData( options ): 서버 요청을 통해 받은 데이터를 DataList에 추가
modifyAllStatus( status ): 모든 행의 상태를 변경
modifyMatchedStatus( col , dataValue , status ): 해당하는 컬럼의 값과 지정한 값이 일치하는 행의 상태를 변경
modifyRangeStatus( from , to , status ): 지정한 범위의 행의 상태를 변경
modifyRowStatus( rowIndex , status ): 지정한 행의 상태를 변경
multisort( options ): 여러 개의 컬럼을 정렬 (컬럼의 dataType 속성을 기준으로 정렬되므로 숫자 형태인 경우 dataType 속성을 number로 정의해야 함)
preserveType( ): preserveType="true" 설정시 dataType이 number/text인 데이터에 한해 number/text로 타입캐스팅)
redo( ): restore()한 값을 다시 한 단계 되돌림
reform( ): 최초 설정 데이터를 현재의 데이터로 바꾸고, 모든 행의 상태를 초기 상태(R)로 변경
removeAll( ): 모든 데이터를 삭제하고 삭제된 데이터를 1차원 배열로 반환
removeColumnFilter( col ): 지정한 컬럼에 적용된 필터를 삭제
removeColumnFilterAll( ): 모든 컬럼에 적용된 필터를 삭제
removeRange( startIdx , endIdx ): 지정한 범위의 행들을 삭제하고, 삭제된 데이터들을 1차원 배열로 반환
removeRow( rowIndex ): 지정한 행을 삭제하고, 삭제된 데이터를 1차원 배열로 반환
removeRows( rowIndexArr ): 여러 행을 한번에 삭제하고, 삭제된 데이터들을 2차원 배열로 반환
restore( ): 데이터를 변경 한 단계 전으로 되돌림 (한번 수행 시마다 한 단계씩 되돌아감)
rowMoveDown( rowIndex ): DataList를 기준으로, 지정한 행과 한 줄 아래 행의 순서를 바꿈
rowMoveDownFiltered( rowIndex ): 화면에 보이는 순서를 기준으로, 지정한 행과 한 줄 아래 행의 순서를 바꿈
rowMoveUp( rowIndex ): DataList를 기준으로, 지정한 행과 한 줄 위에 행의 순서를 바꿈
rowMoveUpFiltered( rowIndex ): 화면에 보이는 순서를 기준으로, 지정한 행과 한 줄 위에 행의 순서를 바꿈
setArray( jsonData , append ): 1차원 배열의 데이터를 지정한 컬럼 순서대로 DataList에 설정함
setBroadcast( flag , refresh ): API로 데이터 변경 시, DataList와 바인딩(Binding)된 컴포넌트(화면)에 변경 내용을 적용할지 여부를 설정
setCellAllData( realRowIndex , colIndex , data ): 필터가 적용되어 있는 경우, 필터링되지 않은 행의 인덱스를 기준으로 setCellData()를 실행한 후 필터 상태를 갱신함
setCellData( rowIndex , colIndex , data ): 원하는 셀에 데이터를 설정함
setColumnDefaultValue( colIndex , defaultValue ): 행을 삽입하거나 초기 데이터를 설정할 때 지정한 컬럼에 기본 값을 할당함
setColumnFilter( filterOptions ): 지정한 컬럼에 필터 적용
setData( arr , append , columnArr , rowStatus ): 1차원 배열 데이터를 설정하거나 추가함
setIgnoreStatus( flag ): DataList 컬럼 속성인 ignoreStatus를 동적으로 제어함 (ignoreStatus가 true이면 해당 컬럼의 값이 변경되어도 행의 상태가 변하지 않음)
setJSON( jsonData , append ): JSON 데이터를 설정하거나 추가함
setMatchIgnoreCase( flag ): Match 정보의 조회 시, 대소문자를 구별할지 여부를 설정
setRowArray( rowIndex , dataObj , overwrite ): 지정한 인덱스에 1건(행)의 배열 데이터를 넣음
setRowData( rowIndex , rowData , overwrite ): 지정한 인덱스에 1건(행)의 배열 데이터를 넣음
setRowJSON( rowIndex , rowData , overwrite ): 지정한 인덱스에 1건(행)의 JSON 데이터를 넣음
setRowNumData( flag ): DataList의 get 관련 API의 반환 값 형식이 JSON 또는 XML일 경우 행의 순번 값을 추가할지 설정
setRowPosition( position , noEvent ): DataList와 연동된 컴포넌트에서 선택할 행의 위치를 설정함
setRowXML( rowIndex , XML , overwrite ): 지정한 행에 1건의 XML 데이터를 넣음
setXML( xmlData , append ): XML 데이터를 설정(set)하거나 추가(append) (행의 상태는 초기 상태인 "R"로 변경됨)
sort( bodyColumnID , sortType ): 단건의 컬럼을 정렬 (다건의 경우 multisort() API를 이용)
trigger( type , array ): DataList에 등록된 이벤트를 발생시킴
unbind( type , function ): DataList의 이벤트를 동적으로 제거
undeleteRow( rowIndex ): 지정한 인덱스에 해당하는 행의 삭제 상태(상태값: D, V)를 취소하고 직전 상태값으로 변경함
undoAll( ): 전체 데이터를 최초 설정 데이터로 바꾸고, 행의 상태를 초기 상태(R)로 변경함
undoRow( rowIndex ): 행의 데이터와 상태를 직전 데이터와 상태로 변경

Property Detail

attributeMap: 데이터 타입이 XML일 경우만 적용이 되는 기능으로 rootNode에 추가 특성을 지정하고자 하는 DataMap의 이름
본 속성에 명시된 DataMap의 키(Key)와 값(Value)이 rootNode의 특성 이름과 값(Value)으로 정의됨
baseNode: [default:list] 데이터 타입이 XML일 경우만 적용되며, 데이터를 XML로 변환 시 rootNode로 정의할 XPath를 명시
getMatchedFromAllData: [default:false, true] Match 정보의 조회 시, 데이터 비교 방법 설정
id: DataList 아이디
전역 객체로 할당되며 서브미션 및 각종 API 사용 시 데이터를 구분하기 위한 키(Key)로 사용됨
idAttribute: 데이터 타입이 XML일 경우만 적용이 되는 기능
DataList의 아이디에 정의된 값을 아이디 특성이 아닌 다른 특성으로 정의하고자 할 경우 사용됨
initRowPosition: DataList 생성 시 설정할 행의 인덱스
length: 컬럼의 데이터 길이
matchIgnoreCase: [default:false, true] Match 정보의 조회 시, 대소문자 구별 여부
nullYNType: 컬럼 속성이 nullYN인 컬럼에서 공백 값에 대한 처리를 지정하는 속성
removedDataMatch: [default:true, false] XML 조회 API 호출 시 반환되는 XML의 구조가 제거 상태인 것을 별도 구조로 할지에 대한 옵션
구 버전 엔진의 하위 호환을 위해 만든 옵션이므로 true로 설정하고 사용
removeDummyRowStatus: [default:true, false] XML 조회 API 호출 시 반환하는 XML에 행의 상태값이 갱신에서 제거로 바뀐 데이터를 포함할지 여부
(갱신에서 제거로 바뀐 대표적인 경우는 insertRow 후 removeRow한 경우)
saveRemovedData 속성이 true일 때만 유효
removeDummyRowStatus 값이 true인 경우는 insertRow했다가 removeRow한 데이터는 관리하지 않음
repeatNode: [default:map] 데이터 타입이 XML일 경우만 적용되며, 데이터를 XML로 변환 시 반복이 되는 데이터의 노드로 정의할 XPath를 명시
rowNumData: [default:false, true] 엔진 내부에서 행의 순서(인덱스+1)를 rowNum 속성으로 할당하여 반환할지의 여부
rowStatusNodeName: [default:rowStatus] JSON 또는 XML 형태로 데이터를 가져올 때 rowStatus 키 이름을 설정하는 기능
saveRemovedData: [default:false, true] 행의 상태값이 삭제인 데이터(removeRow API로 삭제한 데이터)를 관리할지의 여부
sortType: GridView의 sortable 속성 적용 시 데이터 정렬 기준 (GridView와 바인딩된 경우에 영향을 받는 속성)
undoRecursiveRow: GridView 컬럼의 inputType이 drilldown인 경우, undoRow() 함수 실행 시 대상이 되는 행과 그 하위의 모든 행들도 undoRow() 함수가 실행되도록 설정
userData1: 사용자 정의 데이터 속성
API를 통해 설정한 값을 얻어올 수 있음
userData2: 사용자 정의 데이터 속성
API를 통해 설정한 값을 얻어올 수 있음
userData3: 사용자 정의 데이터 속성
API를 통해 설정한 값을 얻어올 수 있음
validateAllItemsetData: [default:false, true] selectbox 또는 autoComplete 컴포넌트와 연동된 상태에서, 필터가 된 경우에도 모든 데이터를 대상으로 유효성 검사를 할 지 여부
ex) selectbox가 dlt_dataList1과 연동되어있고, dlt_dataList1의 값이 [1,2,3,4]인 상황에서 필터를 걸어서 [1,2]만 남은 경우, selectbox1.setValue("3")을 한 경우에 "3"이 타당한 값이라고 판단하도록 하는 옵션
valueAttribute: 실제 데이터를 특성에 할당할 때 사용 (데이터 타입이 XML일 경우만 적용)

Event Detail

onaftercolumnfilterchange

사용자에 의해서 컬럼에 적용된 필터가 변경된 이후에 이벤트가 발생

Sample

<w2:dataList id="dlt_dataList1" ev:onaftercolumnfilterchange="scwin.dlt_dataList1_onaftercolumnfilterchange"> ... </w2:dataList> scwin.dlt_dataList1_onaftercolumnfilterchange = function() { alert("onaftercolumnfilterchange = " + this.getRowCount()); }

onbeforecelldatachange

하나의 셀에 대한 값이 변경되기 직전에 발생하며 변경된 값을 DataList에 적용 여부를 정할 수 있음
이벤트 핸들러에서 반환 값을 false로 두면 셀 값의 변경을 취소하고 이전 데이터로 되돌리며, 그 외에는 변경된 값을 적용

Parameter
name	type	description
info	JSON	셀 데이터 정보

Sample

<w2:dataList id="dlt_dataList1" ev:onbeforecelldatachange="scwin.dlt_dataList1_onbeforecelldatachange"> ... </w2:dataList> scwin.dlt_dataList1_onbeforecelldatachange = function(info) { var rowIndex = info.rowIndex; var colID = info.colID; var oldValue = info.oldValue; var newValue = info.newValue; //셀의 데이터 변경을 중지하고 싶은 경우 아래와 같이 return false를 적용 //return false; }

onbeforecolumnfilterchange

사용자에 의해서 컬럼에 적용된 필터가 바뀌기 직전에 이벤트가 발생

Sample

<w2:dataList id="dlt_dataList1" ev:onbeforecolumnfilterchange="scwin.dlt_dataList1_onbeforecolumnfilterchange"> ... </w2:dataList> scwin.dlt_dataList1_onbeforecolumnfilterchange = function() { alert("onbeforecolumnfilterchange = " + this.getRowCount()); }

onbeforerowpositionchange

DataList의 행의 위치가 변경되기 직전에 발생하여 변경 적용 여부를 결정
반환 값이 false면 변경이 취소되고 그 외 값을 반환할 경우 적용됨
(필터 사용 시 필터가 적용된 상태 기준으로 동작)

Parameter
name	type	description
info	JSON	이동할 행의 정보

Sample

<w2:dataList id="dlt_dataList1" ev:onbeforerowpositionchange="scwin.dlt_dataList1_onbeforerowpositionchange"> ... </w2:dataList> scwin.dlt_dataList1_onbeforerowpositionchange = function (info) { var oldRowIndex = info.oldRowIndex; var newRowIndex = info.newRowIndex; var oldRowData = this.getRowData(oldRowIndex); //return false인 경우 변경 취소 //return false; }

oncelldatachange

하나의 셀에 대한 값이 변경된 경우 발생
행이 추가, 삭제되는 등 구조 변경이나 API에 의해 복수의 셀 값이 한번에 변경되는 경우(setJSON ,insertJSON, setRowData 등) 이벤트가 발생하지 않음
(필터 사용 시 필터가 적용된 상태 기준으로 동작)

Parameter
name	type	description
info	JSON:Y	셀 데이터 정보

Sample

<w2:dataList id="dlt_dataList1" ev:oncelldatachange="scwin.dlt_dataList1_oncelldatachange"> ... </w2:dataList> scwin.dlt_dataList1_oncelldatachange = function (info) { var rowIndex = info.rowIndex; var colID = info.colID; var oldValue = info.oldValue; var newValue = info.newValue; }

ondataload

DataList의 데이터가 전체적으로 변경(set)되는 경우 발생하며 데이터가 변경된 이후 이벤트가 발생
setJSON, setXML, setData와 같은 API가 해당(append 할 경우 포함)
단, removeAll 호출에는 이벤트가 발생하지 않고 onremoverow 이벤트가 발생

Sample

<w2:dataList id="dlt_dataList1" ev:ondataload="scwin.dlt_dataList1_ondataload"> ... </w2:dataList> scwin.dlt_dataList1_ondataload= function () { alert ("dataList에 data 설정이 완료되었습니다."); }

oninsertrow

새로운 행이 추가된 후에 발생 (여러 행이 동시에 추가되면 한번만 발생) (관련 함수) insertRow(); insertData(); insertJSON(); insertXML();
(참고 사항) setJSON과 같은 API를 append 모드로 호출하는 경우 해당 이벤트는 발생하지 않고 ondataload 이벤트가 호출됨 (append 모드로 데이터가 추가되는 것은 insertRow와 다르게 취급됨)

Parameter
name	type	description
info	JSON	추가된 데이터의 정보를 담고 있는 JSON 객체

Sample

onremoverow

행이 제거된 후에 발생 (여러 행이 동시에 제거되면 한번만 발생) (관련 함수) removeRow(); removeRows(); removeRange(); removeAll();
(참고 사항) setJSON API에 의해 데이터 전체가 변경되는 경우 해당 이벤트는 발생하지 않고 ondataload 이벤트가 호출됨 deleteRow API와 같이 행이 제거되지 않고 행의 상태만 변경되는 API 호출 시에도 해당 이벤트는 발생하지 않음

Parameter
name	type	description
info	JSON	제거된 데이터의 정보를 담고 있는 removedDataObj를 반환

Sample

onrowpositionchange

행의 인덱스가 변경된 경우에 발생

Parameter
name	type	description
info	JSON	행의 이동에 관한 정보를 포함한 JSON

Sample

onrowstatuschange

사용자에 의해서 행의 상태가 변경되는 경우 이벤트가 발생
상태가 변경된 각 행의 정보를 담고 있는 객체들의 배열이 이벤트 핸들러에 인자로 전달됨
(단건 또는 다건이 변경되었을 경우, 모든 변경 사항을 포함하는 배열이 전달)

Parameter
name	type	description
info	Array	상태가 변경된 행의 정보를 담고 있는 객체들의 배열

Sample

<w2:dataList id="dlt_dataList1" ev:onrowstatuschange="scwin.dlt_dataList1_onrowstatuschange"> ... </w2:dataList> scwin.dlt_dataList1_onrowstatuschange = function (info) { for (var i = 0; i < info.length; i++) { var rowIndex = info[i].rowIndex; // 상태가 변경된 행의 인덱스 var oldRowStatus = info[i].oldRowStatus; // 이전의 행 상태 var newRowStatus = info[i].newRowStatus; // 변경된 행 상태 } }

Method Detail

bind( eventType , function )

DataList의 이벤트를 동적으로 할당함

Parameter
name	type	required	description
eventType	String	Y	동적으로 할당할 이벤트의 이름
function	Function	Y	동적으로 할당할 이벤트의 핸들러 함수

Sample

//DataList의 아이디가 dlt_dataList1인 경우 dlt_dataList1.bind("onsetdata", function(e){ alert("date setting");}); //이벤트 함수를 commObj.fn_dcDataChange으로 정의한 경우 dlt_dataList1.bind("oncelldatachange", commObj.fn_dcDataChange );

clearFilter( )

현재 DataList에 적용된 필터링을 모두 해제 (관련 함수) setColumnFilter (컬럼 별로 필터링을 설정)

Sample

// GridView의 'dept' 컬럼을 IT로 필터링 // GridView의 'dept' 컬럼이 IT인 행만 표시됨 dlt_dataList1.setColumnFilter( {type:'row', colIndex:'dept', key:"IT", condition:'and'}); // 필터링을 해제 // GridView의 'dept' 컬럼의 모든 데이터를 표시 dlt_dataList1.clearFilter();

clearSort( )

데이터의 정렬을 취소하며 GridView 컴포넌트의 정렬도 함께 취소됨

Sample

dlt_dataList1.clearSort();// 정렬을 취소

deleteRow( rowIndex )

rowIndex에 해당하는 행이 삭제되지 않으며 상태값만 삭제(D)로 변경됨
필터가 적용된 경우 필터된 상태 기준으로 동작

Parameter
name	type	required	description
rowIndex	Number	Y	삭제 상태로 변경할 행의 인덱스

Sample

// 첫 번째 row의 행의 상태값을 삭제 상태로 변경 (행의 상태: "D") dlt_dataList1.deleteRow(0);

deleteRows( rowIndexArr )

여러 건의 행의 인덱스가 담긴 배열을 통해 한번에 삭제(D)로 변경하고 가지고 있던 데이터를 2차원 배열로 반환

Parameter
name	type	required	description
rowIndexArr	Array	Y	삭제할 행들의 번호를 저장하는 배열

Return
type	description
Array	삭제한 행들이 가지고 있던 2차원 배열 데이터

Sample

//부서와 이름이 정의된 DataList의 경우 //4번째와 5번째의 행을 삭제 var rsData = dlt_dataList1.deleteRows([3,4]) //반환 값 예시 ) [["홍보","이광수"],["인사","류승룡"]]

getAllArray( )

DataList의 전체 데이터를 컬럼의 정보와 1차원 배열로 변환된 실제 데이터를 JSON에 담아 반환함

Return
type	description
JSON	컬럼 정보와 데이터가 담긴 JSON

Sample

// 아이디가 name, age인 2개 컬럼을 정의한 DataList var returnJSONArr = dlt_dataList1.getAllArray(); //반환 값 예시 - String으로 변환 { "columnInfo":["name","age"] , "data":["손예진","22","이광수","25","류승룡","32"] }

getAllData( )

DataList의 전체 데이터를 1차원 배열로 반환함 (관련 함수) getAllFilteredData (필터가 적용된 전체 데이터를 반환)

Return
type	description
Array	데이터가 담긴 1차원 배열

Sample

// 아이디가 name, age인 2개 컬럼을 정의한 DataList 일 때 var returnArr = dlt_dataList1.getAllData(); //반환 값 예시 ) ["손예진","23","이광수","25","류승룡","32"]

getAllFilteredData( )

필터가 적용된 데이터 전체를 배열로 반환 (관련 함수) getAllData (필터를 무시하고 모든 데이터를 반환)

Return
type	description
Array	필터가 적용된 데이터 전체

getAllFilteredJSON( )

필터가 적용된 데이터 전체를 JSON이 담긴 배열로 반환 (관련 함수) getAllJSON (필터를 무시하고 모든 데이터를 반환)

Return
type	description
Array	필터가 적용된 데이터 전체

getAllFilteredXML( )

필터가 적용된 데이터 전체를 XML로 반환 (관련 함수) getAllXML (필터를 무시하고 모든 데이터를 반환)

Return
type	description
XML	필터가 적용된 데이터 전체

getAllJSON( )

DataList의 1row의 값을 JSON으로 변환하여 전체 데이터를 1차원 배열에 담아 반환함 (관련 함수) getAllFilteredJSON (팔터가 적용된 전체 데이터를 반환)

Return
type	description
Array	JSON이 담긴 1차원 배열

Sample

// 아이디가 name, age인 2개 컬럼을 정의한 DataList var rsData = dlt_dataList1.getAllJSON()); //반환 값 예시 - String으로 변환 [ {name:"손예진" ,age:"22"} , {name:"이광수" ,age:"25"} , {name:"류승룡" ,age:"32"} ]

getAllXML( )

DataList의 전체 데이터를 XML로 반환 (관련 함수) getAllFilteredXML (필터를 무시하고 모든 데이터를 반환)

Return
type	description
XML	전체 데이터가 담긴 XML

Sample

// 아이디가 name, age인 2개 컬럼을 정의한 DataList var returnXMLStr = dlt_dataList1.getAllXML(); //DataList의 XML관련 속성(baseNode,repeatNode 등)을 지정하지 않은 경우 //반환 값 예시 - String으로 변환 <list id="dlt_dataList1"> <map index="0"> <age>22</age> <name>손예진</name> <rowStatus statusValue="0">R</rowStatus> </map> <map index="1"> <age>24</age> <name>이광수</name> <rowStatus statusValue="1">U</rowStatus> </map> <map index="2"> <age>32</age> <name>류승룡</name> <rowStatus statusValue="0">R</rowStatus> </map> </list>

getCellAllData( realRowIndex , colInfo )

필터링되지 않은 rowIndex를 기준으로 getCellData를 실행

Parameter
name	type	required	description
realRowIndex	Number	Y	필터링되지 않은 기준의 행의 인덱스
colInfo	Number\|\|String	Y	형식이 셀인 컬럼의 인덱스 혹은 컬럼의 아이디

Return
type	description
String	셀의 데이터

Sample

// 1, 2번 행이 필터링되어 감춰진 경우 var retVal1 = dlt_dataList1.getCellData(3,"name"); // DataList에서 5번째 행, name열의 값을 가져옴 var retVal2 = dlt_dataList1.getCellAllData(3, "name"); // DataList에서 3번째 행, name열의 값을 가져옴

getCellData( rowIndex , colInfo )

rowIndex와 colInfo( 컬럼의 인덱스 또는 아이디 )에 해당하는 셀의 데이터를 반환

Parameter
name	type	required	description
rowIndex	Number	Y	셀의 행 인덱스
colInfo	Number\|\|String	Y	셀의 컬럼 인덱스 혹은 컬럼의 아이디

Return
type	description
String	셀의 데이터

Sample

// 첫 번째 행의 "name" 컬럼에 해당하는 셀의 데이터를 반환 var returnValue = dataList1.getCellData(0, "name");

getColData( colInfo )

컬럼의 인덱스 또는 아이디에 해당하는 열의 데이터(필터나 정렬이 적용 되지 않은)를 배열로 반환 (관련 함수) getFilteredColData (필터나 정렬이 적용된 컬럼 데이터를 반환)

Parameter
name	type	required	description
colInfo	Number\|\|String	Y	데이터를 가져올 열의 인덱스 혹은 컬럼의 아이디

Return
type	description
Array	열의 데이터가 담긴 1차원 배열

Sample

//DataList 정의 예시 <w2:dataList id="dlt_dataList1"> <w2:columnInfo> <w2:column id="addr" name="주소" dataType="text"></w2:column> <w2:column id="name" name="이름" dataType="text"></w2:column> </w2:columnInfo> </w2:dataList> var returnArr = dlt_dataList1.getColData('name'); //컬럼의 아이디가 name인 데이터의 배열 //반환 값 예시 ) [ "손예진" , "이광수" , "류승룡" ]

getColumnDistinctDataArray( column )

지정한 인덱스 또는 아이디에 해당하는 컬럼에서 중복된 데이터를 제거한 후, 오름차순으로 정렬된 데이터를 배열로 반환

Parameter
name	type	required	description
column	Number\|\|String	Y	컬럼의 인덱스 또는 아이디

Return
type	description
Array	중복된 데이터를 제거한 컬럼 데이터

getColumnID( colIndex )

DataList에 정의된 컬럼의 인덱스를 받아 컬럼의 아이디를 반환

Parameter
name	type	required	description
colIndex	Number	Y	DataList에 정의된 컬럼 인덱스

Return
type	description
String	컬럼의 아이디

Sample

//DataList 정의 예시 <w2:dataList id="dlt_dataList1"> <w2:columnInfo> <w2:column id="addr" name="주소" dataType="text"></w2:column> <w2:column id="name" name="이름" dataType="text"></w2:column> </w2:columnInfo> </w2:dataList> var colID = dlt_dataList1.getColumnID(0); //반환 값 예시 ) "addr"

getColumnIndex( colID )

DataList에 정의된 컬럼의 아이디를 받아 컬럼의 인덱스를 반환

Parameter
name	type	required	description
colID	String	Y	GridView의 컬럼의 아이디

Return
type	description
Number	GridView의 컬럼 인덱스

Sample

//DataList 정의 예시 <w2:dataList id="dlt_dataList1"> <w2:columnInfo> <w2:column id="addr" name="주소" dataType="text"></w2:column> <w2:column id="name" name="이름" dataType="text"></w2:column> </w2:columnInfo> </w2:dataList> var colIdx = dlt_dataList1.getColumnIndex("name"); //반환 값 예시 ) 1

getColumnInfo( columnID )

DataList 특정 컬럼의 세부 정보를 조회

Parameter
name	type	required	description
columnID	String	Y	조회하고자 하는 컬럼의 아이디

Return
type	description
JSON	해당 컬럼의 특성을 표현한 JSON 객체

Sample

//DataList 정의 예시 <w2:dataList id="dlt_dataList1"> <w2:columnInfo> <w2:column id="column1" name="컬럼1" dataType="text"></w2:column> <w2:column id="column2" name="컬럼2" dataType="text"></w2:column> </w2:columnInfo> </w2:dataList> // column2의 정보를 가져옴 dlt_dataList1.getColumnInfo("column2");

getColumnName( columnInfo )

DataList에 정의된 컬럼의 인덱스 또는 아이디를 받아 컬럼에 정의된 이름을 반환

Parameter
name	type	required	description
columnInfo	Number\|\|String	Y	컬럼의 아이디 또는 인덱스

Return
type	description
String	컬럼의 이름

Sample

//DataList 정의 예시 <w2:dataList id="dlt_dataList1"> <w2:columnInfo> <w2:column id="addr" name="주소" dataType="text"></w2:column> <w2:column id="name" name="이름" dataType="text"></w2:column> </w2:columnInfo> </w2:dataList> var colName = dlt_dataList1.getColumnName("name"); //반환 값 예시 ) "이름"

getDataRow( rowIndex )

rowIndex에 해당하는 행의 데이터를 컬럼의 아이디를 키(key)로 하는 해쉬 형태로 반환

Parameter
name	type	required	description
rowIndex	Number	Y	데이터를 가져올 행 인덱스

Return
type	description
Object	rowIndex에 해당하는 행의 해쉬 형태의 객체

Sample

//DataList 정의 예시 <w2:dataList id="dlt_dataList1"> <w2:columnInfo> <w2:column id="age" name="나이" dataType="text"></w2:column> <w2:column id="name" name="이름" dataType="text"></w2:column> </w2:columnInfo> <w2:data xmlns="" use="true"> <w2:row> <age><![CDATA[25]]></age> <name><![CDATA[손예진]]></name> </w2:row> <w2:row> <age><![CDATA[32]]></age> <name><![CDATA[류승룡]]></name> </w2:row> </w2:data> </w2:dataList> var rowData = dlt_dataList1.getDataRow(1); var tmpName = rowData.name; //반환 값 예시 ) "류승룡" var tmpAge = rowData.age; //반환 값 예시 ) "32" //출력 예시 ) name : 류승룡 age : 32

getDeletedArray( )

삭제 상태(상태값: D, E, V)인 행들의 정보가 담긴 JSON

Return
type	description
JSON	삭제 상태인 행들의 정보가 담긴 JSON

Sample

var rsData = dlt_dataList1.getDeletedArray(); //반환 값 예시 ) { "columnInfo": [ "age", "name" ], "data": [ "32", "송강호", "23", "전지현" ] }

getDeletedData( )

삭제 상태(상태값: D, E, V)인 행들의 데이터가 담긴 2차원 배열

Return
type	description
Array	삭제 상태(상태값: D, E, V)인 행들의 2차원 데이터 배열

Sample

var rsData = dlt_dataList1.getDeletedData(); //반환 값 예시 ) [[ "25" , "송강호" ],[ "30" , "전지현" ]]

getDeletedIndex( )

삭제 상태(상태값: D, V, 3, 4)인 행의 인덱스를 배열로 반환함 (삭제 API로 삭제된 E상태의 행은 반환되지 않음)

Return
type	description
Array	삭제 상태(상태값: D, V, 3, 4)인 행의 인덱스가 담긴 1차원 배열

Sample

var returnArr = dlt_dataList1.getDeletedIndex(); //반환 값 예시 ) [0, 2]

getDeletedJSON( )

삭제 상태(상태값: D, E, V)인 행들의 데이터를 JSON으로 변환 후, 배열에 담아 반환함

Return
type	description
Array	삭제 상태인 행들의 JSON 데이터가 담긴 1차원 배열

Sample

var rsData = dlt_dataList1.getDeletedJSON(); //반환 값 예시) [ { "age": "" , "name": "", "rowStatus": "V" } , { "age": "28", "name": "손예진", "rowStatus": "D" } , { "age": "22", "name": "송강호", "rowStatus": "E" } ]

getDeletedXML( )

삭제 상태(상태값: D, E, V)인 행들의 데이터를 XML로 반환함

Return
type	description
XML	삭제 상태(상태값: D, E, V)인 행들의 XML

Sample

var rsData = dlt_dataList1.getDeletedXML(); //반환 값 예시 ) <list id="dlt_dataList1"> <map index="0"> <age></age> <name></name> <rowStatus statusValue="4">V</rowStatus> </map> <map index="1"> <age>22</age> <name>손예진</name> <rowStatus statusValue="3">D</rowStatus> </map> <map index="removed"> <age>25</age> <name>송강호</name> <rowStatus statusValue="5">E</rowStatus> </map> </list>

getFilteredColData( colInfo )

필터 및 정렬이 적용된 열의 데이터를 배열로 반환 (관련 함수) getColData (필터나 정렬이 적용되지 않은 열의 전체 데이터를 반환)

Parameter
name	type	required	description
colInfo	Number\|\|String	Y	데이터를 가져올 열 인덱스 혹은 컬럼 아이디

Return
type	description
Array	열의 데이터가 담긴 1차원 배열 (필터 및 정렬이 적용된 데이터)

Sample

var returnArr = dlt_dataList1.getFilteredColData('name'); // name 컬럼의 데이터 배열 // (반환 예) [ "손예진" , "이광수"] ("류승룡" 은 필터가 적용되어 반환되지 않음)

getFilteredRowIndex( realRowIndex )

필터링된 상태의 행 인덱스를 반환

Parameter
name	type	required	description
realRowIndex	Number	Y	필터링되지 않은 상태의 행 인덱스

Return
type	description
Number	필터링된 상태의 행 인덱스

getFilterList( )

필터링된 DataList의 컬럼 별 필터링 상태를 반환 (관련 함수) setColumnFilter (현재 필터링 상태를 저장하고, 필터링을 해제한 후, 다시 이전 필터링 상태로 돌아갈 때 유용)

Return
type	description
Array	DataList에 적용된 필터들을 배열로 저장한 객체

Sample

getFusionChartData( chartType , labelNode , seriesColumns )

DataList를 FusionChart의 JSON 데이터로 반환함

Parameter
name	type	required	description
chartType	String	Y	FusionChart의 차트타입
labelNode	String	Y	FusionChart의 label 데이터로 사용할 데이터컬렉션의 컬럼의 아이디값
seriesColumns	String	Y	FusionChart의 series 데이터로 사용할 데이터컬렉션 컬럼의 정보로 배열 형식의 문자열

Return
type	description
JSON	변환된 FusionChart 데이터 (JSON)

Sample

//아래와 같이 DataList가 정의된 경우 <w2:dataList id="dc_chart" baseNode="list" style="" repeatNode="map" valueAttribute=""> <w2:columnInfo> <w2:column id="category1" name="대분류" dataType="text"></w2:column> <w2:column id="category2" name="중분류" dataType="text"></w2:column> <w2:column id="row3_1" name="row3_1" dataType="text"></w2:column> <w2:column id="row3_2" name="row3_2" dataType="text"></w2:column> </w2:columnInfo> <w2:data xmlns="" use="true"> <w2:row> <category1><![CDATA[소설]]></category1> <category2><![CDATA[한국소설]]></category2> <row3_1><![CDATA[100]]></row3_1> <row3_2><![CDATA[200]]></row3_2> </w2:row> <w2:row> <category1><![CDATA[소설]]></category1> <category2><![CDATA[영미소설]]></category2> <row3_1><![CDATA[100]]></row3_1> <row3_2><![CDATA[400]]></row3_2> </w2:row> <w2:row> <category1><![CDATA[시/에세이]]></category1> <category2><![CDATA[에세이]]></category2> <row3_1><![CDATA[400]]></row3_1> <row3_2><![CDATA[100]]></row3_2> </w2:row> <w2:row> <category1><![CDATA[시/에세이]]></category1> <category2><![CDATA[시]]></category2> <row3_1><![CDATA[200]]></row3_1> <row3_2><![CDATA[500]]></row3_2> </w2:row> </w2:data> </w2:dataList> var rsData = dc_chart.getFusionChartData("MSColumn2D","category2","[['row3_1','row3_2']]"); //반환 값 예시) { "categories": [ { "category": [ { "label": "한국소설" }, { "label": "영미소설" }, { "label": "에세이" }, { "label": "시" } ] } ], "dataset": [ { "data": [ { "value": "100" }, { "value": "100" }, { "value": "400" }, { "value": "200" } ], "seriesname": "row3_1" }, { "data": [ { "value": "200" }, { "value": "400" }, { "value": "100" }, { "value": "500" } ], "seriesname": "row3_2" } ] }

getFusionChartSimpleData( chartType , labelNode , seriesNode , valueNode )

DataList의 데이터를 FusionChart의 simple 모드인 singleSerise, multiSeries 차트의 JSON 데이터로 반환

Parameter
name	type	required	description
chartType	String	Y	FusionChart의 차트 타입
labelNode	String	Y	FusionChart의 label 데이터로 사용할 DataList 컬럼의 아이디값
seriesNode	String	Y	FusionChart의 series 데이터로 사용할 DataList 컬럼의 아이디값
valueNode	String	Y	FusionChart의 값 데이터로 사용할 DataList 컬럼의 아이디값

Return
type	description
JSON	JSON으로 변환된 FusionChart 데이터로 singleSerise와 multiSeries 데이터 형태가 다름 (sample 예시 참조)

Sample

//아래와 같이 DataList가 정의 되어 있는 경우 <w2:dataList id="dc_chart" baseNode="list" style="" repeatNode="map"> <w2:columnInfo> <w2:column id="series" name="series" dataType="text"></w2:column> <w2:column id="label" name="label" dataType="text"></w2:column> <w2:column id="value" name="value" dataType="number"></w2:column> </w2:columnInfo> <w2:data use="true"> <w2:row> <series><![CDATA[상반기]]></series> <label><![CDATA[2013]]></label> <value><![CDATA[390]]></value> </w2:row> <w2:row> <series><![CDATA[하반기]]></series> <label><![CDATA[2013]]></label> <value><![CDATA[440]]></value> </w2:row> <w2:row> <series><![CDATA[상반기]]></series> <label><![CDATA[2014]]></label> <value><![CDATA[420]]></value> </w2:row> <w2:row> <series><![CDATA[하반기]]></series> <label><![CDATA[2014]]></label> <value><![CDATA[450]]></value> </w2:row> </w2:data> </w2:dataList> //singleSerise chart인 경우 var tmpChartData = dc_chart.getFusionChartSimpleData("column2D","label","series","value"); //반환 값 예시 ) { "data": [ { "label": "2013", "value": "390" }, { "label": "2013", "value": "440" }, { "label": "2014", "value": "420" }, { "label": "2014", "value": "450" } ] } multiSeries chart var tmpChartData2 = dc_chart.getFusionChartSimpleData("MSColumn2D","label","series","value"); //반환 값 예시 ) { "categories": [ { "category": [ { "label": "2013" }, { "label": "2014" } ] } ], "dataset": [ { "data": [ { "value": "390" }, { "value": "420" } ], "seriesname": "상반기" }, { "data": [ { "value": "440" }, { "value": "450" } ], "seriesname": "하반기" } ] }

getID( )

DataList 객체의 아이디를 반환하고 객체의 아이디 속성과 동일한 값을 반환함

Return
type	description
String	DataList 객체의 아이디를 반환

getInfo( )

DataList의 세부 정보를 조회

Return
type	description
JSON	{dataListInfo : DataList의 특성 값, columnInfo : 각 컬럼의 특성들을 모아둔 object} 형태의 JSON 객체

Sample

dlt_dataList1.getInfo();

getInsertedArray( )

삽입 상태(상태값: C)인 행들의 정보가 담긴 JSON

Return
type	description
JSON	삽입 상태인 행들의 정보가 담긴 JSON

Sample

var rsData = dlt_dataList1.getInsertedArray(); //반환 값 예시 ) { "columnInfo": [ "age", "name" ], "data": [ "23", "신규회원" ] }

getInsertedData( )

삽입 상태(상태값: C)인 행들의 데이터가 담긴 2차원 배열

Return
type	description
Array	삽입 상태인 행들의 2차원 데이터 배열

Sample

var rsData = dlt_dataList1.getInsertedData(); //반환 값 예시 ) [ [ "32" , "신규회원1" ] , [ "22" , "신규회원2" ] ]

getInsertedIndex( )

삽입 상태(상태값: C)인 행의 인덱스를 배열에 담아 반환함

Return
type	description
Array	삽입 상태인 행 인덱스가 담긴 배열

Sample

var rsData = dlt_dataList1.getInsertedIndex(); //반환 값 예시 ) [ 0 , 2 ]

getInsertedJSON( )

삽입 상태(상태값: C)인 행들의 데이터를 JSON으로 변환하여 배열에 담아 반환함

Return
type	description
Array	삽입 상태인 행들의 JSON 데이터가 담긴 1차원 배열

Sample

var rsData = dlt_dataList1.getInsertedJSON(); //반환 값 예시) [ { "age": "22" , "name": "손예진", "rowStatus": "C" } , { "age": "24", "name": "익명1", "rowStatus": "C" } ]

getInsertedXML( )

삽입 상태(상태값: C)인 행들의 데이터를 XML로 반환함

Return
type	description
XML	삽입 상태인 행들의 XML

Sample

var rsData = dlt_dataList1.getInsertedXML(); //반환 값 예시 ) <list id="dlt_dataList1"> <map index="0"> <age>미공개</age> <name>익명1</name> <rowStatus statusValue="2">C</rowStatus> </map> <map index="2"> <age>25</age> <name>이광수</name> <rowStatus statusValue="2">C</rowStatus> </map> </list>

getMatchedArray( colInfo , dataValue , exactMatch , stRowIndex , lastRowIndex )

stRowIndex부터 lastRowIndex까지의 범위의 행 중에서 colInfo에 해당하는 값이 dataValue와 같은 행들의 컬럼 정보 및 데이터를 담은 JSON을 반환함

Parameter
name	type	required	description
colInfo	Number\|\|String	Y	데이터를 검사할 컬럼 인덱스 혹은 컬럼 아이디
dataValue	String	Y	비교 데이터
exactMatch	Boolean	N	[default:true, false] 정확한 일치 여부
stRowIndex	Number	N	데이터를 가져올 첫 행 인덱스
lastRowIndex	Number	N	데이터를 가져올 마지막 행 인덱스

Return
type	description
JSON	범위 안의 데이터 정보를 가진 JSON

Sample

var tmpRsData = dlt_dataList1.getMatchedArray("dept","인사"); //반환 값 예시 ) { "columnInfo":["dept","name"] ,"data":["인사","손예진","인사","류승룡"] }

getMatchedColumnData( matchCol , dataValue , targetCol , exactMatch , stRowIndex , lastRowIndex )

stRowIndex부터 lastRowIndex까지의 범위의 행 중에서 matchCol에 해당하는 값이 dataValue와 같은 행들을 찾아서 targetCol에 해당하는 값을 1차원 배열로 반환함

Parameter
name	type	required	description
matchCol	Number\|\|String	Y	데이터를 검사할 컬럼의 인덱스 또는 아이디
dataValue	String	Y	비교 데이터
targetCol	Number\|\|String	Y	꺼내올 데이터의 컬럼 인덱스 또는 컬럼 아이디
exactMatch	Boolean	N	[default:true, false] 정확히 일치하는지 여부
stRowIndex	Number	N	데이터를 가져올 첫 행 인덱스
lastRowIndex	Number	N	데이터를 가져올 마지막 행 인덱스

Return
type	description
Array	targetCol에 해당하는 데이터가 담긴 1차원 배열

Sample

var tmpRsData = dlt_dataList1.getMatchedColumnData("dept","인사","name"); //반환 값 예시 )["손예진" , "류승룡"]

getMatchedData( colInfo , dataValue , exactMatch , stRowIndex , lastRowIndex )

stRowIndex부터 lastRowIndex까지의 범위의 행 중에서 colInfo의 값이 dataValue와 같은 행들의 데이터를 2차원 배열로 반환함

Parameter
name	type	required	description
colInfo	Number\|\|String	Y	데이터를 검사할 컬럼의 인덱스 또는 아이디
dataValue	String	Y	비교 데이터
exactMatch	Boolean	N	[default:true, false] 정확히 일치하는지 여부
stRowIndex	Number	N	데이터를 가져올 첫 행 인덱스
lastRowIndex	Number	N	데이터를 가져올 마지막 행 인덱스

Return
type	description
Array	검색된 행의 배열 데이터가 담긴 배열 (2차원 배열)

Sample

var tmpRsData = dlt_dataList1.getMatchedData("dept","인사"); //반환 값 예시 ) [["인사","손예진"],["인사","류승룡"]]

getMatchedIndex( colInfo , dataValue , exactMatch , stRowIndex , lastRowIndex )

stRowIndex부터 lastRowIndex까지의 범위의 행 중에서 colInfo의 값이 dataValue와 같은 행들의 인덱스를 반환함

Parameter
name	type	required	description
colInfo	Number\|\|String	Y	데이터를 검사할 컬럼의 인덱스 또는 아이디
dataValue	String	Y	비교 데이터
exactMatch	Boolean	N	[default:true, false] 정확히 일치하는지 여부
stRowIndex	Number	N	데이터를 가져올 첫 행 인덱스
lastRowIndex	Number	N	데이터를 가져올 마지막 행 인덱스

Return
type	description
Array	범위 안에 일치하는 인덱스를 담은 1차원 배열

Sample

var tmpRsData = dlt_dataList1.getMatchedIndex("dept","인사"); //반환 값 예시 ) [0,3]

getMatchedJSON( colInfo , dataValue , exactMatch , stRowIndex , lastRowIndex )

stRowIndex부터 lastRowIndex까지의 범위의 행 중에서 colInfo의 값이 dataValue와 같은 행들의 JSON 데이터를 배열에 담아 반환함

Parameter
name	type	required	description
colInfo	Number\|\|String	Y	데이터를 검사할 컬럼의 인덱스 또는 아이디
dataValue	String	Y	비교 데이터
exactMatch	Boolean	N	[default:true, false] 정확히 일치하는지 여부
stRowIndex	Number	N	데이터를 가져올 첫 행 인덱스
lastRowIndex	Number	N	데이터를 가져올 마지막 행 인덱스

Return
type	description
Array	범위 안의 JSON 데이터를 가지고 있는 1차원 배열

Sample

//dlt_dataList1의 dept 컬럼의 데이터가 "인사"인 행의 데이터를 JSON 배열로 반환 var tmpRsData = dlt_dataList1.getMatchedJSON("dept","인사"); //반환 값 예시 ) [{"dept":"인사","name":"손예진","rowStatus":"R"},{"dept":"인사","name":"류승룡","rowStatus":"R"}]

getMatchedXML( colInfo , dataValue , exactMatch , stRowIndex , lastRowIndex )

stRowIndex부터 lastRowIndex까지의 범위의 행 중에서 colInfo의 값이 dataValue와 같은 행들의 데이터를 XML로 반환함

Parameter
name	type	required	description
colInfo	Number\|\|String	Y	데이터를 검사할 컬럼 인덱스 혹은 컬럼 아이디
dataValue	String	Y	비교 데이터
exactMatch	Boolean	N	[default:true, false] 정확히 일치하는지 여부
stRowIndex	Number	N	데이터를 가져올 첫 행 인덱스
lastRowIndex	Number	N	데이터를 가져올 마지막 행 인덱스

Return
type	description
XML	범위 안의 XML 데이터

Sample

var tmpRsData = dlt_dataList1.getMatchedXML("dept","인사"); //반환 값 예시 ) <list id="dlt_dataList1"> <map index="0"> <dept>인사</dept> <name>손예진</name> <rowStatus statusValue="0">R</rowStatus> </map> <map index="3"> <dept>인사</dept> <name>류승룡</name> <rowStatus statusValue="0">R</rowStatus> </map> </list>

getModifiedArray( )

변경 상태(상태값: C, U, D, E)행들의 정보가 담긴 JSON

Return
type	description
JSON	변경 상태 행들의 정보가 담긴 JSON

Sample

var tmpRsData = dlt_dataList1.getModifiedArray(); //반환 값 예시 ) { "columnInfo": [ "dept", "name" ] , "data": [ "부서미지정", "행추가", "인사", "수정함", "홍보", "송강호", "IT", "전지현" ] }

getModifiedData( )

변경 상태(상태값: C, U, D, E)행들의 데이터를 배열로 반환

Return
type	description
Array	변경 상태 행들의 데이터가 담긴 2차원 배열

Sample

var tmpRsData = dlt_dataList1.getModifiedData(); //반환 값 예시 ) [["","행추가"],["인사","행수정"],["홍보","송강호"],["IT","전지현"]]

getModifiedIndex( )

변경 상태(상태값: C, U, D)행들의 인덱스를 배열로 반환함

Return
type	description
Array	변경 상태 행들의 인덱스가 담긴 1차원 배열

Sample

var tmpRsData = dlt_dataList1.getModifiedIndex(); //반환 값 예시 ) [1,2,3]

getModifiedJSON( options )

데이터가 삽입, 갱신, 삭제, 제거된 상태(상태값: U, C, D, E, 1, 2, 3, 5)의 행들의 데이터를 JSON으로 변환하여 1차원 배열에 담아 반환함

Parameter
name	type	required	description
options	JSON	N	변경된 데이터의 반환 순서를 설정할 정보

Return
type	description
Array	삽입, 갱신, 삭제된 행들의 JSON 데이터가 담긴 1차원 배열

Sample

var returnJSON1 = dlt_dataList1.getModifiedJSON(); //반환 값 예시 ) [ { "dept": "", "name": "", "rowStatus": "C" }, { "dept": "인사", "name": "손예진", "rowStatus": "D" }, { "dept": "인사", "name": "수정", "rowStatus": "U" }, { "dept": "홍보", "name": "송강호", "rowStatus": "E" } ] var returnJSON2 = dlt_dataList1.getModifiedJSON({saveRemovedData:false}); //반환 값 예시 ) [ { "dept": "", "name": "", "rowStatus": "C" }, { "dept": "인사", "name": "손예진", "rowStatus": "D" }, { "dept": "인사", "name": "수정", "rowStatus": "U" } ]

getModifiedXML( options )

데이터가 변경된 상태(상태값: U, C, D, E, 1, 2, 3, 5)의 행들의 데이터를 XML로 반환

Parameter
name	type	required	description
options	JSON	N	데이터가 변경된 행들의 반환될 데이터를 설정

Return
type	description
XML	삽입, 갱신, 삭제된 행들의 XML 데이터

Sample

var returnXML1 = dlt_dataList1.getModifiedXML(); //반환 값 예시 ) <list id="dlt_dataList1"> <map index="0"> <dept></dept> <name></name> <rowStatus statusValue="2">C</rowStatus> </map> <map index="1"> <dept>인사</dept> <name>손예진</name> <rowStatus statusValue="3">D</rowStatus> </map> <map index="3"> <dept>인사</dept> <name>수정</name> <rowStatus statusValue="1">U</rowStatus> </map> <map index="removed"> <dept>홍보</dept> <name>송강호</name> <rowStatus statusValue="5">E</rowStatus> </map> </list> var returnXML2 = dlt_dataList1.getModifiedXML({saveRemovedData:false}); //반환 값 예시 ) <list id="dlt_dataList1"> <map index="0"> <dept></dept> <name></name> <rowStatus statusValue="2">C</rowStatus> </map> <map index="1"> <dept>인사</dept> <name>손예진</name> <rowStatus statusValue="3">D</rowStatus> </map> <map index="3"> <dept>인사</dept> <name>수정</name> <rowStatus statusValue="1">U</rowStatus> </map> </list>

getObjectType( )

데이터컬렉션 형식 반환

Return
type	description
String	[dataMap, dataList, linkedDataList] 데이터컬렉션의 타입을 반환

Sample

var dcType = dlt_dataList1.getObjectType(); //반환 값 예시 ) "dataList"

getOnlyDeletedArray( )

삭제 상태(상태값:D, E) 행들의 정보를 담은 JSON을 반환

Return
type	description
JSON	삭제 상태 행들의 정보를 담은 JSON

Sample

var tmpRsData = dlt_dataList1.getOnlyDeletedArray(); //반환 값 예시 ) { "columnInfo": [ "age", "name" ], "data": [ "32", "송강호", "23", "전지현" ] }

getOnlyDeletedData( )

삭제 상태(상태값: D, E) 행들의 배열 데이터를 배열에 담아 반환 (2차원 배열)

Return
type	description
Array	삭제 상태 행들의 배열 데이터를 담은 배열

Sample

var tmpRsData = dlt_dataList1.getOnlyDeletedData(); //반환 값 예시 ) [["홍보","송강호"],["IT","전지현"]]

getOnlyDeletedIndex( )

삭제 상태(상태값: D) 행들의 인덱스를 배열로 반환

Return
type	description
Array	삭제 상태인 행들의 인덱스를 담은 배열

Sample

var tmpRsData = dlt_dataList1.getOnlyDeletedIndex(); //반환 값 예시 ) [3]

getOnlyDeletedJSON( )

삭제 상태(상태값:D, E) 행들의 JSON 데이터를 배열에 담아 반환

Return
type	description
Array	삭제 상태인 행들의 JSON 데이터를 담은 배열

Sample

var tmpRsData = dlt_dataList1.getOnlyDeletedJSON(); //반환 값 예시 ) [ {"dept":"홍보","name":"송강호","rowStatus":"D"} ,{"dept":"IT","name":"전지현","rowStatus":"E"} ]

getOnlyDeletedXML( )

삭제 상태(상태값: D, E) 행들의 데이터를 XML로 반환

Return
type	description
XML	삭제 상태인 행들의 XML 데이터

Sample

var tmpRsData = dlt_dataList1.getOnlyDeletedXML() //반환 값 예시 ) <list id="dlt_dataList1"> <map index="3"> <dept>홍보</dept> <name>송강호</name> <rowStatus statusValue="3">D</rowStatus> </map> <map index="removed"> <dept>IT</dept> <name>전지현</name> <rowStatus statusValue="5">E</rowStatus> </map> </list>

getOption( attr )

속성명으로 DataList에 정의된 속성의 값을 반환

Parameter
name	type	required	description
attr	String	Y	속성명

Return
type	description
String	DataList에 정의된 속성의 값

Sample

//DataList 정의 예시 <w2:dataList id="dlt_dataList1" baseNode="list"> <w2:columnInfo> <w2:column id="dept" name="부서" dataType="text"></w2:column> <w2:column id="name" name="이름" dataType="text"></w2:column> </w2:columnInfo> </w2:dataList> var tmpAttr = dlt_dataList1.getOption("baseNode"); //반환 값 예시 ) "list"

getOriginalCellData( rowIndex , colIndex )

rowIndex와 colIndex에 해당하는 셀의 초기 데이터(최초의 데이터)를 반환
(필터 사용 시 필터가 적용된 상태 기준으로 동작)

Parameter
name	type	required	description
rowIndex	Number	Y	셀의 초기 행 인덱스
colIndex	String\|\|Number	Y	컬럼의 아이디 또는 컬럼 인덱스

Return
type	description
String	셀의 초기 데이터

Sample

var tmpRsData = dlt_dataList1.getOriginalCellData(0, "name");

getParentRowIndex( rowIndex )

드릴다운 사용 시 행 인덱스에 해당하는 행의 부모 행의 인덱스를 반환

Parameter
name	type	required	description
rowIndex	Number	Y	부모를 찾으려는 행의 인덱스

Return
type	description
Number	부모 행의 인덱스를 반환

Sample

var rowIndex = dlt_dataList1.getParentRowIndex(0);

getRangeArray( from , to )

from부터 to까지 인덱스 범위의 컬럼 정보와 데이터를 담은 JSON을 반환
(필터 사용 시 필터가 적용된 상태 기준으로 동작)

Parameter
name	type	required	description
from	Number	Y	데이터를 가져오는 범위의 시작 행 인덱스
to	Number	Y	데이터를 가져오는 범위의 끝 행 인덱스

Return
type	description
JSON	범위 안의 데이터 정보를 가진 JSON

Sample

//행의 인덱스가 0번째 ~ 2번째인 행의 데이터 꺼내오기 var tmpRsData = dlt_dataList1.getRangeArray(0,2); //반환 값 예시 ) { "columnInfo":["dept","name"] ,"data":["인사","손예진","홍보","송강호","IT","전지현"] }

getRangeData( from , to )

from부터 to까지 인덱스 범위 데이터를 1차원 배열로 반환
(필터 사용 시 필터가 적용된 상태 기준으로 동작)

Parameter
name	type	required	description
from	Number	Y	데이터를 가져오는 범위의 시작 행 인덱스
to	Number	Y	데이터를 가져오는 범위의 끝 행 인덱스

Return
type	description
Array	범위 안의 데이터를 가지고 있는 배열

Sample

var tmpRsData = dlt_dataList1.getRangeData(0,2); //반환 값 예시 ) ["인사","손예진","홍보","송강호","IT","전지현"]

getRangeJSON( from , to )

from부터 to까지 인덱스 범위 JSON 데이터를 담은 1차원 배열 반환
(필터 사용 시 필터가 적용된 상태 기준으로 동작)

Parameter
name	type	required	description
from	Number	Y	데이터를 가져오는 범위의 시작 행 인덱스
to	Number	Y	데이터를 가져오는 범위의 끝 행 인덱스

Return
type	description
Array	범위에 해당하는 행의 JSON 객체를 담은 배열

Sample

//1번째 행부터 3번째 헹 데이터를 JSON으로 반환하여 배열로 반환 var tmpRsData = dlt_dataList1.getRangeJSON(0,2); //반환 값 예시 ) [ {"dept":"인사","name":"손예진","rowStatus":"R"} ,{"dept":"홍보","name":"송강호","rowStatus":"R"} ,{"dept":"IT","name":"전지현","rowStatus":"R"} ]

getRangeXML( from , to )

from부터 to까지 인덱스 범위 데이터를 XML로 반환
(필터 사용 시 필터가 적용된 상태 기준으로 동작)

Parameter
name	type	required	description
from	Number	Y	데이터를 가져오는 범위의 시작 행 인덱스
to	Number	Y	데이터를 가져오는 범위의 끝 행 인덱스

Return
type	description
XML	범위에 해당하는 행의 XML 데이터

Sample

var tmpRsData = dlt_dataList1.getRangeXML(0,2); //반환 값 예시 ) <list id="dlt_dataList1"> <map index="0"> <dept>인사</dept> <name>손예진</name> <rowStatus statusValue="0">R</rowStatus> </map> <map index="1"> <dept>홍보</dept> <name>송강호</name> <rowStatus statusValue="0">R</rowStatus> </map> <map index="2"> <dept>IT</dept> <name>전지현</name> <rowStatus statusValue="0">R</rowStatus> </map> </list>

getRealRowIndex( )

실제 행의 인덱스를 반환
필터나 정렬이 적용된 상태에서 실제 데이터의 인덱스를 조회할 때 사용

Return
type	description
Number:Y	rowIndex 조회할 행의 인덱스

Sample

var rowIndex = dlt_dataList1.getRealRowIndex(0);

getRecursiveRowIndex( rowIndex )

depthColumn 사용 시 기준 rowIndex의 하위에 속한 모든 행의 인덱스를 배열로 반환

Parameter
name	type	required	description
rowIndex	Number	Y	하위 행을 조회할 기준 행의 인덱스

Return
type	description
Array	rowIndex 하위의 모든 행의 인덱스 배열

Sample

var rows = dlt_dataList1.getRecursiveRowIndex(1); // 결과 예시 [2, 3, 4, 5, 6, 7]

getRowArray( rowIndex )

rowIndex에 해당하는 행들의 정보가 담긴 JSON을 반환
(필터 사용 시 필터가 적용된 상태 기준으로 동작)

Parameter
name	type	required	description
rowIndex	Number	Y	데이터를 가져올 행의 인덱스

Return
type	description
JSON	행들의 정보가 담긴 JSON

Sample

//0번째 행의 데이터객체 var tmpRsData = dlt_dataList1.getRowArray(0); //반환 값 예시 ) { "columnInfo":["dept","name"] ,"data":["인사","손예진"] }

getRowCount( )

화면에 보여지는 행의 건수를 반환
필터가 적용되거나 GridView에 드릴다운이 적용되어 있는 경우 보이지 않는 데이터의 행의 수는 포함되지 않음
(전체 데이터의 행 건수는 getTotalRow API를 사용)

Return
type	description
Number	행의 건수

Sample

var count = dlt_dataList1.getRowCount();

getRowData( rowIndex )

rowIndex에 해당하는 행의 데이터를 배열로 반환
(필터 사용 시 필터가 적용된 상태 기준으로 동작)

Parameter
name	type	required	description
rowIndex	Number	Y	데이터를 가져올 행의 인덱스

Return
type	description
Array	rowIndex에 해당하는 행의 데이터의 배열

Sample

//DataList에 이름과 생년월일 컬럼이 정의된 경우 var rsData = dlt_dataList1.getRowData( 0 ); //반환 값 예시 ) ["아이유", "19930516"]

getRowIndexByStatus( statusStr )

상태 코드가 일치하는 행의 인덱스를 배열로 반환
단, 상태 코드가 E인 경우는 반환 되지 않음(removeRow와 같은 API를 호출한 경우가 이에 해당)
상태 코드가 여러 개의 경우 "CU"와 같이 상태 코드를 붙여 parameter로 전달
(필터 사용 시 필터가 적용된 상태 기준으로 동작)

Parameter
name	type	required	description
statusStr	String	Y	[C,U,D,V,R] 상태 코드 문자열 (대문자로 표현)

Return
type	description
Array	statusStr과 상태가 일치하는 행의 인덱스가 담긴 배열

Sample

//dlt_dataList1에서 삽입, 갱신, 삭제 상태인 행들의 rowIndex 배열 var returnArr = dlt_dataList1.getRowIndexByStatus('CUD'); //반환 값 예시 ) [1,3]

getRowJSON( rowIndex )

rowIndex에 해당하는 행의 데이터를 JSON 객체로 반환
(필터 사용 시 필터가 적용된 상태 기준으로 동작)

Parameter
name	type	required	description
rowIndex	Number	Y	데이터를 가져올 행의 인덱스

Return
type	description
JSON	해당 행의 JSON 객체 데이터

Sample

//name과 birthday 컬럼이 정의된 DataList의 경우 var returnData = dlt_dataList1.getRowJSON(0); //반환 값 예시 ) {"name":"아이유","birthday":"19930516","rowStatus":"R"}

getRowPosition( )

현재 선택한 행 인덱스 확인
(필터 사용 시 필터가 적용된 상태 기준으로 동작)

Return
type	description
Number	행의 인덱스

Sample

// gridView1이 dlt_dataList1과 연동되어 있는 상태에서 GridView의 (3,2) 셀을 클릭한 경우 dlt_dataList1.getRowPosition(); // 위 예제의 실행 결과는 3 // treeview2가 dataList2와 연동되어 있는 상태에서 인덱스 값이 5인 노드를 클릭한 경우 (node.index === 5) dlt_dataList1.getRowPosition(); // 위 예제의 실행 결과는 5

getRowStatus( rowIndex )

rowIndex에 해당하는 행의 상태 코드(문자) 반환 (초기상태:"R", 갱신:"U", 삽입:"C", 삭제:"D", 삽입 후 삭제:"V")
(필터 사용 시 필터가 적용된 상태 기준으로 동작)

Parameter
name	type	required	description
rowIndex	Number	Y	행의 인덱스

Return
type	description
String	행의 상태 코드 (초기상태:"R", 갱신:"U", 삽입:"C", 삭제:"D", 삽입 후 삭제:"V")

Sample

var returnValue = dlt_dataList1.getRowStatus(0); // 첫 번째 행의 상태값(문자)를 반환 //반환 값 예시 ) "R"

getRowStatusValue( rowIndex )

rowIndex에 해당하는 행의 상태 코드를 숫자로 반환 (초기상태:0, 갱신:1, 삽입:2, 삭제:3, 삽입 후 삭제:4)
(필터 사용 시 필터가 적용된 상태 기준으로 동작)

Parameter
name	type	required	description
rowIndex	Number	Y	행의 인덱스

Return
type	description
Number	행의 상태 숫자값 (초기상태:0, 갱신:1, 삽입:2, 삭제:3, 삽입 후 삭제:4)

Sample

var returnValue = dlt_dataList1.getRowStatusValue(0); // 첫 번째 행의 상태값(숫자)를 반환 //반환 값 예시 ) 0

getRowXML( rowIndex )

rowIndex에 해당하는 행의 데이터를 XML로 반환
(필터 사용 시 필터가 적용된 상태 기준으로 동작)

Parameter
name	type	required	description
rowIndex	Number	Y	데이터를 가져올 행의 인덱스

Return
type	description
XML	행의 XML 데이터

Sample

var rsData = dlt_dataList1.getRowXML(0); //반환 값 예시 ) <map index="0"> <name>정형돈</name> <birthday>19780207</birthday> <rowStatus statusValue="0">R</rowStatus> </map>

getScope( )

컴포넌트가 scope=true인 WFrame의 자식 컴포넌트일 때 해당 부모 WFrame 객체를 반환 scope=true인 WFrame의 자식 컴포넌트가 아닐 경우 null을 반환

Return
type	description
Object	WFrame 객체 또는 null

Sample

//wfm_wframe1이 있고 wfm_wframe1안에 wfm_wframe11이 있고 그 안에 dlt_dataList1이 있는 경우 dlt_dataList1.getScope(); // wfm_wframe11 객체를 반환

getScopeWindow( )

컴포넌트가 scope=true인 WFrame의 자식 컴포넌트일 때 해당 부모 WFrame의 Scope객체를 반환 scope=true인 WFrame의 자식 컴포넌트가 아닐 경우 전역 Window 객체를 반환

Return
type	description
Object	WFrame 객체의 Scope 객체 또는 전역 Window 객체

Sample

//wfm_wframe1이 있고 wfm_wframe1안에 wfm_wframe11이 있고 그 안에 dlt_dataList1이 있는 경우 var scope = dlt_dataList1.getScopeWindow(); scope.wfm_wframe11 === dlt_dataList1.getScope(); // true

getTotalCol( )

DataList에 정의된 컬럼 수를 반환

Return
type	description
Number	DataList의 컬럼 수

Sample

var count = dlt_dataList1.getTotalCol(); // DataList의 컬럼 수 반환

getTotalRow( )

DataList의 전체 행 수를 반환
필터가 걸려 있거나, 드릴다운이 적용되어 가려져 있는 행이 있더라도 모두 포함한 수를 반환
(필터가 적용이 되어있는 행의 건수는 getRowCount API를 사용)

Return
type	description
Number	전체 행 수

Sample

//저장된 전체 행 수를 반환 var rowCount = dlt_dataList1.getTotalRow();

getUnmatchedArray( col , dataValue , exactMatch , stRowIndex , lastRowIndex )

입력된 col에 해당하는 컬럼의 행 인덱스가 stRowIndex부터 lastRowIndex까지의 범위 중에서 데이터가 dataValue와 다른 행들의 정보를 JSON으로 변환하여 반환
(필터 사용 시 필터가 적용된 상태 기준으로 동작)

Parameter
name	type	required	description
col	Number\|\|String	Y	컬럼 인덱스 또는 아이디
dataValue	String	Y	비교 데이터
exactMatch	Boolean	Y	[default:true, false] 정확한 일치 여부
stRowIndex	Number	Y	데이터를 가져올 첫 행 인덱스
lastRowIndex	Number	Y	데이터를 가져올 마지막 행 인덱스

Return
type	description
JSON	범위 안의 데이터가 dataValue와 다른 행들의 정보를 가지고 있는 JSON 배열

Sample

//name과 birthday 컬럼이 정의된 DataList의 경우 //행의 인덱스가 0부터 10까지의 데이터 중에서 birthday의 값 중에 "198" 문자열이 없는 데이터를 반환 var rsData = dlt_dataList1.getUnmatchedArray( 'birthday', '198', false, 0, 10 )); //반환 값 예시 ) { "columnInfo":["name","birthday"] ,"data":["아이유","19930516","정형돈","19780207","유승호","19930817","김현아","19920606"] }

getUnmatchedColumnData( matchCol , dataValue , targetCol , exactMatch , stRowIndex , lastRowIndex )

matchCol에 해당하는 컬럼의 행 인덱스가 stRowIndex부터 lastRowIndex까지의 범위 중에서 데이터가 dataValue와 다른 행을 찾아서 targetCol에 해당하는 컬럼의 데이터를 배열로 반환
(필터 사용 시 필터가 적용된 상태 기준으로 동작)

Parameter
name	type	required	description
matchCol	Number\|\|String	Y	데이터를 검사할 컬럼의 인덱스 또는 아이디
dataValue	String	Y	비교 데이터
targetCol	Number\|\|String	Y	데이터를 가져올 컬럼의 인덱스 또는 아이디
exactMatch	Boolean	Y	[default:true, false] 정확한 일치 여부
stRowIndex	Number	Y	데이터를 가져올 첫 행 인덱스
lastRowIndex	Number	Y	데이터를 가져올 마지막 행 인덱스

Return
type	description
Array	targetCol에 해당하는 컬럼의 데이터를 가지고 있는 1차원 배열

Sample

//행의 인덱스가 0부터 10까지의 데이터 중에서 birthday의 값 중에 "198" 문자열이 없는 행의 name 데이터를 반환 var rsData = dlt_dataList1.getUnmatchedColumnData("birthday","198","name",false,0,10) //반환 값 예시) ["아이유","정형돈","유승호","김현아"]

getUnmatchedData( col , dataValue , exactMatch , stRowIndex , lastRowIndex )

col에 해당하는 컬럼의 행의 인덱스가 stRowIndex부터 lastRowIndex까지 범위 중에서 데이터가 dataValue와 다른 행들의 데이터를 배열로 변환하여 배열에 담아 반환
(필터 사용 시 필터가 적용된 상태 기준으로 동작)

Parameter
name	type	required	description
col	Number\|\|String	Y	데이터를 검사할 컬럼의 인덱스 또는 아이디
dataValue	String	Y	비교 데이터
exactMatch	Boolean	Y	[default:true, false] 정확한 일치 여부
stRowIndex	Number	Y	데이터를 가져올 첫 행 인덱스
lastRowIndex	Number	Y	데이터를 가져올 마지막 행 인덱스

Return
type	description
Array	범위 안의 데이터가 dataValue와 일치하지 않는 행들의 정보를 가지고 있는 배열 (2차원 배열)

Sample

//name과 birthday 컬럼이 정의된 DataList의 경우 //행의 인덱스가 0부터 10까지의 데이터 중에서 birthday의 값 중에 "198" 문자열이 없는 행의 데이터를 배열로 변환하여 배열에 담아 반환 var rsData = dlt_dataList1.getUnmatchedData("birthday","198",false,0,10) //반환 값 예시 ) [["아이유","19930516"],["정형돈","19780207"],["유승호","19930817"],["김현아","19920606"]]

getUnmatchedIndex( col , dataValue , exactMatch , stRowIndex , lastRowIndex )

col에 해당하는 컬럼의 행의 인덱스가 stRowIndex부터 lastRowIndex까지 범위 중에서 데이터가 dataValue와 다른 행들의 인덱스를 배열로 반환
(필터 사용 시 필터가 적용된 상태 기준으로 동작)

Parameter
name	type	required	description
col	Number\|\|String	Y	데이터를 검사할 컬럼의 인덱스 또는 아이디
dataValue	String	Y	비교 데이터
exactMatch	Boolean	Y	[default:true, false] 정확한 일치 여부
stRowIndex	Number	Y	데이터를 가져올 첫 행 인덱스
lastRowIndex	Number	Y	데이터를 가져올 마지막 행 인덱스

Return
type	description
Array	범위 안의 데이터가 dataValue와 일치하지 않는 행들의 인덱스 정보를 가지고 있는 배열

Sample

//컬럼의 인덱스가 0부터 10까지의 데이터 중에서 birthday의 값중에 "198" 문자열이 없는 행의 인덱스가 담긴 배열 반환 var returnArr = dlt_dataList1.getUnmatchedIndex("birthday","198",false,0,10) //반환 값 예시 )[0,1,2,5]

getUnmatchedJSON( col , dataValue , exactMatch , stRowIndex , lastRowIndex )

col에 해당하는 컬럼의 rowIndex가 stRowIndex부터 lastRowIndex 까지의 범위 중 데이터가 dataValue와 다른 행들의 데이터를 JSON으로 변환하여 배열에 담아 반환
(필터 사용 시 필터가 적용된 상태 기준으로 동작)

Parameter
name	type	required	description
col	Number\|\|String	Y	데이터를 검사할 컬럼의 인덱스 또는 아이디
dataValue	String	Y	비교 데이터
exactMatch	Boolean	Y	[default:true, false] 정확한 일치 여부
stRowIndex	Number	Y	데이터를 가져올 첫 행 인덱스
lastRowIndex	Number	Y	데이터를 가져올 마지막 행 인덱스

Return
type	description
Array	범위 내의 데이터가 dataValue와 일치하지 않은 JSON 데이터를 가진 1차원 배열

Sample

//dlt_dataList1의 인덱스가 0번째 10까지의 데이터 중 birthday의 값 중에 "198" 문자열이 없는 행의 JSON 데이터를 배열로 반환 var returnData = dlt_dataList1.getUnmatchedJSON("birthday","198",false,0,10)) //반환 값 예시 ) [ {"name":"아이유","birthday":"19930516","rowStatus":"R"} ,{"name":"정형돈","birthday":"19780207","rowStatus":"R"} ,{"name":"유승호","birthday":"19930817","rowStatus":"R"} ,{"name":"김현아","birthday":"19920606","rowStatus":"R"} ]

getUnmatchedXML( col , dataValue , exactMatch , stRowIndex , lastRowIndex )

col에 해당하는 컬럼의 행의 인덱스 stRowIndex부터 lastRowIndex까지 범위 중에서 데이터가 dataValue와 다른 행들의 데이터를 XML로 반환
(필터 사용 시 필터가 적용된 상태 기준으로 동작)

Parameter
name	type	required	description
col	Number\|\|String	Y	데이터를 검사할 컬럼의 인덱스 또는 아이디
dataValue	String	Y	비교 데이터
exactMatch	Boolean	Y	[default:true, false] 정확한 일치 여부
stRowIndex	Number	Y	데이터를 가져올 첫 행 인덱스
lastRowIndex	Number	Y	데이터를 가져올 마지막 행 인덱스

Return
type	description
XML	범위 안의 데이터가 dataValue와 일치하지 않는 행들의 데이터를 포함한 XML

Sample

//dlt_dataList1의 인덱스가 0번째 10까지의 데이터 중 birthday의 값 중에 "198" 문자열이 없는 행의 데이터를 XML로 반환 var returnData = dlt_dataList1.getUnmatchedXML("birthday","198",false,0,10); //반환 값 예시 ) <list id="dlt_dataList1"> <map index="0"> <name>아이유</name> <birthday>19930516</birthday> <rowStatus statusValue="0">R</rowStatus> </map> <map index="1"> <name>정형돈</name> <birthday>19780207</birthday> <rowStatus statusValue="0">R</rowStatus> </map> </list>

getUpdatedArray( )

갱신 상태(상태값: 1, U)인 행들의 데이터의 정보를 JSON으로 반환
반환 값의 columnInfo는 컬럼의 아이디가 담긴 배열
데이터는 columnInfo에 명시된 컬럼의 순서대로 해당하는 데이터를 담은 배열
(필터 사용 시 필터가 적용된 상태 기준으로 동작)

Return
type	description
JSON	갱신 상태인 행들의 정보가 담긴 JSON 데이터

Sample

//dept와 name이 정의된 DataList의 경우 //갱신 상태(상태값: U)의 데이터 반환 (총2건) var rsData = dlt_dataList1.getUpdatedArray()); //반환 값 예시 ) { "columnInfo":["dept","name"] ,"data":["인사","수정","홍보","수정2"] }

getUpdatedData( )

갱신 상태(상태값: 1, U)인 행들의 배열 데이터를 배열에 담아 반환
(필터 사용 시 필터가 적용된 상태 기준으로 동작)

Return
type	description
Array	갱신 상태(상태값: 1, U)인 행들의 배열 데이터 (2차원 배열)

Sample

//dept와 name이 정의된 DataList의 경우 //갱신 상태의 데이터 반환 (총2건) var rsData = dlt_dataList1.getUpdatedData(); //반환 값 예시 ) [["인사","수정"],["홍보","수정2"]]

getUpdatedIndex( )

갱신 상태(상태값: 1, U)인 행의 인덱스를 배열로 반환
(필터 사용 시 필터가 적용된 상태 기준으로 동작)

Return
type	description
Array	갱신 상태(상태값: 1, U)인 행의 인덱스를 담은 배열

Sample

//갱신 상태의 배열 반환 (총2건) var rsData = dlt_dataList1.getUpdatedIndex(); //반환 값 예시 ) [3,4]

getUpdatedJSON( )

갱신 상태(상태값: 1, U)인 행들의 데이터를 JSON으로 변환하여 배열에 담아 반환
(필터 사용 시 필터가 적용된 상태 기준으로 동작)

Return
type	description
Array	갱신 상태(상태값: 1, U)인 행들의 JSON 데이터가 담긴 배열

Sample

var rsData = dlt_dataList1.getUpdatedJSON(); //반환 값 예시 ) [ {"dept":"인사","name":"수정","rowStatus":"U"} ,{"dept":"홍보","name":"수정2","rowStatus":"U"} ]

getUpdatedXML( )

갱신 상태(상태값: 1, U)인 행들의 데이터를 XML로 반환
(필터 사용 시 필터가 적용된 상태 기준으로 동작)

Return
type	description
XML	갱신 상태(상태값: 1, U)인 행들의 XML 데이터

Sample

//dept와 name이 컬럼이 정의된 DataList의 경우 var rsData = dlt_dataList1.getUpdatedXML() //반환 값 예시 ) <list id="dlt_dataList1"> <map index="3"> <dept>인사</dept> <name>수정</name> <rowStatus statusValue="1">U</rowStatus> </map> </list>

getVoidArray( )

삽입 후 삭제 상태(상태값: 4, V)인 행들의 정보가 담긴 JSON을 반환
(필터 사용 시 필터가 적용된 상태 기준으로 동작)

Return
type	description
JSON	삽입 후 삭제 상태(상태값: 4, V)인 행들의 정보가 담긴 JSON

Sample

var returnJsonArr = dlt_dataList1.getVoidArray(); //반환 값 예시 ) { "columnInfo":["dept","name"] ,"data":["2","홍길동"] }

getVoidData( )

삽입 후 삭제 상태(상태값: 4, V)인 행들을 배열 데이터를 배열에 담에 반환
(필터 사용 시 필터가 적용된 상태 기준으로 동작)

Return
type	description
Array	삽입 후 삭제 상태인 행들의 배열 데이터가 담긴 배열 (2차원 배열)

Sample

var raData = dlt_dataList1.getVoidData(); //반환 값 예시 - 총 2건 ) [ ["0","",""],["0","",""] ]

getVoidIndex( )

삽입 후 삭제 상태(상태값: 4, V)인 행의 인덱스를 배열로 반환
(필터 사용 시 필터가 적용된 상태 기준으로 동작)

Return
type	description
Array	삽입 후 삭제 상태(상태값: 4, V)인 행의 인덱스를 담은 배열

Sample

var returnArr = dlt_dataList1.getVoidIndex(); //반환 값 예시 - 총 2건 ) [0,1]

getVoidJSON( )

삽입 후 삭제 상태(상태값: 4, V)인 행들의 JSON 데이터를 배열에 담아 반환
(필터 사용 시 필터가 적용된 상태 기준으로 동작)

Return
type	description
Array	삽입 후 삭제 상태(상태값: 4, V)인 행들의 JSON 데이터가 담긴 배열

Sample

var returnJsonStr = dlt_dataList1.getVoidJSON(); //반환 값 예시 - 총 2건 ) [ {"dept":"","name":"","rowStatus":"V"} ,{"dept":"","name":"","rowStatus":"V"} ]

getVoidXML( )

삽입 후 삭제 상태(상태값: 4, V)인 행들의 데이터를 XML로 반환
(필터 사용 시 필터가 적용된 상태 기준으로 동작)

Return
type	description
XML	삽입 후 삭제 상태(상태값: 4, V)인 행들의 XML 데이터

Sample

var returnXMLStr = dlt_dataList1.getVoidXML(); //반환 값 예시 - 총 2건 ) <list id="dlt_dataList1"> <map index="0"> <dept></dept> <name></name> <rowStatus statusValue="4">V</rowStatus> </map> <map index="1"> <dept></dept> <name></name> <rowStatus statusValue="4">V</rowStatus> </map> </list>

initRowStatus( )

DataList의 상태를 모두 초기 상태(상태값: R)로 변경
modifyAllStatus("R") 실행과 동작은 같지만 onrowstatuschange 이벤트가 발생하지 않음

Sample

dlt_dataList1.initRowStatus();

insertData( rowIndex , dataObj )

지정한 인덱스에 다건의 행을 1차원 배열로 삽입 (관련 이벤트) oninsertrow (행 삽입 후 발생)

Parameter
name	type	required	description
rowIndex	Number	Y	삽입할 행의 인덱스
dataObj	Array	Y	데이터를 담고 있는 1차원 배열

Sample

//DataList에 아이디가 name, birthday인 컬럼이 정의된 경우 //0번째 인덱스에 2건의 행을 삽입 dlt_dataList1.insertData( 0, ["아이유", "19930516" ,"정형돈" ,"19780207"] );

insertJSON( rowIndex , dataObj )

지정한 인덱스에 다건의 행을 JSON 객체로 삽입 (관련 이벤트) oninsertrow (행 삽입 후 발생)

Parameter
name	type	required	description
rowIndex	Number	Y	삽입할 행의 인덱스
dataObj	Array	Y	행에 해당하는 JSON 객체를 담고 있는 1차원 배열

Sample

//DataList에 아이디가 name, birthday인 컬럼이 정의된 경우 //DataList에 추가할 데이터 정의 var tmpData = [{"name":"아이유","birthday":"19930516"},{"name":"정형돈","birthday":"19780207"}]; //0번째 인덱스에 2건의 행을 삽입 dlt_dataList1.insertJSON( 0, tmpData );

insertRow( rowIndex )

1건의 행을 삽입 (데이터는 추가되지 않음) (관련 이벤트) oninsertrow (행 삽입 후 발생)

Parameter
name	type	required	description
rowIndex	Number	N	삽입할 행의 인덱스 (지정하지 않으면 맨 마지막 행에 삽입됨)

Return
type	description
Number	삽입된 행의 인덱스

Sample

// 0번째 인덱스에 새로운 행을 삽입 dlt_dataList1.insertRow(0);

insertXML( rowIndex , dataObj )

지정한 인덱스에 다건의 행을 XML 데이터로 삽입 (관련 이벤트) oninsertrow (행 삽입 후 발생)

Parameter
name	type	required	description
rowIndex	Number	Y	삽입할 행의 인덱스
dataObj	XML	Y	데이터를 담고 있는 XML

Sample

//DataList에 아이디가 name, birthday인 컬럼이 정의된 경우 //XML String var xmlStr = "<list><map><name>아이유</name><birthday>19930516</birthday></map></list>"; //XML 데이터 생성 var dataObj = WebSquare.xml.parse(xmlStr); //0번째 인덱스에 1건의 행을 삽입 insertXML(0, dataObj)

keepDataType( )

데이터를 세팅할 때나 뷰를 통해 데이터를 수정하는 경우, dataType이 number인 데이터에 한해 number로 타입캐스팅하도록 하는 기능

keepRowPosition( )

JSON 데이터를 추가할 때 이전에 설정된 행의 위치를 유지할지 여부

loadData( options )

서버 요청을 통해 받은 데이터를 DataList에 추가

Parameter
name	type	required	description
options	Object	Y	JSON 형태로 저장된 DataList 전송 옵션 전송 데이터 관련 옵션 전송 요청 관련 옵션 기타 옵션

Sample

var options = { dataType: "JSON", dataProvider: "sample.ProviderSample", maxRowCount: "20000", chunkRowCount: "5000", callback: "scwin.callback", optionParam: { key1: "value1", key2: "value2" }, timeout: 10000, } dlt_dataList1.loadData( options );

modifyAllStatus( status )

모든 행의 상태를 변경

Parameter
name	type	required	description
status	String	Y	변경할 상태값 (초기 상태:"R", 갱신:"U", 삽입:"C", 삭제:"D", 삽입 후 삭제:"V" 중에서 지정할 수 있음)

Sample

dlt_dataList1.modifyAllStatus('D'); // 모든 행의 상태를 삭제('D')로 변경

modifyMatchedStatus( col , dataValue , status )

해당하는 컬럼의 값과 지정한 값이 일치하는 행의 상태를 변경

Parameter
name	type	required	description
col	Number\|\|String	Y	검사할 컬럼의 인덱스 또는 아이디
dataValue	String	Y	비교값
status	String	Y	변경할 행의 상태값 (초기 상태:"R", 갱신:"U", 삽입:"C", 삭제:"D", 삽입 후 삭제:"V" 중에서 지정할 수 있음)

Sample

// 'dept' 컬럼의 데이터가 'IT'인 행의 상태를 갱신 상태(상태값: U)로 변경 dlt_dataList1.modifyMatchedStatus('dept', 'IT', 'U');

modifyRangeStatus( from , to , status )

지정한 범위의 행의 상태를 변경

Parameter
name	type	required	description
from	Number	Y	변경할 범위의 시작 행의 인덱스
to	Number	Y	변경할 범위의 끝 행의 인덱스
status	String	Y	변경할 상태값 (초기 상태:"R", 갱신:"U", 삽입:"C", 삭제:"D", 삽입 후 삭제:"V" 중에서 지정할 수 있음)

Sample

dlt_dataList1.modifyRangeStatus(1 , 3, 'D'); // 인덱스 1부터 3까지의 행의 상태를 삭제('D')로 변경

modifyRowStatus( rowIndex , status )

지정한 행의 상태를 변경

Parameter
name	type	required	description
rowIndex	Number	Y	상태를 변경할 행의 인덱스
status	String	Y	변경할 행의 상태값 (초기 상태:"R", 갱신:"U", 삽입:"C", 삭제:"D", 삽입 후 삭제:"V" 중에서 지정할 수 있음)

Sample

dlt_dataList1.modifyRowStatus(0, 'D'); // 인덱스 0번째인 행의 상태를 삭제 상태('D')로 변경

multisort( options )

여러 개의 컬럼을 정렬 (컬럼의 dataType 속성을 기준으로 정렬되므로 숫자 형태인 경우 dataType 속성을 number로 정의해야 함)

Parameter
name	type	required	description
options	JSON	Y	정렬에 대한 옵션을 가지고 있는 JSON

Sample

//"name" 컬럼을 내림차순으로 정렬하고 "dept" 컬럼을 오름차순으로 정렬 var options = {}; options.sortIndex = "name dept"; options.sortOrder = "-1 1"; dlt_dataList1.multisort( options );

preserveType( )

preserveType="true" 설정시 dataType이 number/text인 데이터에 한해 number/text로 타입캐스팅).

redo( )

restore()한 값을 다시 한 단계 되돌림 (관련 함수) restore();

Sample

dlt_dataList1.redo();

reform( )

최초 설정 데이터를 현재의 데이터로 바꾸고, 모든 행의 상태를 초기 상태(R)로 변경 (참고 사항) 최초 설정 데이터: setJSON, setXML 등과 같은 API들을 통해 설정된 데이터

Sample

dlt_dataList1.reform();

removeAll( )

모든 데이터를 삭제하고 삭제된 데이터를 1차원 배열로 반환

Return
type	description
Array	삭제한 행들의 데이터가 담긴 1차원 배열

Sample

//이름과 부서가 정의된 경우 var returnArr = dlt_dataList1.removeAll(); //반환 값 예시 - 총 5건 삭제 )["인사", "손예진", "홍보", "송강호", "IT", "전지현", "인사", "류승룡", "홍보", "이광수"]

removeColumnFilter( col )

지정한 컬럼에 적용된 필터를 삭제 (관련 함수) setColumnFilter();
(참고 사항) 여러 컬럼에 setColumnFilter()를 사용한 경우, 해제되지 않는 필터의 연산(AND, OR 조건)에 따른 결과를 유의해야 함

Parameter
name	type	required	description
col	Number\|\|String	Y	필터를 삭제할 컬럼의 인덱스 또는 아이디

Sample

dlt_dataList1.removeColumnFilter( 'dept' ); // 'dept' 컬럼에 적용된 필터를 해제

removeColumnFilterAll( )

모든 컬럼에 적용된 필터를 삭제

Sample

dlt_dataList1.removeColumnFilterAll(); // 전체 필터를 해제

removeRange( startIdx , endIdx )

지정한 범위의 행들을 삭제하고, 삭제된 데이터들을 1차원 배열로 반환

Parameter
name	type	required	description
startIdx	Number	Y	삭제할 범위의 시작 행의 인덱스
endIdx	Number	Y	삭제할 범위의 마지막 행의 인덱스

Return
type	description
Array	삭제된 행들이 가지고 있던 데이터가 담긴 2차원 배열

Sample

//'부서'와 '이름' 컬럼이 정의된 경우 //인덱스 0부터 1까지의 행 삭제 var returnArr = dlt_dataList1.removeRange(0, 1); //반환 값 예시 ) [["IT","전지현"],["홍보","송강호"]]

removeRow( rowIndex )

지정한 행을 삭제하고, 삭제된 데이터를 1차원 배열로 반환

Parameter
name	type	required	description
rowIndex	Number	N	삭제할 행의 인덱스 (지정하지 않으면 맨 마지막 행이 삭제됨)

Return
type	description
Array	삭제한 행이 가지고 있던 데이터가 담긴 1차원 배열

Sample

// 인덱스가 0인 행을 삭제 var returnArr = dlt_dataList1.removeRow(0); //반환 값 예시 ) ["IT","전지현"]

removeRows( rowIndexArr )

여러 행을 한번에 삭제하고, 삭제된 데이터들을 2차원 배열로 반환

Parameter
name	type	required	description
rowIndexArr	Array	Y	삭제할 행의 인덱스를 담은 배열

Return
type	description
Array	삭제한 행들이 가지고 있던 데이터를 담은 2차원 배열

Sample

//'부서'와 '이름'이 정의된 경우 //인덱스가 3과 4인 행을 삭제 var rsData = dlt_dataList1.removeRows([3,4]) //반환 값 예시 ) [["홍보","이광수"],["인사","류승룡"]]

restore( )

데이터를 변경 한 단계 전으로 되돌림 (한번 수행 시마다 한 단계씩 되돌아감) (관련 함수) redo();

Sample

// 데이터 변경 시점을 이전 단계로 되돌림 dlt_dataList1.restore();

rowMoveDown( rowIndex )

DataList를 기준으로, 지정한 행과 한 줄 아래 행의 순서를 바꿈 (참고 사항) 정렬 등을 적용하여 실제 DataList와 보여지는 DataList가 다를 경우 rowMoveDownFiltered() 함수 사용 연결된 GridView에서 GridView 컬럼의 inputType이 drilldown인 경우 권장하지 않음

Parameter
name	type	required	description
rowIndex	Number	Y	행의 인덱스

Sample

// 인덱스 0번째 행과 인덱스 1번째 행의 순서가 바뀜 dlt_dataList1.rowMoveDown(0);

rowMoveDownFiltered( rowIndex )

화면에 보이는 순서를 기준으로, 지정한 행과 한 줄 아래 행의 순서를 바꿈 (참고 사항) 연결된 GridView에서 GridView 컬럼의 inputType이 drilldown인 경우 권장하지 않음

Parameter
name	type	required	description
rowIndex	Number	Y	행의 인덱스

Sample

// 인덱스 0번째 행과 인덱스 1번째 행의 순서가 바뀜 dlt_dataList1.rowMoveDownFiltered(0);

rowMoveUp( rowIndex )

DataList를 기준으로, 지정한 행과 한 줄 위에 행의 순서를 바꿈 (참고 사항) 정렬 등을 적용하여 실제 DataList와 보여지는 DataList가 다를 경우 rowMoveUpFiltered() 함수 사용 연결된 GridView에서 GridView 컬럼의 inputType이 drilldown인 경우 권장하지 않음

Parameter
name	type	required	description
rowIndex	Number	Y	행의 인덱스

Sample

// 인덱스 1번째 행과 인덱스 0번째 행의 순서가 바뀜 dlt_dataList1.rowMoveUp(1);

rowMoveUpFiltered( rowIndex )

화면에 보이는 순서를 기준으로, 지정한 행과 한 줄 위에 행의 순서를 바꿈 (참고 사항) 연결된 GridView에서 GridView 컬럼의 inputType이 drilldown인 경우 권장하지 않음

Parameter
name	type	required	description
rowIndex	Number	Y	행의 인덱스

Sample

// 인덱스 1번째 행과 인덱스 0번째 행의 순서가 바뀜 dlt_dataList1.rowMoveUpFiltered(1);

setArray( jsonData , append )

1차원 배열의 데이터를 지정한 컬럼 순서대로 DataList에 설정함 (참고 사항) 추가된 행의 상태는 초기 상태('R')로 설정됨

Parameter
name	type	required	description
jsonData	JSON	Y	컬럼 정보와 데이터를 담고 있는 JSON
append	String	N	[default:false, true] 추가 여부 (false일 경우 기존의 데이터는 모두 삭제되고, true일 경우 기존 데이터 하위에 행이 추가됨)

Sample

//기존의 DataList에 컬럼이 "name", "dept", "phone" 순서로 정의되어 있는 경우 //기존 데이터를 모두 삭제하고, "dept"와 "name" 컬럼에 3건의 데이터를 설정 (append: false) var tmpColInfoArr = ["dept","name"]; var tmpDataArr = ["IT","손예진","홍보","이광수","인사","전지현"]; //설정할 데이터의 순서를 tmpColInfoArr 변수의 컬럼 순서로 맞추기 dlt_dataList1.setArray( {"columnInfo":tmpColInfoArr, "data":tmpDataArr} );

setBroadcast( flag , refresh )

API로 데이터 변경 시, DataList와 바인딩(Binding)된 컴포넌트(화면)에 변경 내용을 적용할지 여부를 설정 (참고 사항) 변경할 데이터의 양이 많을 경우 성능 향상을 위해 사용

Parameter
name	type	required	description
flag	Boolean	Y	[true, false] 변경 내용을 DataList에 갱신할지 여부
refresh	Boolean	Y	[true, false] 화면 새로 고침 여부

Sample

dlt_dataList1.setBroadcast(false); // flag를 false로 설정 (변경 내용이 DataList와 바인딩된 컴포넌트에 갱신 되지 않음) dlt_dataList1.setBroadcast(true); // flag를 true로, refresh를 false로 설정 (변경 내용이 DataList에 갱신되지만 바인딩된 컴포넌트를 갱신하진 않음) dlt_dataList1.setBroadcast(true, true); // flag와 refresh를 true로 설정 (변경 내용이 DataList와 바인딩된 컴포넌트에 즉시 갱신됨)

setCellAllData( realRowIndex , colIndex , data )

필터가 적용되어 있는 경우, 필터링되지 않은 행의 인덱스를 기준으로 setCellData()를 실행한 후 필터 상태를 갱신함 (관련 함수) setCellData();

Parameter
name	type	required	description
realRowIndex	Number	Y	필터링되지 않은 기준의 행 인덱스
colIndex	Number\|\|String	Y	컬럼의 인덱스 또는 아이디
data	String	Y	셀에 넣어줄 데이터

Sample

// 인덱스 1, 2번 행이 필터링되어 감춰진 경우 dlt_dataList1.setCellData(3,"name", "100"); // 인덱스 3번째 행의 "name" 컬럼에 "100"이라는 값을 설정 dlt_dataList1.setCellAllData(3, "name", "100"); // 그 후 필터 상태를 갱신하여 UI를 다시 그림

setCellData( rowIndex , colIndex , data )

원하는 셀에 데이터를 설정함

Parameter
name	type	required	description
rowIndex	Number	Y	행의 인덱스
colIndex	Number\|\|String	Y	컬럼의 인덱스 또는 아이디
data	String	Y	설정할 데이터

Sample

//인덱스가 0인 행의 "name" 컬럼에 "전지현"이란 값을 설정함 dlt_dataList1.setCellData(0, "name", "전지현");

setColumnDefaultValue( colIndex , defaultValue )

행을 삽입하거나 초기 데이터를 설정할 때 지정한 컬럼에 기본 값을 할당함

Parameter
name	type	required	description
colIndex	Number\|\|String	Y	열의 인덱스 또는 아이디
defaultValue	String	Y	열에 설정할 기본값

Sample

// "name" 컬럼의 기본 값을 "필수입력"으로 설정 dlt_dataList1.setColumnDefaultValue('name', '필수입력'); // 위와 같이 API를 호출한 뒤 아래와 같이 insertRow() API를 호출하면 "name"의 컬럼에 "필수입력"의 값이 설정됨 dlt_dataList1.insertRow(0);

setColumnFilter( filterOptions )

지정한 컬럼에 필터 적용

Parameter
name	type	required	description
filterOptions	JSON	Y	필터 옵션

Sample

// (필터 적용 예시 - DataList와 GridView가 연동된 경우) // (1) type : "row" (키(key)로 넘어온 문자열에 대해 indexOf()를 이용하여 필터를 적용) // (예제) GridView의 dept 컬럼의 값이 "IT"를 포함하는 행만 표시 (like 검색) dlt_dataList1.setColumnFilter( {type:'row', colIndex:'dept', key:"IT", condition:'and'} ); // (예제) GridView의 dept 컬럼의 값이 "IT"인 데이터만 표시 (equal 검색) dlt_dataList1.setColumnFilter( {type:'row', colIndex:'dept', key:"IT", condition:'and', exactMatch:true} ); // (예제) GridView의 dept 컬럼의 값이 "IT" 혹은 "홍보"인 데이터만 표시 (condition 옵션을 "or"로 변경) dlt_dataList1.setColumnFilter( {type:'row', colIndex:'dept', key:"홍보", condition:'or'} ); // 위의 방법은 효율이 좋지 않으므로 아래와 같이 사용자 정의 필터 또는 정규 표현식을 이용하여 한 번에 적용할 것을 권장 // (2) type : "func" (개발자가 직접 데이터의 필터를 적용) // (예제) 사용자 정의 필터 - cellData가 "IT"와 "인사"를 적용 // cellData는 웹스퀘어 엔진에서 넘겨주는 셀의 데이터로, colIndex에 설정한 컬럼의 데이터 // tmpParam은 setColumnFilter() API를 호출 할 때 넘겨주는 파라미터 값 // rowIdx는 웹스퀘어 엔진에서 넘겨주는 행의 인덱스 var fn_tmpDeptFilter = function(cellData, tmpParam, rowIdx){ if(cellData.indexOf("IT") > -1){ return true; }else if(cellData.indexOf("인사") > -1){ return true; } return false; // return이 true인 경우 적용하고 false인 경우 넘김 } // (예제) dept 컬럼의 데이터가 "IT"이거나 "인사"인 데이터만 표시 // 함수(function)에 별도의 파라미터는 추가하지 않음 dlt_dataList1.setColumnFilter( {type:'func', colIndex:'dept', key:fn_tmpDeptFilter, condition:'and'} ); // (3) type : "regExp" (정규 표현식을 이용하여 필터를 적용) // (예제) dept 컬럼의 값이 "IT" 또는 "홍보"인 데이터만 표시 dlt_dataList1.setColumnFilter( {type:'regExp', colIndex:'dept', key:/IT|홍보/gi, condition:'and'} );

setData( arr , append , columnArr , rowStatus )

1차원 배열 데이터를 설정하거나 추가함 (참고 사항) 세 번째 파라미터인 columnArr를 사용할 경우, 두 번째 파라미터인 append의 값을 항상 지정해줘야 함 추가된 행의 상태는 초기 상태(상태값: R)로 설정됨

Parameter
name	type	required	description
arr	Array\|\|String	Y	1차원 배열 또는 배열 형태의 문자열 (소스 안쪽에서 배열로 변환)
append	Boolean	N	[default:false, true] 추가 여부
columnArr	Array\|\|String	N	데이터를 설정할 컬럼의 아이디가 담긴 배열 (데이터의 순서를 지정) 또는 배열 형태의 문자열 (소스 안쪽에서 배열로 변환)
rowStatus	Array	N	설정할 데이터의 행의 상태들을 담은 1차원 배열

Sample

//DataList에 아이디가 "name", "dept"인 컬럼이 정의된 경우 //2건(행)의 데이터를 설정 dlt_dataList1.setData(["송지효","홍보","김상중","준법감시"]); //2건(행)의 데이터 중 "name" 컬럼의 데이터를 설정하고, "name"을 제외한 나머지 컬럼은 빈 값("")을 설정 dlt_dataList1.setData(["송지효","김상중"],false,["name"]); //2건(행)의 데이터 중 "name" 컬럼의 데이터를 설정하고 행의 상태를 변경 dlt_dataList1.setData(["송지효","김상중"],false,["name"],["U", "D"]); //서버에서 배열 형태의 문자열을 받은 경우 (자바에서 DB의 값을 꺼내, 값과 값을 "%||%"로 추가하여 생성) var tmpStr = "송지효%||%홍보%||%김상중%||%준법감시"; var tmpArr = tmpStr.split("%||%"); dlt_dataList1.setData(tmpArr); //서버에서 배열 형태의 문자열을 받은 경우 다음과 같은 형태일 때 문자열을 배열로 자동 변환 var tmpStr = "[\"송지효\",\"홍보\",\"김상중\",\"준법감시\"]"; dlt_dataList1.setData(tmpStr);

setIgnoreStatus( flag )

DataList 컬럼 속성인 ignoreStatus를 동적으로 제어함 (ignoreStatus가 true이면 해당 컬럼의 값이 변경되어도 행의 상태가 변하지 않음)

Parameter
name	type	required	description
flag	Boolean	Y	[true, false] 설정 여부

Sample

dlt_dataList1.setIgnoreStatus("col1", true); // API 실행 이후 "col1" 컬럼 값이 변경되어도 행의 상태가 변경되지 않음 dlt_dataList1.setIgnoreStatus("col1", false); // API 실행 이후 "col1" 컬럼 값이 변경되면 행의 상태가 변경됨 dlt_dataList1.setIgnoreStatus("col1"); // 무효, 아무런 동작을 하지 않음

setJSON( jsonData , append )

JSON 데이터를 설정하거나 추가함 (참고 사항) 추가된 행의 상태는 초기 상태(상태값: R)로 설정됨

Parameter
name	type	required	description
jsonData	Array	Y	JSON 데이터를 담고 있는 배열
append	String	N	추가(append) 여부

Sample

//JSON 형태의 2건의 데이터를 추가 var tmpArr = [{"name":"손예진","dept":"인사"},{"name":"전지현","dept":"IT"}]; dlt_dataList1.setJSON( tmpArr );

setMatchIgnoreCase( flag )

Match 정보의 조회 시, 대소문자를 구별할지 여부를 설정 (관련 함수) getMatchedArray(); getMatchedColumnData(); getMatchedData(); getMatchedIndex(); getMatchedJSON(); getMatchedXML();

Parameter
name	type	required	description
flag	Boolean	Y	대소문자 구별 : false , 대소문자 무시 : true

Sample

dlt_dataList1.setMatchIgnoreCase(true); dlt_dataList1.getMatchedIndex("ab"); // 실행 결과 : dlt_dataList1의 데이터 중 "ab" 또는 "Ab" 또는 "aB" 또는 "AB"가 포함된 데이터의 인덱스를 반환 (대소문자 무시)

setRowArray( rowIndex , dataObj , overwrite )

지정한 인덱스에 1건(행)의 배열 데이터를 넣음
overwrite가 false인 경우 행을 생성함

Parameter
name	type	required	description
rowIndex	Number	Y	배열 데이터를 넣어줄 행의 인덱스
dataObj	JSON	Y	행에 넣을 데이터의 정보를 가진 JSON
overwrite	Boolean	N	[default: false, true] 덮어쓰기 여부 (true : rowIndex에 해당하는 행에 덮어쓰기 , false : rowIndex에 행이 삽입됨)

Sample

//아이디가 "name", "dept", "addr"인 컬럼을 가진 DataList가 정의된 경우 //행의 데이터 및 정보 생성 var dataObj = {}; dataObj.columnInfo = ["name","dept"]; dataObj.data = ["차승원", "홍보"]; //인덱스 0번째 행에 "name"과 "dept" 컬럼의 데이터만 넣음 dlt_dataList1.setRowArray(0, dataObj); //overwrite의 값이 없으므로 인덱스 0번째에 삽입됨

setRowData( rowIndex , rowData , overwrite )

지정한 인덱스에 1건(행)의 배열 데이터를 넣음
overwrite가 false인 경우에 행을 생성함
GridView와 바인딩(Binding)된 경우 함수 실행 후에 스크롤 위치가 유지됨

Parameter
name	type	required	description
rowIndex	Number	Y	배열 데이터를 넣어줄 행의 인덱스
rowData	Array	Y	DataList에 정의된 컬럼의 순서대로 데이터가 담긴 1차원 배열
overwrite	Boolean	N	[default: false, true] 덮어쓰기 여부 (true : rowIndex에 해당하는 행에 덮어쓰기 , false : rowIndex에 행이 삽입됨)

Sample

//DataList에 아이디가 "name", "dept"인 컬럼이 정의된 경우 //인덱스 0번째 행의 데이터를 아래의 데이터로 변경 dlt_dataList1.setRowData(0,["조진웅","보안감시"],true);

setRowJSON( rowIndex , rowData , overwrite )

지정한 인덱스에 1건(행)의 JSON 데이터를 넣음
overwrite가 false인 경우 행을 생성함

Parameter
name	type	required	description
rowIndex	Number	Y	데이터를 넣어줄 행의 인덱스
rowData	JSON	Y	행에 넣을 JSON 객체 데이터
overwrite	Boolean	N	[default: false, true] 덮어쓰기 여부 (true : rowIndex에 해당하는 행에 덮어쓰기 , false : rowIndex에 행이 삽입됨)

Sample

//DataList에 아이디가 "name", "dept"인 컬럼이 정의된 경우 //인덱스 0번째 행에 "name" 컬럼의 값만 있는 JSON 데이터를 넣음 dlt_dataList1.setRowJSON(0, {"name":"여진구"} );

setRowNumData( flag )

DataList의 get 관련 API의 반환 값 형식이 JSON 또는 XML일 경우 행의 순번 값을 추가할지 설정
해당 값은 GridView의 rowNumVisible 속성을 true로 설정하면 나오는 값과 동일하며 "rowNum"이라는 컬럼에 할당됨 (관련 함수) getAllJSON(); getRowJSON(); getAllXML(); getRowXML();

Parameter
name	type	required	description
flag	Boolean	Y	[true, false] 설정 여부

Sample

//DataList에 "name", "dept" 컬럼이 정의된 경우 //별도의 설정 없이 getRowJSON() API를 실행 dlt_dataList1.getRowJSON(0); //반환 값 예시 ) {"dept":"인사","name":"손예진","rowStatus":"R"} //"rowNum" 필드 추가 후 getRowJSON() API를 실행 dlt_dataList1.setRowNumData(true); dlt_dataList1.getRowJSON(0); //반환 값 예시 ) {"dept":"인사","name":"손예진","rowStatus":"R","rowNum":1}

setRowPosition( position , noEvent )

DataList와 연동된 컴포넌트에서 선택할 행의 위치를 설정함
단, ref 속성을 통해 연동되는 InputBox와 같은 단일 컴포넌트와 바인딩(Binding)된 경우에만 사용 (참고 사항) GridView와 바인딩(Binding)된 경우, 셀 선택은 GridView의 setFocusedCell() API를 사용해야 함 GridView의 setFocusedCell()을 통해 셀을 선택할 경우, 화면 상의 포커스도 함께 이동됨 GridView 화면 상의 포커스 이동 없이 DataList의 값만 선택하고 싶다면 본 API를 사용할 수 있음

Parameter
name	type	required	description
position	Number	N	선택할 행의 인덱스
noEvent	Boolean	N	[default: false, true] onrowpositionchange() 이벤트가 걸려있을 때, 이를 수행할 것인지 여부 (false는 onrowpositionchange() 이벤트를 수행, true는 onrowpositionchange() 이벤트를 수행하지 않음)

Sample

//데이터컬렉션에 아래와 같이 DataList를 정의한 경우 <w2:dataList id="dlt_dataList1"> <w2:columnInfo> <w2:column id="name" name="이름" dataType="text"></w2:column> <w2:column id="dept" name="부서" dataType="text"></w2:column> </w2:columnInfo> <w2:data xmlns=""> <w2:row> <name><![CDATA[손예진]]></name> <dept><![CDATA[인사]]></dept> </w2:row> <w2:row> <name><![CDATA[송강호]]></name> <dept><![CDATA[홍보]]></dept> </w2:row> <w2:row> <name><![CDATA[전지현]]></name> <dept><![CDATA[IT]]></dept> </w2:row> <w2:row> <name><![CDATA[류승룡]]></name> <dept><![CDATA[인사]]></dept> </w2:row> </w2:data> </w2:dataList> //<body> 영역에 아래와 같이 Input 컴포넌트의 ref 속성을 "data:dlt_dataList1.name"이 정의 <xf:input id="input1" style="position: relative;width: 144px;height: 21px;" ref="data:dlt_dataList1.name"></xf:input> //초기 로딩 시에는 input에 값이 없음 //DataList의 인덱스 0번째 행에 위치를 적용 dlt_dataList1.setRowPosition(0); //input의 display 예시 ) 손예진 //DataList의 인덱스 2번째 행에 위치를 적용 dlt_dataList1.setRowPosition(2); //input의 display 예시 ) 전지현

setRowXML( rowIndex , XML , overwrite )

지정한 행에 1건의 XML 데이터를 넣음
overwrite가 false인 경우 행을 생성함

Parameter
name	type	required	description
rowIndex	Number	Y	데이터를 넣어줄 행의 인덱스
XML	XML element	Y	행에 넣을 XML 데이터
overwrite	Boolean	N	[default: false, true] 덮어쓰기 여부 (true : rowIndex에 해당하는 행에 덮어쓰기 , false : rowIndex에 행이 삽입됨)

Sample

//XML 데이터 문자열 조합 var tmpXMLStr = "<map><name>전지현</name><dept>IT</dept></map>"; //XML 데이터 생성 var xmlDoc = WebSquare.xml.parse(tmpXMLStr); //DataList의 인덱스 0번째 행에 1건의 XML 데이터를 넣음 dlt_dataList1.setRowXML(0, xmlDoc);

setXML( xmlData , append )

XML 데이터를 설정(set)하거나 추가(append) (행의 상태는 초기 상태인 "R"로 변경됨)

Parameter
name	type	required	description
xmlData	XML	Y	XML 데이터
append	String	N	추가(append) 여부

Sample

// XML 문자열 생성 var tmpXMLStr = ""; tmpXMLStr += "<list>"; tmpXMLStr += "<map><name>전지현</name><dept>IT</dept></map>"; tmpXMLStr += "<map><name>류승룡</name><dept>인사</dept></map>"; tmpXMLStr += "</list>"; // XML 데이터 생성 var tmpXML = WebSquare.xml.parse(tmpXMLStr); // XML 형태의 2건의 리스트 데이터를 추가 dlt_dataList1.setXML(tmpXML);

sort( bodyColumnID , sortType )

단건의 컬럼을 정렬 (다건의 경우 multisort() API를 이용)
데이터 타입에 상관없이 text로 간주하여 정렬됨 (number 타입의 경우 multisort() API를 이용)

Parameter
name	type	required	description
bodyColumnID	String	Y	컬럼의 아이디
sortType	Number	Y	[0,1,2] 정렬 옵션 (0: 오름차순, 1: 내림차순, 2: 정렬 취소)

Sample

// "name" 컬럼의 값을 기준으로 오름차순 정렬 dlt_dataList1.sort('name', 0);

trigger( type , array )

DataList에 등록된 이벤트를 발생시킴

Parameter
name	type	required	description
type	String	Y	발생시킬 이벤트명
array	Object	N	이벤트 핸들러에 전달할 파라미터 배열

Sample

// dlt_dataList1에 oncelldatachange 이벤트를 발생시킴 dlt_dataList1.trigger("oncelldatachange"); // dlt_dataList1에 oncelldatachange이벤트를 발생시키고 핸들러 함수에 아래와 같은 인자(paramJSON)를 전달하여 호출 var paramJSON = {rowIndex:5,colID:"col1",oldValue:10,newValue:20}; dlt_dataList1.trigger("oncelldatachange", [ paramJSON ]);

unbind( type , function )

DataList의 이벤트를 동적으로 제거

Parameter
name	type	required	description
type	String	N	제거할 이벤트의 이름 (생략할 경우 해당 DataList의 모든 이벤트를 제거)
function	Function	N	제거할 이벤트의 핸들러 함수 (생략할 경우 해당 이벤트 type으로 등록된 모든 핸들러 함수를 제거)

Sample

//dlt_dataList1에 등록된 oncelldatachange() 이벤트에 등록한 핸들러 중에 func1 이벤트 핸들러를 제거 dlt_dataList1.unbind("oncelldatachange", func1); //dlt_dataList1에 등록된 모든 이벤트를 제거 dlt_dataList1.unbind();

undeleteRow( rowIndex )

지정한 인덱스에 해당하는 행의 삭제 상태(상태값: D, V)를 취소하고 직전 상태값으로 변경함
removeRow()와 같은 API로 삭제(상태값: E)한 행은 취소가 되지 않음

Parameter
name	type	required	description
rowIndex	Number	Y	삭제를 취소할 행의 인덱스

Sample

//인덱스 0번째 행의 delete 상태를 취소 (직전 상태값으로 변경됨) dlt_dataList1.undeleteRow(0);

undoAll( )

전체 데이터를 최초 설정 데이터로 바꾸고, 행의 상태를 초기 상태(R)로 변경함 (참고 사항) 최초 설정 데이터: setJSON, setXML 등과 같은 API들을 통해 설정된 데이터

Sample

//모든 갱신 되거나 삭제된 데이터를 되돌리고 최초 설정된 데이터로 변경 dlt_dataList1.undoAll();

undoRow( rowIndex )

행의 데이터와 상태를 직전 데이터와 상태로 변경

Parameter
name	type	required	description
rowIndex	Number	Y	데이터를 변경할 행의 인덱스

Sample

// 인덱스 0번째인 행을 직전 데이터로 복구 dlt_dataList1.undoRow(0);