clonenew

데이터셋 간의 데이터를 복사한다.

strDstXDataSetId에 해당하는 데이터셋이 존재하는 경우, 기존에 존재하는 칼럼은 모두 삭제되고, 함수가 호출된 데이터셋의 모든 칼럼이 복사된다.

strDstXDataSetId에 해당하는 데이터셋이 존재하지 않는 경우, 새로운 데이터 셋을 생성하고, 함수가 호출된 데이터셋의 모든 칼럼이 복사된다.

bIncludeOPCode 파라미터는 데이터셋의 각레코드별 Operation Code('I', 'U')를 포함하여 복사 할지 여부이다.

strFilterOption 파라미터는 필터링 기준을 지정하며, 빈 문자열("")일 경우 모두복사한다. 필터링 문자열 규약과 필터 조건 규약은 아래와 같다.

* 필터링 문자열 규약

"컬럼ID":필터조건:"필터텍스트":AND조건, ...(반복)
예시) "COLUMN_01":=:"123":&,"COLUMN_03":<>:"abc":&
설명) COLUMN_01컬럼의 데이터가 123 이고, COLUMN_03컬럼의 데이터가 abc가 아닌 조건

필터 조건 규약, 필터 텍스트 규약은 아래의 "Remark"를 참조한다.

Parameters	Type	Description
strDstXDataSetId	INSTANCE	복재 대상 데이터셋 ID
strFilterOption	STRING	필터링 조건(설명참조)
bIncludeOPCode	BOOL	xDataset Operation Code 도 함께 복사 할지여부
bFireEvent	BOOL	[옵션] 데이터셋 이벤트 발생 여부(true/false) (기본값: true)

Type	Description
INSTANCE	복재된 데이터 셋 인스턴스

* 필터 조건 규약

한 컬럼의 필터 스크립트의 구분자 : ":"
각 컬럼의 필터 스크립트 구분자 : ","
컬럼 아이디
- 좌우에 쌍따옴표로 묶음
필터 조건 : =,<>,>,>=,<,<= 중 하나
AND/OR 조건 : &,| 중 하나
필터 텍스트
- 좌우에 쌍따옴표로 묶음
- 스크립트 소스에서는 역슬래시 문자를 이용해서 Escape 처리를 해야함
- 자세한 내용은 아래의 "필터 텍스트 규약" 참조

* 필터 텍스트 규약

* : 여러 문자열을 매칭
? : 한 문자를 매칭

* 필터 텍스트 예시

ABC : 데이터가 "ABC"인 문자열
*A : A로 끝나는 문자열
A* : A로 시작되는 문자열
?A : A로 끝나고, 길이가 2인 문자열
?A* : 길이가 2 이상이고, 두번째 문자가 A인 문자열

bFireEvent는 데이터셋에 바인딩된 컴퍼넌트들에게 데이터셋 변경 이벤트를 발생시켜, 변경된 내용을 컴포넌트가 즉시 반영할지 여부를 결정합니다.

데이터셋이 글로벌 데이터셋인 경우, 새로 생성되는 데이터셋도 글로벌 데이터셋이 된다.

function btnXDataSetCopy_on_mouseup(objInst)
{
    var newXDataSetInst = null;

	// Operation code포함하여 xDataSetID_01의 데이터를
    // "DS_TARGET" ID에 해당하는 데이터셋에 복사하여 
    // "DS_TARGET" ID에 해당하는 데이터셋 리턴
	newXDataSetInst = xDataSetID_01.clonenew("DS_TARGET", "", true);
}

XDataSet » Api

clonenew

Description

Parameters

Return Value

Remark

Example

See Also

Viewer Ver.

Update Date