cpheader

내보낸 작업공간 항목(조회, 차트, 보고서, 보고서 형식) 및 원래 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 형식으로 변환하여 데이터 코드 페이지 헤더 정보를 자동으로 처리할 수 있습니다.

    대체 솔루션:

    1. 작업공간 항목 및 원래 Designer 양식 파일을 내보내려는 원본 ClearQuest 데이터베이스의 데이터 코드 페이지를 판별합니다.
    2. ClearQuest 7.1.1 이전 버전 클라이언트 또는 bkt_tool 명령을 사용하여 ClearQuest 7.1.1 이전 버전 데이터베이스에서 작업공간 항목을 내보냅니다.
    3. 7.1.1 이전 버전의 원래 Designer를 사용하여 ClearQuest 7.1.1 이전 버전 데이터베이스에서 양식 파일을 내보냅니다.
    4. ClearQuest 7.1.1에서 소개된 cpheader 명령을 사용하여 방금 2 - 3단계에서 내보낸 파일로 UTF-8(65001) 코드 페이지 헤더를 추가합니다.
    5. 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 데이터베이스로 이동하는 것입니다.

    예제 솔루션:

    1. 몇몇 작업공간 항목만 내보내려면 ClearQuest 7.0 클라이언트를 사용합니다. 작업공간 항목을 모두 내보내려면 bkt_tool 명령을 사용합니다. 원래 Designer 양식 파일을 내보내려면 원래 Designer를 사용합니다.
    2. 932 코드 페이지 헤더를 내보낸 파일에 모두 추가하려면 cpheader 명령을 사용합니다.
    3. 932 코드 페이지 헤더를 사용하여 내보낸 파일을 ClearQuest 7.1.1을 실행하는 컴퓨터에 복사합니다.
    4. ClearQuest 7.1.1 클라이언트 또는 bkt_tool 명령을 사용하여 ClearQuest 7.1.1 UTF-8 데이터베이스로 작업공간 항목을 가져옵니다. 원래 Designer를 사용하여 양식 파일을 가져옵니다.

  • 유스 케이스 2: 버전7.1.1 클라이언트를 사용하여 파일을 내보내고, 7.1.1 이전 버전 클라이언트 및 원래 Designer에서 파일을 가져오는 방식으로 ClearQuest 7.1.1 이전 버전 데이터베이스에서 다른 데이터베이스로 작업공간 항목 및 원래 Designer 양식 파일을 마이그레이션합니다

    솔루션:

    가져올 데이터베이스와 내보낼 데이터베이스의 코드 페이지가 동일한지 확인해야 합니다.

    1. 버전 7.1.1 클라이언트를 사용하여 작업공간 항목 및 양식 파일을 내보냅니다.
    2. cpheader 명령을 사용하여 내보낸 파일에서 코드 페이지 헤더를 제거합니다.
      주의: 이 단계를 수행하지 않으면 데이터가 손상될 수 있습니다.
    3. 7.1.1 이전 버전 클라이언트 또는 bkt_tool 명령을 사용하여 두 번째 데이터베이스로 작업공간 항목을 가져옵니다. 원래 Designer를 사용하여 두 번째 데이터베이스로 양식 파일을 가져옵니다.

예제

  • Western European 데이터 코드 페이지 1252의 헤더를 c:/all_defects.qry 파일에 추가합니다.
    cqperl cpheader.pl -a c:/all_defects.qry 1252
  • Simplified Chinese 데이터 코드 페이지 936의 헤더를 c:/queries 디렉토리 및 해당 서브디렉토리의 모든 파일에 추가합니다.
    cqperl cpheader.pl -a c:/queries 936
  • Simplified Chinese 데이터 코드 페이지 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

참조

bkt_tool


피드백