내보낸 작업공간 항목(조회, 차트, 보고서, 보고서 형식) 및
원래 Rational® ClearQuest® Designer를
사용하여 작성된 양식 파일에서 데이터 코드 페이지 헤더 정보를 제거하거나 추가합니다.
개요
- cqperl cpheader.pl -a [ file-path |
[ directory-path { regular-expression }
] ] code-page
- cqperl cpheader.pl -s [ file-path |
[ directory-path { regular-expression }
] ]
cpheader 명령은 Rational ClearQuest 설치 디렉토리에 있습니다.
설명
7.1.1.0 버전부터 IBM® Rational ClearQuest에서는
내보낸 작업공간 항목 및 원래 ClearQuest Designer를
사용하여 작성된 양식 파일에 헤더 정보를 추가할 수 있습니다. 헤더에는
파일을 내보낸 ClearQuest 데이터베이스의
데이터 코드 페이지에 대한 정보가 있습니다. 헤더를 통해
내보낸 파일을 다른 코드 페이지를 사용할 수 있는 다른 ClearQuest 데이터베이스로
올바르게 가져올 수 있습니다.
7.1.1.0 이전 버전의 ClearQuest에서는
내보낸 작업공간 항목 및 양식 파일에 코드 페이지가 없습니다.
7.1.1.0 이전 및 이후 버전의 ClearQuest 클라이언트를 혼합하여 사용하는 경우
다른 7.1.1.0 이전 및 이후 버전의 ClearQuest 클라이언트를 사용하여
작업공간 항목 및 양식 파일을 내보내거나 가져오려면 cpheader 명령을 사용하여
교차 버전 클라이언트 호환성이 지원되도록 코드 페이지 헤더를 추가하거나
제거하십시오. 이렇게 하면 파일을 내보낸 클라이언트와는 다른 버전의
ClearQuest 클라이언트에서
내보낸 파일이 가져오기에 적합한 형식으로 변환됩니다.
cpheader 명령을 사용하면
원래 ClearQuest Designer를 사용하여 작성된
양식 파일 및 작업공간 항목이 UTF-8(8-bit Unicode Transformation Format) 코드 페이지를
사용하는 ClearQuest 데이터베이스로 마이그레이션됩니다. 이 명령을 사용하면
내보낸 파일의 코드 페이지와 일치하지 않는 ClearQuest
데이터베이스로 작업공간 항목 및 양식 파일을 가져오지 못하게 되므로 데이터 손상을 방지할 수 있습니다.
UTF-8은 모든 코드 페이지의 문자를 지원하므로,
UTF-8 코드 페이지를 지원하는 데이터베이스로 모든 코드 페이지를 가져올 수 있습니다.
주의: ClearQuest Eclipse
Designer는 코드 페이지 정보를 포함하는 XML 형식으로 양식을 내보냅니다.
ClearQuest Eclipse Designer에서 내보낸 양식에 대해 cpheader 명령을
사용하지 마십시오.
옵션 및 인수
- -a
- 지정된 디렉토리 및 해당 서브디렉토리의 지정된 파일로 데이터 코드 페이지 헤더를
추가합니다.
- -s
- 지정된 디렉토리 및 해당 서브디렉토리의 지정된 파일에서 데이터 코드 페이지 헤더를
제거합니다.
- file-path
- 코드 페이지 헤더를 추가하거나 제거할 파일 경로를 지정합니다.
- directory-path { regular-expression }
- 코드 페이지 헤더를 추가하거나 제거할 파일이 포함된 디렉토리 경로를
지정합니다. regular-expression을 지정한 경우
디렉토리 및 해당 서브디렉토리에서 이름이 regular-expression과
일치하는 파일에 대해서만 코드 페이지 헤더가 추가되거나 제거됩니다.
정규식을 지정하지 않으면 디렉토리 및 해당 서브디렉토리의 모든 파일에 대해
코드 페이지 헤더가 추가되거나 제거됩니다.
- code-page
- Rational ClearQuest 데이터 코드 페이지입니다.
유스 케이스
- 유스 케이스 1: ClearQuest
7.1.1 이전 버전 데이터베이스에서 ClearQuest 7.1.1
UTF-8(65001) 데이터베이스로 작업공간 항목 및 원래 Designer
양식 파일을 마이그레이션합니다.
선호하는 솔루션:
ClearQuest
7.1.1 클라이언트를 사용하여 작업공간 항목 및 원래 Designer 양식
파일을 ClearQuest
7.1.1 이전 버전 데이터베이스에서 내보내고 작업공간 항목 및 양식 파일을
UTF-8 데이터베이스에 가져옵니다. 이러한 솔루션으로 ClearQuest는
파일을 다른 코드 페이지에서 UTF-8 형식으로 변환하여 데이터 코드 페이지 헤더 정보를
자동으로 처리합니다.
대체 솔루션:
- 작업공간 항목 및 원래 Designer 양식 파일을 내보내려는
원본 ClearQuest 데이터베이스의 데이터 코드 페이지를 판별합니다.
- ClearQuest
7.1.1 이전 버전 클라이언트 또는 bkt_tool 명령을 사용하여
ClearQuest
7.1.1 이전 버전 데이터베이스에서 작업공간 항목을 내보냅니다.
- 7.1.1 이전 버전의 원래 Designer를 사용하여 ClearQuest
7.1.1 이전 버전 데이터베이스에서 양식 파일을 내보냅니다.
- ClearQuest 7.1.1에서 소개된 cpheader 명령을 사용하여
방금 2 - 3단계에서 내보낸 파일에 UTF-8(65001) 코드 페이지 헤더를 추가합니다.
- ClearQuest 7.1.1 클라이언트를 사용하여 작업공간 항목 및
양식 파일을 UTF-8 데이터베이스로 가져옵니다.
예제:
하나의 컴퓨터에 코드 페이지가 932인
ClearQuest 7.0 데이터베이스가 있습니다. 두 번째 컴퓨터에 ClearQuest 7.1.1을 설치하고
데이터 코드 페이지가 65001 (UTF-8)인 ClearQuest 데이터베이스를
작성합니다. 현재의 목표는 ClearQuest 7.0 데이터베이스를 먼저 업그레이드하지 않고
작업공간 항목 및 양식 파일을 ClearQuest 7.0 데이터베이스에서
ClearQuest 7.1.1 UTF-8 데이터베이스로 이동하는 것입니다.
예제 솔루션:
- 몇몇 작업공간 항목만 내보내려면 ClearQuest 7.0
클라이언트를 사용합니다. 작업공간 항목을 모두 내보내려면 bkt_tool 명령을 사용합니다.
원래 디자이너 양식 파일을 내보내려면 원래 디자이너를 사용합니다.
- 932 코드 페이지 헤더를
내보낸 파일에 모두 추가하려면 cpheader 명령을 사용합니다.
- 932 코드 페이지 헤더를 사용하여 내보낸 파일을
ClearQuest 7.1.1을 실행하는 컴퓨터에 복사합니다.
- ClearQuest 7.1.1 클라이언트 또는
bkt_tool 명령을 사용하여 ClearQuest 7.1.1
UTF-8 데이터베이스로 작업공간 항목을 가져옵니다. 원래 디자이너를 사용하여 양식 파일을 가져옵니다.
- 유스 케이스 2: 버전 7.1.1 클라이언트를 사용하여 작업공간 항목 및 원래 Designer 양식 파일을
하나의 ClearQuest 7.1.1 이전 버전 데이터베이스에서
다른 데이터베이스로 마이그레이션하여 파일을 내보내고 7.1.1 이전 버전 클라이언트 및
원래 Designer를 사용하여 파일을 가져옵니다.
솔루션:
가져올 데이터베이스와 내보낼 데이터베이스의
코드 페이지가 동일한지 확인해야 합니다.
- 버전 7.1.1
클라이언트를 사용하여 작업공간 항목 및 양식 파일을 내보냅니다.
- cpheader 명령을 사용하여 내보낸 파일에서 코드 페이지 헤더를
제거합니다.
주의: 이 단계를 수행하지 않으면
데이터가 손상될 수 있습니다.
- 7.1.1 이전 버전 클라이언트 또는 bkt_tool 명령을 사용하여
두 번째 데이터베이스로 작업공간 항목을 가져옵니다. 원래 디자이너를 사용하여 두 번째
데이터베이스로 양식 파일을 가져옵니다.
예제
- 서유럽어 데이터 코드 페이지 1252의 헤더를
c:/all_defects.qry 파일에 추가합니다.
cqperl cpheader.pl -a c:/all_defects.qry 1252
- 중국어 간체자 데이터 코드 페이지 936의 헤더를
c:/queries 디렉토리 및 해당 서브디렉토리의 모든 파일에 추가합니다.
cqperl cpheader.pl -a c:/queries 936
- 중국어 간체자 데이터 코드 페이지 936의 헤더를
.cfg$ 표현식과 일치하는 c:/queries 디렉토리 및 해당 서브디렉토리의 모든 파일에
추가합니다.
cqperl cpheader.pl -a c:/queries .cfg$ 936
- c:/alldefect.qry 파일에서 코드 페이지 헤더를 제거합니다.
cqperl cpheader.pl -s c:/alldefect.qry
- c:/qrydir 디렉토리 및 해당 서브디렉토리의 모든 파일에서 코드 페이지 헤더를 제거합니다.
cqperl cpheader.pl -s c:/qrydir