このセクションの内容:

はじめに

VersionOne は、要件、欠陥、他の作業アイテムを管理/追跡するための一般的なブラウザーベースのプラットフォームです。Parasoft DTP は VersionOne と統合し、以下の機能を提供します。

違反エクスプローラーから VersionOne で手動で欠陥や課題を作成する機能
テストエクスプローラーから VersionOne で手動で欠陥や課題を作成する機能
VersionOne の作業アイテムで Parasoft のテスト結果を送信、表示、および更新する機能。
- VersionOneのトレーサビリティレポートを使用してトレーサビリティを追跡することを計画しているユーザー向け。これを行うには、最初に Parasoft DTP から VersionOne にテスト結果を送信する必要があります。
テスト、静的解析結果、コードレビューを VersionOne の作業アイテムから追跡する機能 (「Viewing the Traceability Report」を参照)。
- Parasoft DTP のトレーサビリティレポートを使用してトレーサビリティを追跡することを計画しているユーザー向け。これを行うには、@req を使用して、Parasoft の自動テストを VersionOne 要件に関連付けます。

要件

次の Parasoft ツールが実行するテストがサポートされていること:
- C/C++test Professional、dotTEST、Jtest 10.4.3 以降
- Selenic 2020.1 以降
- SOAtest 9.10.8 以降
テストと解析のデータを VersionOne に送信するには、VersionOne で既に作業アイテムを作成しておく必要があります。Parasoftは、次のタイプの作業アイテムにテストを関連付けることができます。
- ストーリー
- テスト

設定

この設定は、Parasoft 管理者が一度だけ行う必要があります。開発者、テスター、およびその他の DTP エンドユーザーは、Parasoft ツールを VersionOne と連携して使用する方法について、「Usage 」を参照してください。

DTP と VersionOne サーバーの接続

設定ドロップダウンメニュー (歯車のアイコン) から [Report Center 設定] を選択します。
[External System] を選択して [設定の編集] をクリックし、[システムタイプ] ドロップダウンメニューから VersionOne を選択します。
[Enabled] オプションを有効化します。
[名前] フィールドに VersionOne のインスタンス名を入力します。名前は必須ですが、接続設定に影響したり、他のインターフェイスで表示されたりすることはありません。
[アプリケーション URL] フィールドに VersionOne の URL を入力します。
[表示 URL] フィールドは、VersionOne システムへのリンクが Web ブラウザーに表示されるときに Parasoft DTP ページに表示される URL を定義します。通常、これは上記のアプリケーション URL フィールドと同じである必要があります。ただし、たとえば、リバースプロキシ環境で作業していて、Parasoft DTP を使用するユーザーのローカル Web ブラウザーから VersionOne へのリンクが Parasoft DTP サーバーとは異なる場合は、違うことがあります。
[Username] および [Password/API Tokens] フィールドにログイン認証情報を入力します。ログインには、[プロジェクトの関連付け] セクションで指定された VersionOne プロジェクトで課題を作成するのに十分な権限が必要です。
[接続のテスト] をクリックして設定を確認し、[確認] をクリックします。

Parasoft プロジェクトと VersionOne プロジェクトの関連付け

Parasoft プロジェクトを VersionOne プロジェクトに関連付けると、違反ビューまたはテストエクスプローラービューから欠陥を作成し、VersionOne の適切なプロジェクトにリンクできます。Sending Test Data to External System フローを使用する場合、関連付けも重要です。DTP の複数のプロジェクトを 1 つの VersionOne プロジェクトと関連付けることはできますが、同じ DTP プロジェクトを複数の VersionOne プロジェクトと関連付けることはできません。

[プロジェクトの関連付けを作成] をクリックし、[DTP プロジェクト] ドロップダウンメニューからプロジェクトを選択します。
[外部プロジェクト] フィールドに VersionOne プロジェクトの名前を入力して [Create] をクリックし、関連付けを保存します。

プロジェクトの関連付けを削除するには、ゴミ箱のアイコンをクリックします。プロジェクトの関連付けを削除しても、リンクは削除されません。新しい関連付けを作成すると、違反と VersionOne の課題との既存リンクが再び有効になります。

DTP と VersionOne プロジェクトの既存の関連付けの設定を変更できます。

鉛筆アイコンをクリックして、ドロップダウンメニューから別の DTP プロジェクトを選択するか、[外部プロジェクト]フィールドに別の VersionOne プロジェクトの名前を指定します。
[保存] をクリックします。

Traceability Report の有効化

VersionOne に保存された作業アイテム、および Parasoft ツール (C/C++test、dotTEST、Jtest、SOAtest) から DTP に送信されたテストデータ、静的解析データ、ビルドレビューデータとの間のトレーサビリティを実証するのに役立つウィジェットとレポートを生成するように、DTP を構成できます。

Traceability Report にコードレビューと静的解析情報を含める場合は、ソースコードファイルを VersionOne の作業アイテムに関連付ける必要があります。この機能を有効化する方法については「ファイルと要件の関連付け」を参照してください。

Traceability Pack に同梱されている External System Traceability Report アーティファクトをデプロイすることで、トレーサビリティを表示および追跡する DTP インターフェイスが有効になります。Traceability Pack には、トレーサビリティワークフローの一部を自動化する Sending Test Data to External System フローも含まれています。Traceability Pack の詳細については、Traceability Pack のドキュメントを参照してください。

DTP Extension Designer を使用して、External System Traceability Report および Sending Test Data to External System フローを環境にデプロイします。アーティファクトを展開する前に、「Connecting DTP to VersionOne Server」で説明されているように、DTP が VersionOne に接続されていることを確認します。

Traceability Pack をインストールする

最初のステップは、 Traceability Pack をインストールすることです。このアーティファクトは、トレーサビリティを可能にする構成ファイルとアセットの集合です。

設定メニュー (歯車のアイコン) から [Extension Designer] を選択します。
[構成] タブをクリックしてアーティファクトマネージャーを開きます。
[アーティファクトの追加] をクリックし、traceability-pack-<version>.zip アーカイブを参照します (「アーティファクトのダウンロードとインストール」も参照)。
[インストール] をクリックすると、トレーサビリティを有効にするためのアセットと構成ファイルの集合がインストールされます。

External System Traceability Report のデプロイ

Traceability Pack をインストールした後、External System Traceability Report をデプロイします。

Extension Designer を開き、[サービス] タブをクリックします。
既存のサービスを選択してアーティファクトを展開するか、[DTP ワークフロー] カテゴリで新しいサービスを作成します。サービスとアーティファクトの編成に関する追加情報については、「サービスの使用」を参照してください。
既存のサービスにアーティファクトを追加する場合は、新しい [フロー] タブを追加し (「フローの使用」を参照)、縦の三点メニューから [読み込み] を選択します。
[Local] > [Flows] > [Workflows] > [Traceability Pack] > [External System Traceability Report] を選択し、[読み込み] をクリックします。
[フロー] タブの中をクリックしてサービスにノードをドロップし、[デプロイ] をクリックします。

External System Traceability Report をデプロイすると、Report Center にドリルダウンレポートと新しいウィジェットが追加されます。ウィジェットを追加してレポートを参照する方法については「Viewing the Traceability Report」を参照してください。

Sending Test Data to External System フローのデプロイ

このアーティファクトは、DTP Data Collector が Parasoft ツールからテスト結果を取得するときに、テストデータを VersionOne に送信します。このアーティファクトは Traceability Pack に同梱されており、「Installing the Traceability Pack」の説明にあるように、フローをデプロイする前にインストールする必要があります。

Extension Designer を開き、[サービス] タブをクリックします。
既存のサービスを選択してアーティファクトを展開するか、[DTP ワークフロー] カテゴリで新しいサービスを作成します。サービスとアーティファクトの編成に関する追加情報については、「サービスの使用」を参照してください。
既存のサービスにアーティファクトを追加する場合は、新しい [フロー] タブを追加し (「フローの使用」を参照)、縦の三点メニューから [次からのインポート] を選択します。
[Library] > [Workflows] > [Traceability Pack] > [Sending Test Data to External System] を選択し、[インポート] をクリックします。
[フロー] タブの中をクリックしてサービスにノードをドロップし、[デプロイ] をクリックします。

詳細設定

<DTP_DATA_DIR>/conf ディレクトリにある ExternalSystemSettings.properties 構成ファイルを変更して、統合のデフォルトの動作を変更できます。すぐに利用できるこの構成は、デフォルトまたは一般的に使用されるフィールドと作業アイテムタイプを使用します。ただし、VersionOne システムをカスタマイズしている場合は、次の設定を行って、DTP のデータをカスタム構成に合わせることができます。

versionOneIssueUrl

DTP の違反エクスプローラーとテストエクスプローラーで作成された作業アイテムを VersionOne の作業アイテムにリンクするための URL テンプレートを指定します。

デフォルト:

versionOneIssueUrl=<VERSIONONE_URL>/assetdetail.v1?number=<ID>

versionOne.workItemType.defect

DTP の違反エクスプローラーとテストエクスプローラーから新しいタスクを作成するときに VersionOne で作成する作業アイテムタイプを指定します。これにより、VersionOne で構成したカスタムの欠陥トラッカーを DTP から作成された作業アイテムに関連付けることができます。

デフォルトでは、このプロパティは設定されていません。その結果、DTP で作成されたタスク作業アイテムは、VersionOne のタスク作業アイテムに関連付けられます。

versionOne.workItemType.issue

DTP の違反エクスプローラーとテストエクスプローラーから新しい課題を作成するときに VersionOne で作成する作業アイテムタイプを指定します。これにより、VersionOne で構成したカスタムの課題トラッカーを DTP から作成された作業アイテムに関連付けることができます。

デフォルトでは、このプロパティは設定されていません。その結果、DTP で作成された課題作業アイテムは、VersionOne のタスク作業アイテムに関連付けられます。

使用

VersionOne との統合を設定した後、開発者、テスター、およびその他のユーザーは、統合によって実現される機能を活用できます。

VersionOne での欠陥と問題の手動作成

テストエクスプローラービューと違反エクスプローラービューを使用すると、ステータスに関係なく、テストと違反に対してそれぞれ課題と欠陥を作成できます。エクスプローラービューで VersionOne アセットを作成する方法については、以下のセクションを参照してください。

違反エクスプローラーから VersionOne の欠陥と課題を手動で作成する方法については、「サードパーティシステムでの課題の作成」を参照してください。
テストエクスプローラーから VersionOne の欠陥と課題を手動で作成する方法については、「サードパーティシステムでの課題の作成」を参照してください。

VersionOne のストーリーがクローズされても、API と UI のどちらを使用しているかに関係なく、DTP は引き続きアーティファクトを作成します。

VersionOne の用語

VersionOne の「課題」とは、プロジェクト全体の可視性を必要とする項目を強調する作業アイテムを指します。課題は、プロジェクトチームのデリバリーを妨げている、または妨げる可能性があるものすべてを表すことがあります。「欠陥」とは、完成した機能の予想される振る舞いと実際の振る舞いとの間の食い違いを識別する作業アイテムです。欠陥は、ストーリー/バックログ項目と同じ方法でスプリント/イテレーションにスケジュールすることができます。または、スプリントの外部にある個別の作業キューとして追跡することもできます。

次の表は、VersionOne でアセットがどのように作成されるのかを示したものです。

	@req アノテーションに関連付け	@test アノテーションに関連付け
欠陥	DTP は、Breaks Work Item フィールドでアセットを作成。テストエクスプローラービューへのリンク	DTP は、Breaks Work Item フィールドでアセットを作成。テストエクスプローラービューへのリンク VersionOne のテストへのリンク
課題	DTP は、Blocking Issues フィールドでアセットを作成。テストエクスプローラーへのリンク	DTP は、Blocking Issues フィールドでアセットを作成。テストエクスプローラービューへのリンク VersionOne のテストへのリンク

VersionOne へのテストデータの送信

VersionOne の作業項目は、ストーリー、欠陥、またはテストセットを表すアセットです。Parasoft ツールが実行するテストコードに @test アノテーションおよび VersionOne のテスト ID を追加し、Parasoft テストを VersionOne テストに関連付けます。テストコードに @req アノテーションおよび VersionOne ストーリー ID を追加し、Parasoft のテストを VersionOne のストーリーに関連付けます。関連付けを追加する方法の詳細については Parasoft ツールのドキュメントを参照してください。作業項目 ID を取得する方法については VersionOne のドキュメントを参照してください。次の図は、VersionOne の環境に Parasoft DTP を統合するための自動インフラストラクチャの実装方法を示しています。

Parasoft C/C++test、dotTEST、Jtest によって実行されるテストに関連付けられる作業アイテムを VersionOne で作成します。
テストファイルで、@test または @req アノテーションを使用して VersionOne の作業アイテム ID を追加します。アノテーションの追加の詳細については、C/C++test、dotTEST、または Jtest のドキュメントを参照してください。
- @test <VersionOne test ID> アノテーションを使用して、テストを VersionOne のテストケースと関連付けます。
- @req <VersionOne story ID> アノテーションを使用して、テストを VersionOne のストーリーと関連付けます。
- VersionOne の作業アイテム ID は、いくつかの VersionOne インターフェイスで使用できます。
  1 つのテストケースを 1 つの VersionOne ストーリーに関連付ける
  VersionOne の制限により、VersionOne ではテストケースを 1 つのストーリーにのみ割り当てることができます。テストケースに複数のストーリー ID を指定する @req アノテーションが含まれている場合、テストケースは最初にリストされたストーリーにのみ関連付けられ、後続のストーリー ID はすべて無視されます。以下の例では、テストケースは VersionOne のストーリー S-012 にのみ関連付けられます。
  /** * @req S-012, D-131 * @req B-991 */
CI プロセスの一部としてテストを実行します。ツールのデスクトップからテストを手動で実行することもできます。
テスト実行の一環として、C/C++test はフィルターとビルド ID でテスト結果をタグ付けし、データを DTP に送信します。DTP ダッシュボードにテストウィジェットを追加し、フィルターとビルド ID を設定することにより、DTP で結果を確認できます。開発者は、テスト実行データを DTP から IDE にダウンロードして、失敗したテストに対処できます。

Sending Test Data to External System フローをデプロイした場合 (「Deploying the Sending Test Data to External System Flow」を参照)、Data Collector が Parasoft ツールからデータを受信すると、単体テストと機能テストの結果が VersionOne に自動的に送信されます。デフォルトでは、フローは Data Collector が受信した任意のプロジェクトの単体テストおよび機能テストの結果をフォワードしますが、特定のプロジェクトのデータだけを送信するようフローを設定できます。
また、DTP REST API エンドポイントに POST リクエストを手動で送信して、DTP データベースから VersionOne に結果を送信することもできます。API 呼び出しの DTP フィルターとビルド ID を URL パラメーターとして渡します。

curl -X POST -u <username>:<password> "http://<host>:<port>/grs/api/v1.7/linkedApps/configurations/1/syncTestCases?filterId=<filterID>&buildId=<buildID>"

以下の表でエンドポイントのパラメーターについて説明します。

パラメーター値説明必須

filterId integer テストデータを含むフィルター IDを指定します。フィルター ID は整数値です。フィルター名と混同しないでください。 Required (必須)

buildId string テストデータを含むビルド ID を指定します。 Required (必須)

groupResultsBySOAtestTST

boolean

true に設定すると、SOAtest の結果が .tst ファイルでグループ化されます。その結果、1 つの .tst ファイルが 1 つの VersionOne テストに関連付けられます。

false に設定すると、SOAtest.tst 内の各テストステップが VersionOne テストに関連付けられます。

デフォルトは false です。

任意

フィルターおよびビルド ID は、テストエクスプローラーの URL で利用できます。

DTP は、filterId パラメーターと buildId パラメーターに一致するテスト結果を見つけ、そのデータを VersionOne の作業アイテムに送信します。次の応答を受け取るはずです。
- DTP は、@test <ID> で結果を見つけると、VersionOne で一致する ID を持つ単体テストケースを検索し、アイテムを更新します。VersionOne に単体テストケース ID が存在しない場合、アクションは実行されません。
- DTP は、@req <ID> で結果を見つけると、VersionOne で一致する ID を持つ作業アイテムを検索し、関連する子単体テストケースを更新します。要件 ID に一致する単体テストケースが存在しない場合、単体テストケースが作成されます。要件 ID が見つからない場合も、単体テストケースが作成されます。
- external-app-sync.log ファイルも <DTP_INSTALL>/logs ディレクトリに書き込まれます。このログファイルには、DTP から VersionOne へのテスト結果の送信に関する進捗情報が含まれています。

DTP がレポートを処理し、結果を VersionOne に送信した後、以下のような応答があります。

{
	"createdTestSession":"DTPP-521"
    "created" : [
		"DTPP-519, testName = testBagSumAdd"
    ],
    "updated" : [
        "Test:1545 for AT-01053, testName = test_quoteGhsLine_Exp_Act_3",
        "Test:1546 for AT-01054, testName = test_quoteGhsLine",
        "Test:1554 for AT-01056, testName = test_quoteGhsLine_Exp_Act_10",
        "Test:7177 for S-01045, testName = test_quoteGhsLine_moreThanOne"
    ],
    "ignored" : [
		"MAGD-567, testName = testBagNegate",
        "QAP-512, testName = testTryThis3",
        "QAP-512, testName = testTryThis4",
        "MAGD-567, testName = testBagMultiply"
    ]
}

特定の DTP プロジェクトの結果を送信する

Sending Test Data to External System フローを使用して単体テストおよび機能テストの結果を送信している場合、デフォルトでは、すべての DTP プロジェクトのデータが VersionOne に送信されます。結果として、VersionOne ID に一致するアノテーションを含むすべての DTP プロジェクトで収集されたテストを含むよう、作業アイテムが更新されます。ただし、特定のプロジェクトのデータだけを送信するよう、フローを設定することもできます。

Extension Designer を開き、Sending Test Data がデプロイされたサービスを開きます。
ワークスペースに新しいスイッチノードをドラッグします。
"DataCollectorProcessedEvent" ノードと "Is dynamic analysis" ノードの間の接続線を選択して削除します。
"DataCollectorProcessedEvent" ノードからスイッチノード、またスイッチノードから "Is dynamic analysis" ノードに新しい接続をドラッグします。
ノードをダブルクリックし、Property フィールドに次の文字列を指定します。
```
 event.message.resultsSession.project
```
文字列フィールドに DTP プロジェクトの名前を指定します。
(任意) ノードのわかりやすい名前を指定します。
[終了] をクリックしてノードの設定を終了し、[デプロイ] をクリックします。

フローを実行すると、指定した DTP プロジェクトのテスト結果だけが VersionOne に送信されます。

VersionOne での結果の表示

テストデータが DTP から正常に送信されると、VersionOne で結果を表示できるようになります。

結果をさらに展開して、DTP での作業アイテムについての詳細情報を確認できます。これには、ビルドおよび作成者情報のほか、DTP のテスト/違反へのリンクが含まれます。

Traceability Report の表示

ご使用のシステムに External System Traceability Report がデプロイされている場合 (「 Enabling the Traceability Report」を参照)、ウィジェットをダッシュボードに追加して、作業アイテムからプロジェクトのテスト/静的解析/コードレビューまでのトレーサビリティをモニタリングできます。ウィジェットから、さらに詳細な情報を含むレポートを表示できます。

ウィジェットの追加と構成

DTP ダッシュボード追加されたウィジェットは、個別のトレーサビリティカテゴリに表示されます。ウィジェットを追加する方法については「ウィジェットの追加」を参照してください。

以下の設定を行うことができます。

タイトル	デフォルトのタイトルの代わりにダッシュボードに表示する新しいタイトルを入力できます。
フィルター	[ダッシュボード設定] を選択してダッシュボードフィルターを使用するか、ドロップダウンメニューからフィルターを選択します。フィルターの詳細については「フィルターの作成と管理」を参照してください。
ターゲットビルド	テストとコード解析を実行したビルド ID に設定する必要があります。ダッシュボード設定で指定されたビルド、最新ビルド、またはドロップダウンメニューで選択したビルドを使用できます。「ダッシュボードの設定」も参照してください。
Type	Pie ウィジェットのみ。ドロップダウンメニューからテスト、違反、またはレビューを選択し、そのステータスを示す円グラフを表示します。完全な概要をダッシュボードに表示するには、各タイプに設定したウィジェットのインスタンスを追加します。
プロジェクト	ドロップダウンメニューから VersionOne プロジェクトを選択します。

Requirements Widget

このウィジェットには、指定された VersionOne プロジェクトの作業アイテムの数が表示されます。

ウィジェットをクリックすると、Requirement Traceability レポートが表示されます。

Test Coverage Widget

このウィジェットは、プロジェクトのすべての要件に対する、テストでカバーされた要件の割合を示します。

ウィジェットの中央をクリックすると、Requirement Traceability レポートが表示されます。

色付きのセグメントは、テストの対象となる要件を表しています。ウィジェットをクリックすると、With Tests カテゴリにフィルタリングされた Requirement Traceability レポートが表示されます。

Pie Widget

単体テスト、機能テスト、静的解析、およびピアレビューは、作業アイテムが適切かつ徹底的に実装されているかを検証するための一般的なアクティビティです。このウィジェットは、それらのソフトウェア品質アクティビティのコンテキストにおけるプロジェクト作業アイテムの全般的なステータスを表示します。品質アクティビティの種類 (テスト、静的解析違反、レビュー) ごとにウィジェットを追加して、プロジェクト作業アイテムの実装の進捗をモニタリングすることができます。

グラフ上のセクションにマウスポインタを置くと、品質アクティビティタイプのステータスについて詳細情報が表示されます。ウィジェットをクリックすると、選択したタイプでフィルタリングされた Requirement Traceability レポートが表示されます。

Requirements Implementation Status by Tests

Requirements Implementation Status by Violations

Requirements Implementation by Reviews

Requirements Traceability Report とは

このレポートは、VersionOne プロジェクトの作業アイテムとそれに関連するデータを表示します。

以下の操作を行うことができます。

レポートの [Files] 列と [Reviews] 列を非表示にする場合は、[Show files/reviews] オプションを無効にします。[Files] 列と [Reviews] 列にデータがあるのは、要件がソースファイルにマッピングされている場合だけです (「Enabling the Requirements Traceability Report」を参照)。この画面で [Files] 列および [Reviews] 列を無効にすると、関連するタブが Requirement Details レポートで非表示になります。
VersionOne で作業アイテムを確認するには、[Key] 列のリンクをクリックします。
[Summary] 列または [Test] 列のリンクをクリックして、 Requirement Details Report の作業アイテムに関係するテスト関連情報を表示します。
[Files] 列のリンクをクリックして、 Requirement Details Report の作業アイテムに関係する静的解析関連の情報を表示します。
[Reviews] 列のリンクをクリックして、 Requirement Details Report の作業アイテムに関係する変更レビュー関連の情報を表示します。

Requirement Traceability Report by Type

Pie ウィジェットのセクションをクリックすると、ウィジェットで選択した品質アクティビティタイプだけを含むレポートが表示されます。[Show files/reviews] オプションを無効にして、レポートの [Files] 列と [Reviews] 列を非表示にすることもできます。[Files] 列と [Reviews] 列にデータがあるのは、要件がソースファイルにマッピングされている場合だけです (「Enabling the Requirements Traceability Report」を参照)。この画面で [Files] 列および [Reviews] 列を無効にすると、関連するタブが Requirement Details レポートで非表示になります。

Requirement Details Report とは

Requirement Details レポートは、VersionOne の特定の作業アイテムに関連したファイル、静的解析の指摘事項、およびテストについての情報を表示します。Dead とマークされたストーリーは、Traceability Report に表示されません。Traceability Report には、次の VersionOne の作業アイテムに関する情報が表示されます。

Requirements
Defects

このレポートは、メインの Requirement Traceability レポートで作業アイテムをクリックすることで表示されます。

最初のタブには、作業アイテムを検証するために実行されたテストの結果が表示されます。

[View results in Test Explorer] リンクをクリックすると、要件に関連付けられたすべてのテストをテストエクスプローラーで参照できます。

テーブルの個々のテスト名をクリックし、テストエクスプローラーで個々のテストを参照することもできます。

2 番目のタブには、要件に関連付けられたファイルと、ファイルで検出された静的解析違反が表示されます。[違反] 列のリンクをクリックして、違反エクスプローラーで違反を確認できます。違反に関する詳細が表示されます。

このタブにデータがあるのは、要件がソースファイルにマッピングされている場合だけです (「Enabling the Requirements Traceability Report」を参照)。要件をソースファイルにマッピングしなかった場合は、メインの Traceability レポートページで [ファイル/レビューを表示] オプションを無効にし、詳細レポートを再読み込みすることで、このタブを非表示にできます。

ファイルに変更レビューまたはレビュー指摘事項が含まれる場合、それらは 3 番目のタブに表示されます。リンクをクリックすると、変更エクスプローラーで確認できます。