로컬 문자 세트는 클라이언트 운영 체제의 명령행 쉘에서 입력하거나 표시할 수 있는 문자 세트입니다. UNIX 시스템에서 로컬 문자 세트는 LANG 환경 변수에 의해 제어됩니다. Windows에서는 지역 및 언어 옵션의 설정으로 제어됩니다. 자세한 정보는 Rational ClearQuest 관리 온라인 도움말을 참조하십시오.
Oracle의 벤더 데이터베이스 문자 세트를 문자 세트 또는 charset이라고 부르며, IBM DB2의 경우 코드 페이지 또는 코드 세트, SQL 서버의 경우 코드 페이지 또는 배열(collation)이라고 합니다.
7.0 이전의 버전에서, 로컬 문자 세트가 Rational ClearQuest 데이터 코드 페이지와 일치하지 않은 경우 쓰기 오퍼레이션이 허용되지 않았습니다. 설정이 일치하지 않은 경우 읽기 전용 오퍼레이션만 허용되었습니다. 이들 Rational ClearQuest 애플리케이션이 데이터베이스 세트에 대한 Rational ClearQuest 데이터 코드 페이지 대신 클라이언트 또는 웹 서버의 로컬 문자 세트를 사용하여 데이터베이스에 데이터를 기록하기 때문에 읽기 전용 모드가 필요했습니다.
버전 7.0에서부터 Rational ClearQuest 소프트웨어는 Unicode로 된 데이터를 처리하고, 해당 애플리케이션은 Rational ClearQuest 데이터 코드 페이지를 사용하여 데이터베이스를 기록합니다. 애플리케이션은 이제 로컬 문자 세트가 Rational ClearQuest 데이터 코드 페이지와 일치하지 않는 경우에도 읽기/쓰기 모드로 Rational ClearQuest 데이터베이스에 연결할 수 있습니다.
새로운 기능은 다른 로컬 문자 세트의 시스템을 포함하는 Rational ClearQuest 환경에서 큰 유연성을 발휘합니다. 그러나 이러한 환경에 맞게 작성된 스크립트와 후크가 로컬 문자 세트에 포함될 수 없는 Rational ClearQuest 문자 데이터를 처리해야 합니다. 해당 스크립트 및 후크는 이러한 환경에서 이 기능을 완전히 활용하기 위해 유니코드를 지원하도록 코드화되어야 합니다.
디자이너는 유니코드 인식이라는 새 설정을 포함합니다. 버전 7.0을 위해 작성된 후크는 Rational ClearQuest API 호출에서 리턴되는 문자열의 문자가 로컬 문자 세트에만 있어야 하는지(RETURN_STRING_LOCAL) 또는 임의의 유니코드 문자일 수 있는지(RETURN_STRING_UNICODE) 여부를 지정할 수 있습니다. 또한 새 API 기능을 사용하여 리턴 문자열 모드를 제어할 수 있습니다. RETURN_STRING_LOCAL 모드에서 API 호출은 리턴 문자열이 로컬 문자 세트에서 표시될 수 없는 문자를 포함하는 경우 예외를 리턴합니다. RETURN_STRING_UNICODE에서 API 호출은 오류 없이 모든 문자를 리턴합니다.
후크 및 스크립트가 혼합 문자 세트 배치에서 가능한 모든 데이터를 처리하도록 하려면 모드를 RETURN_STRING_UNICODE로 설정하고 리턴될 수 있는 유니코드 문자를 제대로 처리해야 합니다. 리턴 문자열 모드를 RETURN_STRING_UNICODE로 설정하는 것은 충분하지 않습니다. 사용자 코드가 유니코드 문자를 올바르게 처리할 수 있는지 확인해야 합니다. 아래 나열되는 가이드라인이 도움이 되지만, 궁극적으로는 스크립팅 언어를 위한 적절한 유니코드 프로그래밍 기법을 사용해야 합니다.
버전 7.0으로 업그레이드하려는 경우 이전 버전에서 공통적이었던 것처럼 배치의 모든 로컬 문자 세트가 Rational ClearQuest 날짜 코드 페이지와 일치하는 경우 기존 스키마에 아무 영향이 없습니다. 기본 모드는 후크 및 스크립트가 해당 기능을 계속 사용할 수 있도록 하는 RETURN_STRING_LOCAL입니다.
로컬 문자 세트가 Rational ClearQuest 데이터 코드 페이지와 일치하지 않는 환경에 버전 7.0을 배치하려는 경우 사용자 스크립트가 Rational ClearQuest 소프트웨어를 위한 유니코드 문자 데이터를 처리하고, 스크립트에 대한 리턴 모드를 RETURN_STRING_UNICODE로 설정하고, 패키지를 버전 7.0으로 업그레이드할 수 있어야 합니다. 유니코드를 지원하는 Rational ClearQuest 패키지 목록에 대해서는 표 1을 참조하십시오. 유니코드를 처리하지 않는 스크립트가 실행되지만, 시스템이 로컬 문자 세트에 포함되지 않는 문자 데이터를 스크립트로 리턴하려 시도하는 경우 오류가 리턴됩니다. 이러한 스크립트는 처리하는 데이터가 클라이언트 또는 웹 서버의 로컬 문자 세트로 제한되는 동안은 계속 작업합니다.
패키지 | 리턴 문자열 모드 |
---|---|
AMWorkActivitySchedule | RETURN_STRING_UNICODE |
ATStateTypes | RETURN_STRING_UNICODE |
Attachments | RETURN_STRING_UNICODE |
AuditTrail | RETURN_STRING_UNICODE |
BTStateTypes | RETURN_STRING_UNICODE |
BuildTracking | RETURN_STRING_UNICODE |
CQTM | RETURN_STRING_UNICODE |
Customer | RETURN_STRING_UNICODE |
DeploymentTracking | RETURN_STRING_UNICODE |
DTStateTypes | RETURN_STRING_UNICODE |
RETURN_STRING_UNICODE | |
EnhancementRequest | RETURN_STRING_UNICODE |
eSignature | RETURN_STRING_UNICODE |
History | RETURN_STRING_UNICODE |
Notes | RETURN_STRING_UNICODE |
Project | RETURN_STRING_UNICODE |
Resolution | RETURN_STRING_UNICODE |
TPM | RETURN_STRING_UNICODE |
Rational ClearQuest 소프트웨어는 모든 데이터를 유니코드 문자로 처리합니다. 그러나 스키마 후크(Perl 및 Visual Basic) 및 기타 Rational ClearQuest API 애플리케이션 또는 통합은 유니코드 문자를 처리하도록 코드화될 수 없습니다. 버전 7.0에서 리턴 문자열 모드가 이 문제점을 처리할 수 있습니다. 스크립트가 RETURN_STRING_UNICODE 리턴 문자열 모드에서 실행됨을 표시하기 위해 디자이너 스크립트 편집기에서 후크 코드를 유니코드 인식으로 설정할 수 있습니다. (그렇게 하려면 유니코드 인식 선택란을 선택하십시오). 스크립트는 SetPerlReturnStringMode 또는 SetBasicReturnStringMode 메소드를 호출하여 리턴 문자열 모드를 RETURN_STRING_UNICODE로 설정할 수 있습니다.
리턴 문자열 모드는 문자열이 Perl 또는 COM의 경우 Rational ClearQuest API에 의해 리턴될 때 전체 문자 표시를 제한(RETURN_STRING_LOCAL)하거나 허용(RETURN_STRING_UNICODE)합니다.
유니코드 문자를 처리할 수 있는 후크 및 스크립트를 작성하는 것이 좋습니다. Rational ClearQuest 소프트웨어의 이전 버전을 위한 기존 후크 및 스크립트가 변경 없이 실행할 수 있도록 RETURN_STRING_LOCAL이 기본 리턴 문자열 모드로서 제공됩니다. 시간이 지남에 따라 현재로서는 유니코드에 대한 필요가 없는 경우에도 RETURN_STRING_UNICODE 모드에서 기능하도록 기존 후크 및 스크립트를 수정해야 합니다.
기본적으로 Rational ClearQuest API 스크립트가 로컬 문자 세트 외의 문자를 포함하는 문자열과 함께 리턴될 때 2단계에서 예외가 발생합니다. 이 예외는 데이터 손상을 방지합니다. 코드가 유니코드 문자를 처리할 수 있음을 검토하고 확인한 후, Rational ClearQuest API를 사용하여 또는 디자이너의 스크립트 편집기에서 RETURN_STRING_UNICODE 리턴 문자열 모드를 설정할 수 있습니다. 이렇게 변경하면 2단계에서 Rational ClearQuest API for Perl은 문자열에 로컬이 아닌 문자 세트 데이터를 포함하는 경우 필드 값 문자열을 UTF8(UNICODE)로서 리턴하며, Rational ClearQuest API for VBScript, Visual Basic 또는 COM은 제한되지 않는 유니코드 문자를 리턴합니다. 그러면 로컬 문자 세트로 표시할 수 없는 문자가 유니코드 문자로서 처리하기 위해 후크 또는 스크립트로 리턴될 수 있습니다.
RETURN_STRING_LOCAL 모드에서 조회 실행과 같은 오퍼레이션이 수행될 수 있으며 조회 결과 세트가 유니코드 문자를 포함할 수 있습니다. 데이터가 Rational ClearQuest API 메소드에 의한 결과 세트에서 추출되고 API 호출에서 리턴되는 문자가 로컬 문자 세트에 있지 않은 경우에만 예외가 생성됩니다. 예를 들어, 통합으로 다시 전달되는 데이터가 로컬 문자 세트 문자만 포함하는 경우 통합 또는 외부 애플리케이션이 변경 요청에 동작할 수 있습니다. 통합 코드는 리턴되는 문자가 로컬 문자 세트에 있지 않을 때 Rational ClearQuest API 메소드에 의해 생성되는 예외를 처리해야 합니다. 통합 API가 RETURN_STRING_UNICODE로서 구성되는 경우 예외가 생성되지 않지만 애플리케이션이 라턴되는 모든 유니코드 문자를 올바르게 처리해야 합니다. RETURN_STRING_LOCAL 및 RETURN_STRING_UNICODE 모드 둘 다에서, 애플리케이션이 Rational ClearQuest 데이터 코드 페이지에서 표시될 수 없는 문자를 기록하는 경우에도 예외가 호출 통합 또는 애플리케이션으로 리턴됩니다.
자세한 정보는 IBM Rational ClearQuest API 참조서에서 후크 및 스크립트에 대한 리턴 문자열 모드 설정을 참조하십시오.
일부 패키지 또는 스키마는 유니코드 및 로컬이 아닌 문자 세트 데이터를 처리하도록 설계되지 않습니다. 각 패키지의 각 스크립트가 제공하는 지원이 디자이너 스크립트 편집기에 표시됩니다(유니코드 인식 선택란이 선택되어 있습니다). DefectTracking 및 Common 스키마가 유니코드를 지원합니다. 그러나 유니코드 문자를 지원하지 않는 패키지를 포함하는 모든 스키마는 혼합 문자 세트 배치에서 사용될 수 없습니다. 표 1을 참조하십시오.
패키지 필드를 액세스하는 후크를 편집 또는 추가할 수 있으며, 이들 후크는 패키지의 파트로서 간주됩니다. 이러한 후크는 패키지에서 기본 유니코드 지원을 상속하지만 디자이너가 후크에 대한 이 올바른 설정을 표시하지 않습니다.
데이터베이스 세트 또는 클랜에 연결된 모든 클라이언트의 로컬 문자 세트가 데이터 코드 페이지와 일치하는 경우 이러한 문제를 고려할 필요가 없습니다. 문자 표시 및 코드 페이지 설정에 관한 자세한 정보는 Rational ClearQuest 관리 온라인 도움말을 참조하십시오.