このセクションでは、ソース管理システムにカスタム統合を作成する方法について説明します。「ソース管理リポジトリとの接続」で説明しているように、Parasoft Test は最も一般的なバージョン管理/ソース管理システムのビルトインサポートを提供します。さらに Parasoft Test はオープンなソース管理 API を提供します。この API を使用すると、他のソース管理ツールを Parasoft Test に統合することができます。

このセクションの内容:

カスタムソース管理実装の追加

API Javadoc (Eclipse のみ)

Web ベースヘルプシステムのソース管理 API のトピックには、実装しなければならないすべてのクラスとインターフェイスについての Javadoc ドキュメントが含まれています。Javadoc は<INSTALL>\plugins\com.parasoft.ptest.sourcecontrol.eclipse.core\javadoc ディレクトリにあります。

主要インターフェイス

すべての必要な実装をつないで作成するインターフェイスは com.parasoft.ptest.sourcecontrol.openapi.IVersionControlFactory です。

このファクトリは、次のインターフェイスのための固有の実装を提供します。

com.parasoft.ptest.sourcecontrol.openapi.IRepositoryDetector
com.parasoft.ptest.sourcecontrol.openapi.IVersionControl
com.parasoft.ptest.sourcecontrol.openapi.IVersionControlHelper

実装とコンパイル

ソース管理 API とそれに関連するすべてのクラスは <INSTALL>\plugins\com.parasoft.ptest.libs_<VERSION>/Parasoft/ ディの sourcecontrol.jar ファイルにあります。

コンパイルするために、以下の jar ファイルをクラスパスにさらに追加しなければならない場合があります。

util.jar
common.jar
preference_api.jar

すべての JAR ファイルは<INSTALL>\plugins\com.parasoft.ptest.libs_<VERSION> ディレクトリにあります。

カスタム統合を実装するには、次の操作を行います。

任意の場所にプロジェクトを作成します。
必要な jar ファイルをプロジェクトのクラスパスに追加します。
カスタムバージョン管理サポートの実装を開始します。IVersionControlFactory の実装から始め、必要なクラスを徐々に追加します。

デプロイメントと検証

実装が完了したら、次の操作を行います。

必要なすべてのクラスを含む 1 個の jar ファイルを作成します。jar ファイルの名前やパッケージの名前などについて特に規則はありません。
jar ファイルを <INSTALL>\plugins\com.parasoft.ptest.sourcecontrol.eclipse.core\ext ディレクトリにコピーし、SOAtestを再起動します。
次の操作を行って実装を検証します。
1. [Parasoft] > [設定] > [ソース管理] を選択し、[DTP設定を使用する] オプションを有効にします。
2. ビルトインのバージョン管理システムに交じって、カスタム実装のオプションがあることを確認します。
3. カスタム実装のオプションを有効にして、[New] をクリックします。
4. 必要なプロパティを追加し、 [適用] をクリックします。
5. [設定] で [スコープと作成者] を選択し、[ソース管理 (変更作成者) を使ってスコープを計算] チェックボックスがオンであることを確認します。
6. カスタム実装のバージョン管理システムによって制御されるファイルを開きます。ファイルのソースコード中の任意の箇所を右クリックします。
7. [行の作成者を表示] を選択します。有効なバージョン管理作成者情報が表示されるはずです。

サンプル実装

SOAtest には、オープンなソース管理 API のサンプル実装が同梱されています。次の場所に、圧縮されたパッケージがあります： <INSTALL>\plugins\com.parasoft.ptest.sourcecontrol.eclipse.core_<VERSION>\openapi\demo\

open_api_demo.zip を展開した後、次のディレクトリ構造を作成します。

open_api_demo/demo.jar - コンパイルされた、Eclipse 用のソース管理デモの実装。
open_api_demo/src/* - Open API デモ実装のソースコード。
open_api_demo/local_repository/* - デモ用の Eclipse サンプルプロジェクト。

このデモは JDK 1.6.0_29 を使ってコンパイルされました。

前述のセクションで説明した手順を使ってデモをコンパイルおよびデプロイすることができます。

デモを実行するには、次の操作を行います。

demo.jar ファイルをデプロイします。
任意の場所に local_repository を展開します。
Parasoft Test 製品を再起動します。
Local Demo Repository プロジェクトをワークスペースにインポートします。
[Parasoft] メニューの [設定] をクリックして [ソース管理] を選択します。デモの実装のチェックボックスをオンにします。
ファイルを開き、ファイルのソースコード中の任意の場所を右クリックして [行の作成者を表示] を選択します。有効なバージョン管理作成者情報が表示されるはずです。

Page tree

カスタム ソース管理システムの統合

カスタム ソース管理実装の追加