copy

데이터셋 간의 데이터를 복사한다. 복사할 데이터셋 Instance와 칼럼 ID가 같은 칼럼만 복사 대상이 된다.

bIncludeOPCode 파라미터는 데이터셋의 각레코드별 Operation Code('I', 'U')를 포함하여 복사 할지 여부이다. bIncludeOPCode 값을 false로 지정한 경우에, 복사된 데이터셋의 Operation Code는 XFD_ROWOP_NONE 값으로 설정된다.

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

* 필터링 문자열 규약

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

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

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

Type	Description
BOOL	성공/실패 여부

* 필터 조건 규약

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

* 필터 텍스트 규약

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

* 필터 텍스트 예시

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

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

bFireEvent를 false로 지정한 경우, 데이터셋에 바인딩된 컴퍼넌트들에게 데이터셋 변경 이벤트를 발생시키기 위해서는 fireevent API를 호출한다.

function btnXDataSetCopy_on_mouseup(objInst)
{
	var strFilterOpt = "";
	// Column_01 컬럼은 데이터가 1 보다 크고
	strFilterOpt += "\"Column_01\":>:\"1\":&" + ",";

	// Column_03 컬럼은 데이터가 10 보다 큰 데이터를 필터링
	strFilterOpt += "\"Column_03\":>:\"10\"";

	// Operation code포함하여 xDataSetID_01의 데이터를 xDataSetID_02에 복사..
	xDataSetID_02.copy(xDataSetID_01, strFilterOpt, true);
}

XDataSet » Api

copy

Description

Parameters

Return Value

Remark

Example

See Also

Viewer Ver.

Update Date