PropertyEventMethod찾아보기
WebSquare.uiplugin.linkedDataList - 5.0_5.5283A.20250313.190345

데이터리스트의 데이터를 필터링하거나 정렬한 결과만을 저장하는 객체.
LinkedDataList를 직접 GridView에 바인딩하는 기능은 지원하지 않음.
SP5부터는 LinkedDataList를 사용하는 것 자체를 권장하지 않음.
그래도 사용한다면 AutoComplete, CheckBox, CheckComboBox, MultiSelect, SelectBox, Radio 컴포넌트에만 사용할 것을 권장함.
LinkedDataList와 바인딩된 컴포넌트에서는 ref를 사용하지 않는것을 권장하고 DataList의 데이터는 1,000건 이하를 권장하며 최대 10,000건까지 지원.

Type

uiplugin

Property Summary

bind
LinkedDataList가 바인딩할 DataList의 아이디
id
LinkedDataList의 아이디
rowStatusNodeName
JSON 또는 XML형태로 데이터를 가져올 때 행상태 키(노드) 이름을 설정하는 기능
userData1
사용자 정의 데이터 속성
userData2
사용자 정의 데이터 속성
userData3
사용자 정의 데이터 속성

Event Summary

Method Summary

clearFilter( )
LinkedDataList에 설정되어 있는 필터 상태를 초기화
clearSort( )
LinkedDataList의 모든 정렬을 취소
clearSortFilter( )
linkedDataList에 설정된 정렬 상태의 필터를 초기 상태로 설정함
getAllData( )
모든 데이터를 배열로 반환
getAllFilteredData( )
LinkedDataList에서 filterRowIndex 순서의 모든 fliteredData를 배열로 반환
getAllFilteredJSON( )
LinkedDataList에 필터 된 행 순서의 모든 데이터를 JSON 객체로 반환
getAllFilteredXML( )
필터가 적용된 데이터 전체를 XML로 반환
getAllJSON( )
모든 데이터를 JSON 객체로 반환
getAllNoFilteredData( )
LinkedDataList의 필터 상태가 되지 않은 모든 데이터를 가져옴
getAllXML( )
LinkedDataList의 모든 데이터를 XML로 반환
getCellData( rowIndex , colIndex )
행의 인덱스와 열의 인덱스에 해당하는 셀의 데이터를 반환
getColData( colID )
행의 인덱스에 해당하는 필터 처리 혹은 정렬 처리되지 않은 열의 데이터를 배열로 반환함
getColumnDistinctDataArray( colIndex )
지정한 컬럼에 존재하는 중복된 항목을 제거한 데이터 배열을 정렬하여 보여줌
getDataLength( )
현재 화면에 보이는 행의 수를 반환 (getRowCount()와 동일)
getDataRow( rowIndex )
rowIndex에 해당하는 행의 데이터를 컬럼의 아이디를 키로 하는 해쉬 형태로 반환
getDeletedData( )
삭제 상태인 행들을 배열로 반환
getDeletedIndex( )
삭제 상태인 행의 인덱스를 배열로 반환
getDeletedJSON( )
삭제 상태인 행들의 데이터를 JSON 객체로 반환
getDeletedXML( )
삭제 상태인 행들의 데이터를 XML로 반환
getFilterCondition( )
필터 조건(Filter Condition)을 반환하는 함수
getFilteredColData( colIndex )
필터링 된 행에 해당하는 컬럼의 데이터를 배열로 반환
getFilteredRowIndex( realRowIndex )
필터링된 상태의 행 인덱스를 반환
getFusionChartData( chartType , labelColumn , seriesColumns )
LinkedDataList의 데이터를 FusuionChart를 위한 JSON 데이터로 반환
getID( )
LinkedDataList 객체의 아이디를 반환
getInsertedData( )
삽입 상태인 행들의 데이터를 배열로 반환
getInsertedIndex( )
삽입 상태인 행의 번호를 배열로 반환
getInsertedJSON( )
삽입 상태인 행들의 데이터를 JSON 객체로 반환
getInsertedXML( )
삽입 상태인 행들의 데이터를 XML로 반환
getLinkedRealRowIndex( filteredRowIndex )
linkedRealRowIndex(LinkedDataList를 0번째부터 시작하는 독립적인 데이터 객체로 가정했을 때의 행 인덱스)를 반환
getMatchedColumnData( matchCol , dataValue , targetCol , exactMatch , stRowIndex , lastRowIndex )
검사를 시작할 행의 인덱스부터 끝낼 행의 인덱스 까지의 행 중에서 지정한 컬럼의 값이 지정한 값과 같은 행들을 찾아서 targetCol(데이터를 가져올 컬럼의 아이디)에 해당하는 컬럼의 값들을 배열로 반환
getMatchedData( colID , dataValue , exactMatch , stRowIndex , lastRowIndex )
검사를 시작할 행의 인덱스부터 끝낼 행의 인덱스 까지의 행 중에서 지정한 컬럼의 값이 지정한 값과 같은 행들의 데이터를 배열로 반환
getMatchedIndex( colID , dataValue , exactMatch , stRowIndex , lastRowIndex )
stRowIndex부터 lastRowIndex 까지의 범위의 행중에서 colID의 값이 dataValue와 같은 행들의 인덱스를 반환
getMatchedJSON( colID , dataValue , exactMatch , stRowIndex , lastRowIndex )
stRowIndex부터 lastRowIndex까지의 범위의 행 중에서 colID의 값이 dataValue와 같은 행들의 데이터를 JSON 객체로 반환
getMatchedXML( colID , dataValue , exactMatch , stRowIndex , lastRowIndex )
검사를 시작할 행의 인덱스부터 끝낼 행의 인덱스 까지의 행 중에서 지정한 컬럼의 값이 지정한 값과 같은 행들의 데이터를 XML로 반환
getModifiedData( )
변경(삽입, 갱신, 삭제) 행들의 데이터를 배열로 반환
getModifiedIndex( )
추가, 삭제 상태인 행의 번호를 배열로 반환
getModifiedJSON( )
변경(삽입, 갱신, 삭제) 상태 행들의 데이터를 JSON 객체로 반환
getModifiedXML( )
변경(삽입, 갱신, 삭제) 행들의 데이터를 XML로 반환
getObjectType( )
DataCollection의 형식을 반환함
getOption( attr )
LinkedDataList 객체의 옵션을 조회하는 API
getOriginalCellData( rowIndex , colIndex )
rowIndex와 colIndex에 해당하는 셀의 데이터를 반환
getParentRealRowIndex( linkedRealRowIndex )
linkedRealRowIndex(LinkedDataList를 0번째부터 시작하는 독립적인 데이터 객체로 가정했을 때의 행 인덱스)를 통해 parentRealRowIndex(부모 데이터리스트에 해당하는 실제 행 인덱스)를 반환
getParentRowIndex( rowIndex )
드릴다운 사용시 rowIndex에 해당하는 행의 부모 행의 행 번호를 반환
getRangeData( from , to )
from부터 to 까지의 범위의 행의 데이터를 배열로 반환함
getRangeJSON( from , to )
from부터 to 까지의 범위의 행의 데이터를 JSON 객체로 반환
getRangeXML( from , to )
from부터 to 까지 범위의 행의 데이터 XML을 반환
getRealRowIndex( filteredRowIndex )
filteredRowIndex에 대한 실제 데이터의 filteredRowIndex를 반환
getRowCount( )
데이터 행의 건수를 반환
getRowData( filteredRowIndex )
rowIndex에 해당하는 행의 데이터를 배열로 반환
getRowIndexByStatus( statusStr )
지정한 상태와 일치하는 행의 번호를 배열로 반환
getRowJSON( filteredRowIndex )
filteredRowIndex에 해당하는 행의 데이터를 JSON 객체로 반환함
getRowStatus( rowIndex )
rowIndex에 해당하는 행의 상태를 반환 (초기상태:"R", 갱신:"U", 삽입:"C", 삭제:"D", 삽입 후 삭제:"V")
getRowStatusValue( rowIndex )
rowIndex에 해당하는 행의 상태를 반환
getRowXML( filteredRowIndex )
filteredRowIndex에 해당하는 행의 데이터를 XML로 반환
getScope( )
scope 속성이 true인 WFrame의 자식 컴포넌트에서 해당 부모 WFrame 객체를 반환하는 함수
getScopeWindow( )
컴포넌트가 scope=true인 WFrame의 자식 컴포넌트일 때 해당 부모 WFrame의 Scope객체를 반환하는 함수
getSortCondition( )
LinkedDataList의 sortCondition을 반환하는 함수
getTotalCol( )
컬럼의 개수를 반환
getTotalRow( )
행의 개수를 반환
getUnmatchedColumnData( matchCol , dataValue , targetCol , exactMatch , stRowIndex , lastRowIndex )
검사를 시작할 행의 인덱스부터 끝낼 행의 인덱스 까지의 행 중에서 지정한 컬럼의 값이 지정한 값과 다른 행들을 찾아서 targetCol에 해당하는 열의 값들을 배열로 반환
getUnmatchedData( colID , dataValue , exactMatch , stRowIndex , lastRowIndex )
검사를 시작할 행의 인덱스부터 끝낼 행의 인덱스 까지의 행 중에서 지정한 컬럼의 값이 지정한 값과 다른 행들의 데이터를 배열로 변환하여 배열에 담아 반환
getUnmatchedIndex( colID , dataValue , exactMatch , stRowIndex , lastRowIndex )
검사를 시작할 행의 인덱스부터 끝낼 행의 인덱스 까지의 행 중에서 지정한 컬럼의 값이 지정한 값과 다른 행들의 인덱스를 배열로 반환
getUnmatchedJSON( colID , dataValue , exactMatch , stRowIndex , lastRowIndex )
검사를 시작할 행의 인덱스부터 끝낼 행의 인덱스 까지의 행 중에서 지정한 컬럼의 값이 지정한 값과 다른 행들의 데이터를 JSON 객체로 반환
getUnmatchedXML( colID , dataValue , exactMatch , stRowIndex , lastRowIndex )
검사를 시작할 행의 인덱스부터 끝낼 행의 인덱스 까지의 행 중에서 지정한 컬럼의 값이 지정한 값과 다른 행들의 데이터를 XML로 반환
getUpdatedData( )
갱신 상태인 행들의 데이터를 배열로 반환
getUpdatedIndex( )
갱신 상태인 행의 번호를 배열로 반환
getUpdatedJSON( )
갱신 상태인 행들의 데이터를 JSON 객체로 반환
getUpdatedXML( )
갱신 상태인 행들의 데이터를 XML로 반환
multisort( options )
options에 따라서 여러 개의 열을 동시에 정렬
removeColumnFilter( colID )
colID에 해당하는 열에 적용된 필터를 삭제
removeColumnFilterAll( )
모든 열에 적용된 필터를 삭제
setColumnFilter( options )
options.colIndex에 해당하는 열에 필터 적용
setCondition( type , condition )
필터 조건 또는 정렬 조건을 설정
setOption( key , value )
LinkedDataList 객체의 옵션을 설정하는 API
sort( bodyColumnID , sortType )
LinkedDataList의 bodyColumnID에 해당하는 열을 정렬해줌

Property Detail

bind
LinkedDataList가 바인딩할 DataList의 아이디
id
LinkedDataList의 아이디
rowStatusNodeName
JSON 또는 XML형태로 데이터를 가져올 때 행상태 키(노드) 이름을 설정하는 기능
기본값은 "rowStatus"
userData1
사용자 정의 데이터 속성 (관련 함수) getUserData("userData1") //API를 통해 설정한 값을 얻어올 수 있음
userData2
사용자 정의 데이터 속성 (관련 함수) getUserData("userData2") //API를 통해 설정한 값을 얻어올 수 있음
userData3
사용자 정의 데이터 속성 (관련 함수) getUserData("userData3") //API를 통해 설정한 값을 얻어올 수 있음

Event Detail

Method Detail

clearFilter( )
LinkedDataList에 설정되어 있는 필터 상태를 초기화
Sample
ldt_LinkedDataList1.clearFilter()
clearSort( )
LinkedDataList의 모든 정렬을 취소
Sample
ldt_LinkedDataList1.clearSort(); // 정렬을 취소
clearSortFilter( )
linkedDataList에 설정된 정렬 상태의 필터를 초기 상태로 설정함
getAllData( )
모든 데이터를 배열로 반환
Return
typedescription
Array데이터 배열 (1차원 배열)
Sample
// 아이디가 a, b, c, d, e인 5개 컬럼이 존재하는 linkedDataList에서 전체 행이 20 건인 경우 var returnArr = ldt_LinkedDataList1.getAllData(); returnArr.length 는 100 returnArr[0] 은 첫 번째 행의 'a' 컬럼의 값 returnArr[1] 은 첫 번째 행의 'b' 컬럼의 값 ... returnArr[5] 는 두 번째 행의 'a' 컬럼의 값 ...
getAllFilteredData( )
LinkedDataList에서 filterRowIndex 순서의 모든 fliteredData를 배열로 반환
Return
typedescription
ArrayLinkedDataList의 데이터 배열 (1차원 배열)
getAllFilteredJSON( )
LinkedDataList에 필터 된 행 순서의 모든 데이터를 JSON 객체로 반환
Return
typedescription
JSONJSON 객체 데이터
getAllFilteredXML( )
필터가 적용된 데이터 전체를 XML로 반환
Return
typedescription
XML필터가 적용된 전체 데이터
Sample
var filteredData = ldt_LinkedDataList1.getAllFilteredXML() //반환 값 예시 <list id="dlt_member"> <map index="0"> <EMP_CD>100001</EMP_CD> <EMP_NM>윤세진</EMP_NM> <rowStatus statusValue="0">R</rowStatus> </map> </list>
getAllJSON( )
모든 데이터를 JSON 객체로 반환
Return
typedescription
JSONJSON 객체 데이터
Sample
// 아이디가 a, b, c, d, e인 5개 컬럼이 존재하는 linkedDataList var returnJSONStr = JSON.stringify(ldt_LinkedDataList1.getAllJSON()); baseNode : gridData , repeatNode : vector , valueNode : value 일 경우, returnXMLStr의 예는 다음과 같음 [{"a":"20120101","b":"23456","c":"Inswave","d":"WebSquare","e":"sample"}, {"a":"20120102","b":"34567","c":"Inswave","d":"WebSquare","e":"sample2"} ... (중략) ]
getAllNoFilteredData( )
LinkedDataList의 필터 상태가 되지 않은 모든 데이터를 가져옴
Return
typedescription
Array데이터 배열 (1차원 배열)
getAllXML( )
LinkedDataList의 모든 데이터를 XML로 반환
Return
typedescription
XMLLinkedDataList의 데이터
Sample
var xmlData = ldt_LinkedDataList1.getAllXML() <list id="dlt_member"> <map index="0"> <EMP_CD>100001</EMP_CD> <EMP_NM>윤세진</EMP_NM> <rowStatus statusValue="0">R</rowStatus> </map> <map index="1"> <EMP_CD>100002</EMP_CD> <EMP_NM>김영희</EMP_NM> <rowStatus statusValue="1">U</rowStatus> </map> </list>
getCellData( rowIndex , colIndex )
행의 인덱스와 열의 인덱스에 해당하는 셀의 데이터를 반환
Parameter
nametyperequireddescription
rowIndexNumberY셀의 행 번호
colIndexStringY셀의 컬럼 번호 혹은 컬럼의 아이디
Return
typedescription
StringrowIndex와 colIndex에 해당하는 셀의 데이터
Sample
var returnValue = ldt_linkedDataList1.getCellData(0, "a"); //첫 번째 row, "a" 컬럼에 해당하는 셀의 데이터를 반환
getColData( colID )
행의 인덱스에 해당하는 필터 처리 혹은 정렬 처리되지 않은 열의 데이터를 배열로 반환함
Parameter
nametyperequireddescription
colIDNumberY데이터를 가져올 열 번호 혹은 컬럼 아이디
Return
typedescription
Object열의 인덱스에 해당하는 열의 데이터의 배열
Sample
var returnArr = ldt_LinkedDataList1.getColData('a'); //returnArr는 'a' 컬럼의 데이터 배열
getColumnDistinctDataArray( colIndex )
지정한 컬럼에 존재하는 중복된 항목을 제거한 데이터 배열을 정렬하여 보여줌
Parameter
nametyperequireddescription
colIndexNumberY중복된 항목을 제거한 데이터를 검색할 컬럼의 인덱스
Return
typedescription
Object데이터를 저장한 배열
getDataLength( )
현재 화면에 보이는 행의 수를 반환 (getRowCount()와 동일)
Return
typedescription
Number행의 수
getDataRow( rowIndex )
rowIndex에 해당하는 행의 데이터를 컬럼의 아이디를 키로 하는 해쉬 형태로 반환
Parameter
nametyperequireddescription
rowIndexNumberY데이터를 가져올 행 번호
Return
typedescription
ObjectrowIndex에 해당하는 행의 데이터 객체
Sample
var rowData = ldt_LinkedDataList1.getDataRow(0); 반환 값 예시 {EMP_CD:"100001", EMP_NM: "윤세진"}
getDeletedData( )
삭제 상태인 행들을 배열로 반환
Return
typedescription
Array삭제 상태인 행들을 배열로 반환 (2차원 배열)
Sample
var returnArr = ldt_LinkedDataList1.getDeletedData();
getDeletedIndex( )
삭제 상태인 행의 인덱스를 배열로 반환
Return
typedescription
Array삭제 상태인 행의 인덱스의 배열
Sample
var returnArr = ldt_LinkedDataList1.getDeletedIndex();
getDeletedJSON( )
삭제 상태인 행들의 데이터를 JSON 객체로 반환
Return
typedescription
JSON삭제 상태인 행들의 JSON 객체 데이터
Sample
var returnJsonStr = JSON.stringify(ldt_LinkedDataList1.getDeletedJSON()); //returnJsonStr은 삭제 상태(3, 4, D, V)의 행들의 데이터 JSON 객체 문자열
getDeletedXML( )
삭제 상태인 행들의 데이터를 XML로 반환
Return
typedescription
XML삭제 상태인 행들의 데이터 XML
Sample
var deletedData = ldt_LinkedDataList1.getDeletedXML(); <list id="dlt_member"> <map index="0"> <EMP_CD>100001</EMP_CD> <EMP_NM>윤세진</EMP_NM> <rowStatus statusValue="3">D</rowStatus> </map> </list>
getFilterCondition( )
필터 조건(Filter Condition)을 반환하는 함수
getFilteredColData( colIndex )
필터링 된 행에 해당하는 컬럼의 데이터를 배열로 반환
Parameter
nametyperequireddescription
colIndexString||NumberY데이터를 반환할 컬럼의 인덱스 또는 아이디
Return
typedescription
ArraycolIndex에 해당하는 열의 필터링 된 데이터의 배열
Sample
var returnArr = ldt_LinkedDataList1.getFilteredColData('a'); //returnArr는 'a' 열의 필터 된 데이터 배열
getFilteredRowIndex( realRowIndex )
필터링된 상태의 행 인덱스를 반환
Parameter
nametyperequireddescription
realRowIndexNumberY필터링되지 않은 상태의 행 인덱스
Return
typedescription
Number필터링된 된 상태의 행 인덱스
getFusionChartData( chartType , labelColumn , seriesColumns )
LinkedDataList의 데이터를 FusuionChart를 위한 JSON 데이터로 반환
Parameter
nametyperequireddescription
chartTypeStringYFusionChart의 차트타입
labelColumnStringYFusionChart의 lable 데이터로 사용할 데이터컬렉션의 컬럼의 아이디값
seriesColumnsStringYFusionChart의 series 데이터로 사용할 데이터컬렉션 컬럼의 정보로 배열 형식의 문자열
Return
typedescription
JSONFusionChart의 데이터로 변환된 JSON 데이터
Sample
var chartData = ldt_LinkedDataList1.getFusionChartData("column2D","Month","[['Year1','Year2']]");
getID( )
LinkedDataList 객체의 아이디를 반환
Return
typedescription
StringLinkedDataList 객체의 아이디를 반환
getInsertedData( )
삽입 상태인 행들의 데이터를 배열로 반환
Return
typedescription
Array삽입 상태인 행들의 데이터 배열 (2차원 배열)
Sample
var returnArr = ldt_LinkedDataList1.getInsertedData(); //returnArr는 삽입 상태(2, C)의 행들의 데이터 배열
getInsertedIndex( )
삽입 상태인 행의 번호를 배열로 반환
Return
typedescription
Array삽입 상태인 행의 번호의 배열
Sample
var returnArr = ldt_LinkedDataList1.getInsertedIndex(); //returnArr는 삽입 상태(2, C)의 행들의 배열
getInsertedJSON( )
삽입 상태인 행들의 데이터를 JSON 객체로 반환
Return
typedescription
JSON삽입 상태인 행들의 JSON 객체 데이터
Sample
var returnJsonStr = JSON.stringify(ldt_LinkedDataList1.getInsertedJSON()); //returnJsonStr은 삽입 상태(2, C)의 행들의 데이터 JSON 객체 문자열
getInsertedXML( )
삽입 상태인 행들의 데이터를 XML로 반환
Return
typedescription
XML삽입 상태인 행들의 데이터 XML
Sample
var returnXMLStr = WebSquare.xml.indent(ldt_LinkedDataList1.getInsertedXML()); //returnXMLStr 은 삽입 상태(2, C)의 행들의 데이터 XML 문자열
getLinkedRealRowIndex( filteredRowIndex )
linkedRealRowIndex(LinkedDataList를 0번째부터 시작하는 독립적인 데이터 객체로 가정했을 때의 행 인덱스)를 반환
보여지는 인덱스와 실제 인덱스가 달라지는 드릴다운 구조에서 주로 사용
Parameter
nametyperequireddescription
filteredRowIndexNumberY그리드뷰 기준의 보여지는 행 인덱스
Return
typedescription
NumberLinkedDataList 내부의 realRowIndex
Sample
// 부모 데이터리스트의 행이 [0,1,2,3,4,5,6,7,8,9], LinkedDataList의 행은 [1,3,5,7,9]이고 LinkedDataList와 바인딩 된 GridView는 [1,5,9]번 행이 출력 되는 상황을 가정 ldt_LinkedDataList1.getLinkedRealRowIndex(1); // 반환 값: 2 (GridView 기준 인덱스 1은 '5', '5'의 linkedRealRowIndex는 2) ldt_LinkedDataList1.getLinkedRealRowIndex(2); // 반환 값: 4 (GridView 기준 인덱스 2는 '9', '9'의 linkedRealRowIndex는 4)
getMatchedColumnData( matchCol , dataValue , targetCol , exactMatch , stRowIndex , lastRowIndex )
검사를 시작할 행의 인덱스부터 끝낼 행의 인덱스 까지의 행 중에서 지정한 컬럼의 값이 지정한 값과 같은 행들을 찾아서 targetCol(데이터를 가져올 컬럼의 아이디)에 해당하는 컬럼의 값들을 배열로 반환
Parameter
nametyperequireddescription
matchColString||NumberY데이터를 검사할 컬럼의 인덱스 또는 아이디
dataValueStringYmatchCol에 해당하는 컬럼의 값과 비교할 값
targetColString||NumberY데이터를 가져올 컬럼의 인덱스 또는 아이디
exactMatchBooleanY정확히 일치하는지 여부
stRowIndexNumberY검사를 시작할 행의 인덱스
lastRowIndexNumberY검사를 끝낼 행의 인덱스
Return
typedescription
ArraytargetCol에 해당하는 열의 값을 가지고 있는 배열 (1차원 배열)
Sample
var lastRowIndex = ldt_LinkedDataList1.getRowCount(); var returnArr = ldt_LinkedDataList1.getMatchedColumnData( 'c', '영화', 'd', true, 0, lastRowIndex); //returnArr은 'c' 컬럼의 값이 '영화'인 컬럼의 행 인덱스에 해당하는 'd' 컬럼의 데이터 배열
getMatchedData( colID , dataValue , exactMatch , stRowIndex , lastRowIndex )
검사를 시작할 행의 인덱스부터 끝낼 행의 인덱스 까지의 행 중에서 지정한 컬럼의 값이 지정한 값과 같은 행들의 데이터를 배열로 반환
Parameter
nametyperequireddescription
colIDString||NumberY데이터를 검사할 컬럼의 인덱스 또는 아이디
dataValueStringYcolID에 해당하는 컬럼의 값과 비교할 값
exactMatchBooleanY정확히 일치하는지 여부
stRowIndexNumberY검사를 시작할 행의 인덱스
lastRowIndexNumberY검사를 끝낼 행의 인덱스
Return
typedescription
Array범위안의 데이터를 가지고 있는 배열 (2차원 배열)
Sample
var lastRowIndex = ldt_LinkedDataList1.getRowCount(); var returnArr = ldt_LinkedDataList1.getMatchedData( 'c', '영화', true, 0, lastRowIndex ); //returnArr는 데이터리스트 전체에서 'c' 컬럼의 값이 "영화"인 행의 데이터 배열
getMatchedIndex( colID , dataValue , exactMatch , stRowIndex , lastRowIndex )
stRowIndex부터 lastRowIndex 까지의 범위의 행중에서 colID의 값이 dataValue와 같은 행들의 인덱스를 반환
Parameter
nametyperequireddescription
colIDString||NumberY데이터를 검사할 컬럼의 인덱스 또는 아이디
dataValueStringY비교 데이터
exactMatchBooleanY[default:true, false] 정확한 일치 여부
stRowIndexNumberY데이터를 가져올 때 첫 행 인덱스
lastRowIndexNumberY데이터를 가져올 때 마지막 행 인덱스
Return
typedescription
Array범위안에 일치하는 인덱스를 가지고 있는 배열
Sample
var lastRowIndex = ldt_LinkedDataList1.getRowCount(); var returnArr = ldt_LinkedDataList1.getMatchedIndex( 'c', '영화', true, 0, lastRowIndex ); //returnArr는 LinkedDataList 전체에서 c컬럼의 값이 "영화" 인 행 인덱스 배열
getMatchedJSON( colID , dataValue , exactMatch , stRowIndex , lastRowIndex )
stRowIndex부터 lastRowIndex까지의 범위의 행 중에서 colID의 값이 dataValue와 같은 행들의 데이터를 JSON 객체로 반환
Parameter
nametyperequireddescription
colIDString||NumberY데이터를 검사할 열 번호 혹은 컬럼 아이디
dataValueStringYcolID 해당하는 열의 값과 비교할 데이터
exactMatchBooleanY정확히 일치하는지 여부
stRowIndexNumberY데이터를 가져오는 것을 시작할 행 번호
lastRowIndexNumberY데이터를 가져오는 것을 끝낼 행 번호
Return
typedescription
JSON범위안의 데이터를 가지고 있는 JSON 객체
Sample
var lastRowIndex = ldt_LinkedDataList1.getRowCount(); var returnJSONStr = JSON.stringify(ldt_LinkedDataList1.getMatchedJSON( 'c', '영화', true, 0, lastRowIndex )); //returnJSONStr은 LinkedDataList 전체에서 c컬럼의 값이 "영화"인 행의 데이터 JSON 객체 문자열
getMatchedXML( colID , dataValue , exactMatch , stRowIndex , lastRowIndex )
검사를 시작할 행의 인덱스부터 끝낼 행의 인덱스 까지의 행 중에서 지정한 컬럼의 값이 지정한 값과 같은 행들의 데이터를 XML로 반환
Parameter
nametyperequireddescription
colIDString||NumberY데이터를 검사할 컬럼의 인덱스 또는 아이디
dataValueStringYcolID에 해당하는 컬럼의 값과 비교할 값
exactMatchBooleanY정확히 일치하는지 여부
stRowIndexNumberY검사를 시작할 행의 인덱스
lastRowIndexNumberY검사를 끝낼 행의 인덱스
Return
typedescription
XML범위안의 데이터를 가지고 있는 XML
Sample
var lastRowIndex = ldt_LinkedDataList1.getRowCount(); var returnXMLStr = WebSquare.xml.indent(ldt_LinkedDataList1.getMatchedXML( 'c', '영화', true, 0, lastRowIndex )); //returnXMLStr은 linkedDataList 전체에서 'c' 컬럼의 값이 "영화"인 행의 데이터 XML 문자열
getModifiedData( )
변경(삽입, 갱신, 삭제) 행들의 데이터를 배열로 반환
Return
typedescription
Object변경(삽입, 갱신, 삭제) 행들의 데이터 배열 (2차원 배열)
Sample
var returnArr = ldt_LinkedDataList1.getModifiedData(); //returnArr는 갱신, 삽입, 삭제 상태(1,2,3, U,C,D)의 행들의 데이터 배열
getModifiedIndex( )
추가, 삭제 상태인 행의 번호를 배열로 반환
Return
typedescription
Array추가나 삭제 상태인 행의 번호의 배열
Sample
var returnArr = ldt_LinkedDataList1.getModifiedIndex(); //returnArr는 갱신, 삽입, 삭제 상태(1,2,3, U,C,D)의 행들의 배열
getModifiedJSON( )
변경(삽입, 갱신, 삭제) 상태 행들의 데이터를 JSON 객체로 반환
Return
typedescription
JSON변경(삽입, 갱신, 삭제) 행들의 JSON 객체 데이터
Sample
var returnJSON = ldt_LinkedDataList1.getModifiedJSON(); //반환 값 예시 [ {"EMP_CD": "100002", "EMP_NM": "김영희", "rowStatus": "U" }, {"EMP_CD": "100003", "EMP_NM": "윤정희","rowStatus": "U" } ]
getModifiedXML( )
변경(삽입, 갱신, 삭제) 행들의 데이터를 XML로 반환
Return
typedescription
XML변경(삽입, 갱신, 삭제) 행들의 데이터 XML
Sample
var returnXML = ldt_LinkedDataList1.getModifiedXML(); //returnXML 은 갱신, 삽입, 삭제 상태(1,2,3, U,C,D)의 행들의 데이터 XML
getObjectType( )
DataCollection의 형식을 반환함
Return
typedescription
StringDataCollection의 타입을 반환함 [DataMap, DataList, LinkedDataList]
Sample
var dataCollectionType = ldt_LinkedDataList1.getObjectType(); // DataCollectionType ldt_LinkedDataList1의 형식인 LinkedDataList를 반환
getOption( attr )
LinkedDataList 객체의 옵션을 조회하는 API
Parameter
nametyperequireddescription
attrStringY조회하는 옵션의 이름
Return
typedescription
String조회한 객체의 옵션이 존재할 경우 옵션의 값을 반환
Sample
var key = "id" $p.data.ldt_LinkedDataList1.getOption(id); //만약 최상위 객체의 키(Key)값의 옵션이 존재하지 않을 경우 null을 반환
getOriginalCellData( rowIndex , colIndex )
rowIndex와 colIndex에 해당하는 셀의 데이터를 반환
Parameter
nametyperequireddescription
rowIndexNumberY셀의 초기 행 번호
colIndexString|NumberY셀의 초기 컬럼 번호 혹은 아이디
Return
typedescription
StringrowIndex와 colIndex에 해당하는 셀의 데이터
Sample
var cellData1 = ldt_linkedDataList1.getOriginalCellData(0,"EMP_CD"); var cellData2 = ldt_linkedDataList1.getOriginalCellData(0,0);
getParentRealRowIndex( linkedRealRowIndex )
linkedRealRowIndex(LinkedDataList를 0번째부터 시작하는 독립적인 데이터 객체로 가정했을 때의 행 인덱스)를 통해 parentRealRowIndex(부모 데이터리스트에 해당하는 실제 행 인덱스)를 반환
Parameter
nametyperequireddescription
linkedRealRowIndexNumberYLinkedDataList를 0번째부터 시작하는 독립적인 데이터 객체로 가정했을 때의 행 인덱스
Return
typedescription
Number부모 데이터리스트의 행 인덱스 (realRowIndex)
Sample
// 부모 데이터리스트의 행이 [0,1,2,3,4,5,6,7,8,9], LinkedDataList의 행은 [1,3,5,7,9]이고 LinkedDataList와 바인딩 된 GridView는 [1,5,9]번 행이 출력 되는 상황을 가정 ldt_LinkedDataList1.getParentRealRowIndex(0); // 반환 값: 1 (LinkedDataList의 인덱스 0은 '1', '1'의 parentRealRowIndex는 1) ldt_LinkedDataList1.getParentRealRowIndex(1); // 반환 값: 3 ldt_LinkedDataList1.getParentRealRowIndex(2); // 반환 값: 5 ldt_LinkedDataList1.getParentRealRowIndex(3); // 반환 값: 7 ldt_LinkedDataList1.getParentRealRowIndex(4); // 반환 값: 9
getParentRowIndex( rowIndex )
드릴다운 사용시 rowIndex에 해당하는 행의 부모 행의 행 번호를 반환
Parameter
nametyperequireddescription
rowIndexNumberY부모를 찾을 행의 번호
Return
typedescription
Number부모 행의 인덱스
Sample
var rowIndex = ldt_LinkedDataList1.getParentRowIndex(5)
getRangeData( from , to )
from부터 to 까지의 범위의 행의 데이터를 배열로 반환함
Parameter
nametyperequireddescription
fromNumberY데이터를 가져오는 것을 시작할 행 번호
toNumberY데이터를 가져오는 것을 끝낼 행 번호
Return
typedescription
Object범위안의 데이터를 가지고 있는 배열 (1차원 배열)
Sample
// 아이디가 a, b, c, d, e인 5개 컬럼이 존재하는 LinkedDataList에서 a컬럼의 데이터형식이 date이고 b컬럼의 데이터형식이 number이며 각각의 displayFormat이 yyyy.MM.dd, #,###인 경우 // 첫번째 행의 각 컬럼의 데이터는 다음과 같음 ( 20120101 , 23456 , Inswave , WebSquare , sample ) var dataArr = ldt_LinkedDataList1.getRangeData(0, 1); dataArr.length 값은 5 dataArr[0] 은 20120101 dataArr[1] 은 23456 ...
getRangeJSON( from , to )
from부터 to 까지의 범위의 행의 데이터를 JSON 객체로 반환
Parameter
nametyperequireddescription
fromNumberY데이터를 가져오는 범위의 시작 행 번호
toNumberY데이터를 가져오는 범위의 끝 행 번호
Return
typedescription
JSON행의 인덱스에 해당하는 행의 JSON 객체 데이터
Sample
//아이디가 a, b, c, d, e인 5개 컬럼이 존재하는 LinkedDataList에서 a컬럼의 데이터형식이 date이고 b컬럼의 데이터형식이 number이며 각각의 displayFormat이 yyyy.MM.dd, #,###인 경우 //첫번째 행의 각 컬럼의 데이터는 다음과 같다. ( 20120101 , 23456 , Inswave , WebSquare , sample ) var returnJSONStr = JSON.stringify(ldt_LinkedDataList1.getRangeJSON(0, 1)); baseNode : gridData , repeatNode : vector , valueNode : value 일 경우, returnJSONStr은 다음과 같다. [{"a":"20120101","b":"23456","c":"Inswave","d":"WebSquare","e":"sample"}, {"a":"20120102","b":"34567","c":"Inswave","d":"WebSquare","e":"sample2"}]
getRangeXML( from , to )
from부터 to 까지 범위의 행의 데이터 XML을 반환
Parameter
nametyperequireddescription
fromNumberY데이터를 가져오는 범위의 시작 행 번호
toNumberY데이터를 가져오는 범위의 끝 행 번호
Return
typedescription
XMLrowIndex에 해당하는 행의 XML데이터
Sample
ldt_LinkedDataList1.getRangeXML(0, 3); <list id="dlt_member"> <map index="0"> <EMP_CD>100001</EMP_CD> <EMP_NM>윤세진</EMP_NM> <rowStatus statusValue="0">R</rowStatus> </map> <map index="1"> <EMP_CD>100002</EMP_CD> <EMP_NM>김영희</EMP_NM> <rowStatus statusValue="1">U</rowStatus> </map> </list>
getRealRowIndex( filteredRowIndex )
filteredRowIndex에 대한 실제 데이터의 filteredRowIndex를 반환
Parameter
nametyperequireddescription
filteredRowIndexNumberY현재 표시되고 있는 셀의 행 번호
Sample
ldt_LinkedDataList1.getRealRowIndex(3); // 3번째 행에 대한 실제 filteredRowIndex를 반환
getRowCount( )
데이터 행의 건수를 반환
Return
typedescription
NumberLinkedDataList의 데이터 행의 건수
Sample
var returnValue = ldt_LinkedDataList1.getRowCount(); // 데이터 행의 건수가 20인 경우 returnValue는 20
getRowData( filteredRowIndex )
rowIndex에 해당하는 행의 데이터를 배열로 반환
Parameter
nametyperequireddescription
filteredRowIndexNumberY데이터를 가져올 행 번호
Return
typedescription
ObjectrowIndex에 해당하는 행의 데이터의 배열
Sample
var dataArr = ldt_LinkedDataList.getRowData(0); // dataArr[0] 은 20120101 // dataArr[1] 은 23456 // 위와 같이 원래 값을 반환
getRowIndexByStatus( statusStr )
지정한 상태와 일치하는 행의 번호를 배열로 반환
Parameter
nametyperequireddescription
statusStrStringY상태가 일치하는 행을 찾기 위한 문자열
Return
typedescription
ObjectstatusStr과 상태가 일치하는 행의 번호의 배열
Sample
var returnArr = ldt_LinkedDataList1.getRowIndexByStatus('CUD'); // returnArr 는 LinkedDataList에서 삽입, 갱신, 삭제 상태인 행들의 인덱스 배열
getRowJSON( filteredRowIndex )
filteredRowIndex에 해당하는 행의 데이터를 JSON 객체로 반환함
Parameter
nametyperequireddescription
filteredRowIndexNumberY데이터를 가져올 행 번호
Return
typedescription
JSON해당 행의 JSON 객체 데이터
Sample
//아이디가 a, b, c, d, e인 5개 컬럼이 존재하는 LinkedDataList에서 a컬럼의 데이터형식이 date이고 b컬럼의 데이터형식이 number이며 각각의 displayFormat이 yyyy.MM.dd, #,###인 경우 //첫번째 행의 각 컬럼의 데이터는 다음과 같다. ( 20120101 , 23456 , Inswave , WebSquare , sample ) var returnJSONStr = JSON.stringify(ldt_LinkedDataList1.getRowJSON(0)); baseNode : gridData , repeatNode : vector , valueNode : value 일 경우, returnJSONStr은 다음과 같음 {"a":"20120101","b":"23456","c":"Inswave","d":"WebSquare","e":"sample","rowStatus":"U"}
getRowStatus( rowIndex )
rowIndex에 해당하는 행의 상태를 반환 (초기상태:"R", 갱신:"U", 삽입:"C", 삭제:"D", 삽입 후 삭제:"V")
Parameter
nametyperequireddescription
rowIndexNumberY상태를 가져올 행 번호
Return
typedescription
String행의 상태를 나타내는 문자 (초기상태:"R", 갱신:"U", 삽입:"C", 삭제:"D", 삽입 후 삭제:"V")
Sample
var returnValue = ldt_LinkedDataList1.getRowStatus(0); // 첫 번째 행의 rowStatus 값(문자)를 반환
getRowStatusValue( rowIndex )
rowIndex에 해당하는 행의 상태를 반환
(초기상태:0, 갱신:1, 삽입:2, 삭제:3, 삽입 후 삭제:4)
Parameter
nametyperequireddescription
rowIndexNumberY상태를 가져올 행 번호
Return
typedescription
Number행의 상태를 나타내는 숫자 (초기상태:0, 갱신:1, 삽입:2, 삭제:3, 삽입 후 삭제:4)
Sample
var returnValue = ldt_LinkedDataList1.getRowStatusValue(0); // 첫 번째 행의 rowStatus 값(숫자)를 반환
getRowXML( filteredRowIndex )
filteredRowIndex에 해당하는 행의 데이터를 XML로 반환
Parameter
nametyperequireddescription
filteredRowIndexNumberY데이터를 가져올 행 번호
Return
typedescription
XML행의 XML 데이터
Sample
// 아이디가 a,b,c,d,e인 5개 컬럼이 존재하는 LinkedDataList에서 a컬럼의 데이터형식이 date이고 b컬럼의 데이터형식이 number이며 각각의 displayFormat이 yyyy.MM.dd, #,###인 경우 // 첫번째 행의 각 컬럼의 데이터는 다음과 같음 ( 20120101 , 23456 , Inswave , WebSquare , sample ) var returnXMLStr = WebSquare.xml.indent(ldt_LinkedDataList1.getRowXML(0)); baseNode : gridData , repeatNode : vector , valueNode : value 일 경우, returnXMLStr은 다음과 같음 <vector status="0" statusValue="R" id="0"> <a value = "20120101"/> <b value = "23456"/> <c value = "Inswave"/> <d value = "WebSquare"/> <e value = "sample"/> </vector>
getScope( )
scope 속성이 true인 WFrame의 자식 컴포넌트에서 해당 부모 WFrame 객체를 반환하는 함수 scope=true인 WFrame의 자식 컴포넌트가 아닐 경우 null을 반환
Return
typedescription
ObjectWFrame 객체 또는 null
Sample
// 메인 화면에 wframe1이 있고 wframe1안에 wframe11이 있고 그 안에 linkedDataList1이 있는 경우 ldt_LinkedDataList1.getScope(); // wframe11 객체를 반환
getScopeWindow( )
컴포넌트가 scope=true인 WFrame의 자식 컴포넌트일 때 해당 부모 WFrame의 Scope객체를 반환하는 함수 scope=true인 WFrame의 자식 컴포넌트가 아닐 경우 전역 Window객체를 반환
Return
typedescription
ObjectWFrame객체의 Scope객체 또는 전역 Window객체
Sample
// 메인페이지에 wframe1이 있고 wframe1안에 wframe11이 있고 그 안에 LinkedDataList1이 있는 경우 var scope = ldt_LinkedDataList1.getScopeWindow(); scope.wframe11 === ldt_LinkedDataList1.getScope(); // true
getSortCondition( )
LinkedDataList의 sortCondition을 반환하는 함수 관련 함수 : setCondition
Return
typedescription
StringsortCondtion 반환
Sample
// sortCondition설정 ldt_LinkedDataList1.setCondition("sort", "DESC('EMP_CD')") // sortCondition 조회 ldt_LinkedDataList1.getSortCondition(); // return : "DESC('EMP_CD')"
getTotalCol( )
컬럼의 개수를 반환
Return
typedescription
Number컬럼의 개수
getTotalRow( )
행의 개수를 반환
Return
typedescription
Number행의 개수
getUnmatchedColumnData( matchCol , dataValue , targetCol , exactMatch , stRowIndex , lastRowIndex )
검사를 시작할 행의 인덱스부터 끝낼 행의 인덱스 까지의 행 중에서 지정한 컬럼의 값이 지정한 값과 다른 행들을 찾아서 targetCol에 해당하는 열의 값들을 배열로 반환
Parameter
nametyperequireddescription
matchColString||NumberY데이터를 검사할 열 번호 혹은 컬럼 아이디
dataValueStringY열의 인덱스에 해당하는 열의 값과 비교할 데이터
targetColNumberY데이터를 가져올 열번호
exactMatchBooleanY정확히 일치하는지 여부
stRowIndexNumberY데이터를 가져오는 것을 시작할 행 번호
lastRowIndexNumberY데이터를 가져오는 것을 끝낼 행 번호
Return
typedescription
ObjecttargetCol에 해당하는 열의 값을 가지고 있는 배열 (1차원 배열)
Sample
var lastRowIndex = ldt_LinkedDataList1.getRowCount(); var returnArr = ldt_LinkedDataList1.getUnmatchedColumnData( 'c', '영화', 'd', true, 0, lastRowIndex); // returnArr는 c컬럼의 값이 '영화'가 아닌 컬럼의 행 index에 해당하는 d컬럼의 데이터 배열
getUnmatchedData( colID , dataValue , exactMatch , stRowIndex , lastRowIndex )
검사를 시작할 행의 인덱스부터 끝낼 행의 인덱스 까지의 행 중에서 지정한 컬럼의 값이 지정한 값과 다른 행들의 데이터를 배열로 변환하여 배열에 담아 반환
Parameter
nametyperequireddescription
colIDString||NumberY데이터를 검사할 컬럼의 인덱스 또는 아이디
dataValueStringY비교 데이터
exactMatchBooleanY[default:true, false] 정확히 일치하는지 여부
stRowIndexNumberY데이터를 가져오는 것을 시작할 행 번호
lastRowIndexNumberY데이터를 가져오는 것을 끝낼 행 번호
Return
typedescription
Array범위 안에 데이터가 dataValue와 일치하지 않는 배열 데이터를 가진 배열(2차원 배열)
Sample
//name과 birthday컬럼이 정의 된 DataList의 경우 //행의 인덱스가 0부터 10까지의 데이터 중에서 birthday의 값 중에 "198" 문자열이 없는 행의 데이터를 배열로 변환하여 배열에 담아 반환 var rsData = ldt_LinkedDataList1.getUnmatchedData("birthday","198",false,0,10) //반환 값 예시 ) [["아이유","19930516"],["정형돈","19780207"],["유승호","19930817"],["김현아","19920606"]]
getUnmatchedIndex( colID , dataValue , exactMatch , stRowIndex , lastRowIndex )
검사를 시작할 행의 인덱스부터 끝낼 행의 인덱스 까지의 행 중에서 지정한 컬럼의 값이 지정한 값과 다른 행들의 인덱스를 배열로 반환
Parameter
nametyperequireddescription
colIDString||NumberY데이터를 검사할 컬럼의 인덱스 또는 아이디
dataValueStringYcolID에 해당하는 컬럼의 값과 비교할 값
exactMatchBooleanY정확히 일치하는지 여부
stRowIndexNumberY검사를 시작할 행의 인덱스
lastRowIndexNumberY검사를 끝낼 행의 인덱스
Return
typedescription
Object범위 안의 인덱스를 가지고 있는 배열
Sample
var lastRowIndex = ldt_LinkedDataList1.getRowCount(); var returnArr = ldt_LinkedDataList1.getUnmatchedIndex( 'c', '영화', false, 0, lastRowIndex ); // returnArr는 linkedDataList 전체에서 'c 컬럼의 값이 "영화"를 포함하고 있지 않는 행 인덱스의 배열
getUnmatchedJSON( colID , dataValue , exactMatch , stRowIndex , lastRowIndex )
검사를 시작할 행의 인덱스부터 끝낼 행의 인덱스 까지의 행 중에서 지정한 컬럼의 값이 지정한 값과 다른 행들의 데이터를 JSON 객체로 반환
Parameter
nametyperequireddescription
colIDString||NumberY데이터를 검사할 컬럼의 인덱스 또는 아이디
dataValueStringYcolID에 해당하는 컬럼의 값과 비교할 값
exactMatchBooleanY정확히 일치하는지 여부
stRowIndexNumberY검사를 시작할 행의 인덱스
lastRowIndexNumberY검사를 끝낼 행의 인덱스
Return
typedescription
Object범위 안의 데이터를 가지고 있는 JSON객체
Sample
var lastRowIndex = ldt_LinkedDataList1.getRowCount(); var returnJSONStr = JSON.stringify(ldt_LinkedDataList1.getUnmatchedJSON( 'c', '영화', true, 0, lastRowIndex )); // returnJSONStr 은 linkedDataList 전체에서 'c' 컬럼의 값이 "영화"가 아닌 행의 데이터 JSON객체 문자열
getUnmatchedXML( colID , dataValue , exactMatch , stRowIndex , lastRowIndex )
검사를 시작할 행의 인덱스부터 끝낼 행의 인덱스 까지의 행 중에서 지정한 컬럼의 값이 지정한 값과 다른 행들의 데이터를 XML로 반환
Parameter
nametyperequireddescription
colIDString||NumberY데이터를 검사할 열번호 혹은 컬럼 아이디
dataValueStringYcolID해당하는 열의 값과 비교할 데이터
exactMatchBooleanY[default:true, false] 정확히 일치하는지 여부
stRowIndexNumberY검사를 시작할 행의 인덱스
lastRowIndexNumberY검사를 끝낼 행의 인덱스
Return
typedescription
XML범위안에 일치하는 인덱스를 가지고 있는 XML
Sample
var lastRowIndex = ldt_LinkedDataList1.getRowCount(); var returnXMLStr = WebSquare.xml.indent(ldt_LinkedDataList1.getUnmatchedXML( 'c', '영화', true, 0, lastRowIndex )); // returnXMLStr은 LinkedDataList 전체에서 c컬럼의 값이 "영화" 가 아닌 행의 데이터 XML 문자열
getUpdatedData( )
갱신 상태인 행들의 데이터를 배열로 반환
Return
typedescription
Array갱신 상태인 행들의 데이터 배열 (2차원 배열)
Sample
var returnArr = ldt_LinkedDataList1.getUpdatedData();
getUpdatedIndex( )
갱신 상태인 행의 번호를 배열로 반환
Return
typedescription
Object갱신 상태인 행의 번호의 배열
Sample
var returnArr = ldt_LinkedDataList1.getUpdatedIndex(); // returnArr는 갱신 상태(1, U)의 행들의 배열
getUpdatedJSON( )
갱신 상태인 행들의 데이터를 JSON 객체로 반환
Return
typedescription
JSON갱신 상태인 행들의 JSON 객체 데이터
Sample
var data = ldt_LinkedDataList1.getUpdatedJSON(); //반환 값 예시 [ {"EMP_CD": "100002", "EMP_NM": "김영희", "rowStatus": "U" }, {"EMP_CD": "100003", "EMP_NM": "윤정희","rowStatus": "U" } ]
getUpdatedXML( )
갱신 상태인 행들의 데이터를 XML로 반환
Return
typedescription
XML갱신 상태인 행들의 데이터 XML
Sample
var returnXMLStr = WebSquare.xml.indent(ldt_LinkedDataList1.getUpdatedXML()); // returnXMLStr 은 갱신 상태(1, U)의 행들의 데이터 XML 문자열
multisort( options )
options에 따라서 여러 개의 열을 동시에 정렬
Parameter
nametyperequireddescription
optionsObjectY정렬에 대한 옵션을 JSON형식으로 가지고 있는 object
<String:Y> options.sortIndex : 정렬할 열의 아이디 혹은 번호, 여러 열을 나열 시에 빈칸(space)을 구분자로 사용 <String:Y> options.sortOrder : 정렬 방법 (1: 오름차순 -1: 내림차순). 여러 열에 대한 각각의 정렬 방법을 나열 시에 빈칸(space)을 구분자로 사용
Sample
var options = {}; options.sortIndex = "category member"; options.sortOrder = "1 1"; ldt_LinkedDataList1.multisort( options ); category 컬럼의 카테고리를 먼저 오름차순으로 정렬 한 후, 동일 분류에 대하여 member컬럼의 회원 수를 오름차순으로 정렬 multisort의 경우, 데이터 형식을 고려한 정렬이 가능
removeColumnFilter( colID )
colID에 해당하는 열에 적용된 필터를 삭제
여러 컬럼에 setColumnFilter를 사용한 경우, 해제되지 않는 filter의 operationType에 유의하며 사용
Parameter
nametyperequireddescription
colIDNumberY필터를 삭제할 열 번호 혹은 컬럼 아이디
Sample
ldt_linkedDataList1.removeColumnFilter( 'c' ); // c컬럼에 적용된 필터링을 해제
removeColumnFilterAll( )
모든 열에 적용된 필터를 삭제
Sample
ldt_LinkedDataList1.removeColumnFilterAll(); // 전체 필터링을 해제
setColumnFilter( options )
options.colIndex에 해당하는 열에 필터 적용
Parameter
nametyperequireddescription
optionsObjectY필터를 적용할 옵션
<String:Y> options.type [row, func, regExp] 필터 타입 ("row": 데이터를 기준으로 indexOf로 검색. "regExp": 정규표현식. "func": 사용자 정의 함수) <String:Y> options.colIndex 적용할 컬럼 인덱스 또는 아이디 <String:Y> options.key 필터 적용 키 <String:Y> options.condition 이전 필터 데이터와 머지 조건(AND 혹은 OR) <Boolean:N> options.exactMatch [default:false]행의 필터에 like검색이 아닌 equal검색을 시킬지 여부 <Object:Y> options.param 사용자 매개변수(type을 func로 호출 시 파라미터로 전달)
Sample
예제1) row 필터 //key로 넘어온 문자열에 대해 indexOf를 이용하여 필터링 하는 필터 //아이디가 a,b,c,d,e인 5개 컬럼이 존재하는 linkedDataList //a컬럼이 "영화"문자가 포함된 행들만 필터링 되어 보임 ldt_LinkedDataList1.setColumnFilter( {type:'row', colIndex:'a', key:"영화", condition:'and'}); 예제2) func 필터 //cellData를 필터링 하여 true/false를 리턴하는 function을 사용자가 구현하여 처리하는 필터 //아이디가 a,b,c,d,e인 5개 컬럼이 존재하는 linkedDataList //a컬럼이 "영화"문자가 포함된 행들만 필터링 되어 보임 ldt_LinkedDataList1.setColumnFilter( {type:'func', colIndex:'a', key:function(cellData, param) { if(cellData.indexOf("영화") > -1) { return true; }else{ return false} }, condition:'and',param:{}}); 예제3) regExp 필터 //정규표현식을 이용하여 필터링하는 필터 //아이디가 a,b,c,d,e인 5개 컬럼이 존재하는 linkedDataList //a컬럼이 20120101 또는 20120102 또는 20120103을 포함하는 문자열으로 필터링하고 사용자 정규표현식을 key로 넘겨서 처리할 수 있으며, key는 String이 아닌 regExp로 셋팅 하여야 함 ldt_LinkedDataList1.setColumnFilter( {type:'regExp', colIndex:'a', key:/20120101|20120102|20120103/gi, condition:'and'});
setCondition( type , condition )
필터 조건 또는 정렬 조건을 설정
Parameter
nametyperequireddescription
typeStringY동작 종류 선택 - 필터("filter") 혹은 정렬("sort")
conditionStringY필터 조건 혹은 정렬 조건 (하단 샘플 참조)
Sample
// 필터 예제 linkedDataList1.setCondition("filter","filterCondition"); // 필터 조건 설정 예 (1) // val(컴포넌트 아이디) - val()에 정의된 컴포넌트의 현재 값을 참조 // (예) filterCondition = "column01 == val( 'selectbox1' )" // // 필터 조건 설정 예 (2) // ref(data:데이터컬렉션 객체 아이디.컬럼 아이디) - ref()에 정의된 데이터컬렉션 객체의 현재 값을 참조 // (예) filterCondition = "column01 == ref( data:dataList1.col1)" // // 필터 조건 설정 예 (3) // 기본 값 : 컬럼 아이디의 값이 지정한 값과 동일한 데이터만 참조 // (예) filtierCondition = "GENDER == 'W'" // 정렬 예제 linkedDataList1.setCondition("sort","sortCondition"); // 오름차순 정렬 // ASC( 컬럼명 ) - 해당 컬럼을 기준으로 오름차순 정렬 // (예) sortCondition = ASC('col0') // 내림차순 정렬 // DESC( 컬럼명 ) - 해당 컬럼을 기준으로 내림차순 정렬 // (예) sortCondition = DESC('col1, col2')
setOption( key , value )
LinkedDataList 객체의 옵션을 설정하는 API
Parameter
nametyperequireddescription
keyStringY조회하는 옵션 이름
valueStringY조회한 옵션에 설정할 값
Sample
var key = "id"; var value = "ldt_LinkedDataList1"; ldt_LinkedDataList1.setOption(key, value);
sort( bodyColumnID , sortType )
LinkedDataList의 bodyColumnID에 해당하는 열을 정렬해줌
Parameter
nametyperequireddescription
bodyColumnIDStringY정렬시킬 열의 아이디
sortTypeNumberY정렬 옵션 0이면 오름차순 1이면 내림차순 2이면 정렬을 취소
Sample
ldt_LinkedDataList1.sort('date', 0); // Date 컬럼의 값을 기준으로 오름차순으로 정렬 정렬 함수를 사용 시, 데이터 형식에 상관없이 Text로 간주하여 정렬이 됨 number 타입의 컬럼을 정렬해야 하는 경우에는 다중 정렬 사용을 권장함