< 이전 | 다음 >

ClearQuest CM API 설치 및 설정

ClearQuest® CM API를 사용하기 전에 클래스 경로에 파일을 추가하고 라이센스가 부여된 Rational® ClearQuest 버전을 설치해야 합니다.
API는 Rational 제품에서 오퍼레이션을 수행하기 위한 공통적인 컴포넌트입니다. Rational 제품에서 이 API를 사용하려면 시스템에 제품을 설치해야 합니다. 또한 Rational 제품을 설치할 때 시스템에 설치된 API 파일을 클래스 경로에 복사해야 합니다.
다음 Java 패키지는 API를 사용하여 Rational ClearQuest 오퍼레이션을 수행하는 데 필요합니다.
  • javax.wvcm: WVCM(Workspace Versioning and Configuration Management) 패키지.
  • com.ibm.rational.wvcm.stp: Rational 소프트웨어 팀 패키지는 WVCM 패키지의 확장입니다. 이 패키지는 API의 인터페이스를 포함하며 Rational 제품 자원에 대한 공통 오브젝트 모델을 제공합니다. 이 패키지는 제품 특정 저장소 또는 구현 경계에 관계없습니다.
  • com.ibm.rational.wvcm.stp.cq: ClearQuest 데이터베이스에 대한 액세스를 제공하는 제품 특정 확장기능입니다. 이 패키지에는 ClearQuest 데이터베이스와 해당되는 기본 자원의 기능에 대한 더 완전한(제품 특정) 액세스를 제공하는 기능이 포함되어 있습니다.

이 문서의 코드 예제를 잘라내어 컴파일 가능한 Java로 붙여넣을 수 있어야 하지만 이것은 컴파일되지 않았고 컴파일되지 않게 하는 인쇄상의 오류를 포함할 수 있습니다. 이 예제의 컴파일 가능한 전체 버전은 API 문서와 함께 배포되는 추가 아카이브 파일에 있는 samples라는 Eclipse 프로젝트에서 찾을 수 있습니다.

ClearQuest CM API JAR 파일 및 기타 필수 JAR 파일은 기본적으로 다음 위치에 설치됩니다. 여기서 install-dir은 Rational 제품 파일이 설치된 디렉토리를 나타냅니다. 기본적으로 이 디렉토리는 UNIX® 시스템 및 Linux®의 경우 /opt/rational이고 Windows® 시스템의 경우에는 C:\Program Files\IBM Rational입니다.
  • Windows 시스템
    • <install-dir>/Common/stpwvcm.jar: ClearQuest CM API 인터페이스 JAR 파일.
    • <install-dir>/Common/stpcmmn.jar: 공통적인 구현 JAR 파일.
    • <install-dir>/ClearQuest/stpcq.jar: ClearQuest 제품에 대한 확장.
    • <install-dir>/ClearQuest/cqjni.jar: Rational ClearQuest JAR 파일.
  • UNIX 및 Linux 시스템
    • <install-dir>/common/stpwvcm.jar
    • <install-dir>/common/stpcmmn.jar
    • <install-dir>/clearquest/cqweb/lib/stpcq.jar
    • <install-dir>/clearquest/cqweb/lib/cqjni.jar

API를 사용하기 전에 API JAR 파일 위치를 클래스 경로에 추가해야 합니다.

Eclipse 플러그인에서 ClearQuest CM API에 액세스하려면 다음 단계를 수행하십시오.

  1. %RATIONAL_INSTALL%\common\cm\teamapi.zip 아카이브 파일의 \plugins\com.ibm.rational.stp.cmapi 디렉토리에 있는 파일을 사용하여 Eclipse 플러그인을 작성하십시오.
  2. ClearQuest CM API 플러그인을 런타임 구성에 추가하려면 플러그인을 Eclipse 인스턴스로 복사하거나 새 확장 설치 사이트를 작성하십시오. 그러면 API에 대한 새 디렉토리가 작성됩니다(예: C:\eclipse\plugins\com.ibm.rational.stp.cmapi). 새 플러그인은 ClearQuest CM API JAR 파일 및 Rational ClearQuest JAR 파일로 구성됩니다.
  3. 플러그인 디렉토리를 작성한 후 설치된 위치에서 이 디렉토리로 각각의 설치된 JAR 파일을 복사해야 합니다. ClearQuest JAR 파일에는 ClearQuest CM API JAR 파일이 필요합니다. 다음에 Eclipse를 시작할 때 플러그인을 사용할 수 있습니다.
  4. 플러그인에서 ClearQuest CM API를 사용하려면 com.ibm.rational.stp.cmapi를 종속성으로 식별하십시오.
이제 ClearQuest CM API를 사용하여 Java 프로그램을 작성할 준비가 완료되었습니다.
ClearQuest 자원과 함께 API를 사용하려면 라이센스가 부여된 Rational ClearQuest 버전이 설치되어야 합니다. JAR 파일을 설치하고 구성했지만 해당 제품을 설치하지 않은 경우 Java 패키지에 대한 호출이 실패합니다.

레슨 체크포인트

이제 ClearQuest CM API를 사용한 프로그래밍에 맞게 시스템을 설정했으므로, API 오브젝트 모델 및 프로그래밍 모델에 대한 학습을 시작할 준비가 되었습니다.
이 레슨에서 학습한 내용은 다음과 같습니다.
  • ClearQuest CM API와 Rational ClearQuest 사이의 관계
  • ClearQuest CM API를 사용한 프로그래밍에 맞게 시스템을 설정하는 방법
  • 시스템에 필요한 ClearQuest CM API의 파일
< 이전 | 다음 >

피드백