この機能は非推奨となり、今後のリリースで削除される予定です。 |
このセクションの内容:
VersionOne は、要件、欠陥、他の作業アイテムを管理/追跡するための一般的なブラウザー ベースのプラットフォームです。Parasoft DTP は VersionOne と統合し、以下の機能を提供します。
この設定は、Parasoft 管理者が一度だけ行う必要があります。開発者、テスター、およびその他の DTP エンドユーザーは、Parasoft ツールを VersionOne と連携して使用する方法について、「使用」を参照してください。
Parasoft プロジェクトを VersionOne プロジェクトに関連付けると、違反ビューまたはテストエクスプローラービューから欠陥を作成し、VersionOne の適切なプロジェクトにリンクできます。Sending Test Data to External System フロー を使用する場合、関連付けも重要です。DTP の複数のプロジェクトを 1 つの VersionOne プロジェクトと関連付けることはできますが、同じ DTP プロジェクトを複数の VersionOne プロジェクトと関連付けることはできません。
プロジェクトの関連付けを削除するには、ゴミ箱のアイコンをクリックします。プロジェクトの関連付けを削除しても、リンクは削除されません。新しい関連付けを作成すると、違反と VersionOne の課題との既存リンクが再び有効になります。
DTP と VersionOne プロジェクトの既存の関連付けの設定を変更できます。
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 フローを環境にデプロイします。アーティファクトを展開する前に、「DTP と VersionOne サーバーの接続」で説明されているように、DTP が VersionOne に接続されていることを確認します。
最初のステップは、 Traceability Pack をインストールすることです。このアーティファクトは、トレーサビリティを可能にする構成ファイルとアセットの集合です。
Traceability Pack をインストールした後、External System Traceability Report をデプロイします。
External System Traceability Report をデプロイすると、Report Center にドリルダウン レポートと新しいウィジェットが追加されます。ウィジェットを追加してレポートを参照する方法については「Traceability Report の表示」を参照してください。
このアーティファクトは、DTP Data Collector が Parasoft ツールからテスト結果を取得するときに、テスト データを VersionOne に送信します。このアーティファクトは Traceability Pack に同梱されており、「Traceability Pack をインストールする」の説明にあるように、フローをデプロイする前にインストールする必要があります。
<DTP_DATA_DIR>/conf ディレクトリにある ExternalSystemSettings.properties 構成ファイルを変更して、統合のデフォルトの動作を変更できます。すぐに利用できるこの構成は、デフォルトまたは一般的に使用されるフィールドと作業アイテム タイプを使用します。ただし、VersionOne システムをカスタマイズしている場合は、以下で説明する設定を行って、DTP のデータをカスタム構成に合わせることができます。
ExternalSystemSettings.properties は ISO 8859-1 (Latin1) 文字エンコーディングを使用することに注意してください。ISO 8859-1 でサポートされていない文字は、Unicode エスケープ シーケンス、つまりバックスラッシュ (\) と小文字の u の後に、その文字の 4 桁の 16 進コードが続くものを使用して、キーと要素で表現する必要があります。たとえば、ダッシュ (-) (ハイフン - マイナス ”-” と混同しないでください) は ISO 8859-1 ではサポートされていないため、Unicode エスケープ シーケンス \u2013 で表す必要があります。これにより、example.property.value=Foo – Bar のようなものは、example.property.value=Foo \u2013 Bar と入力する必要があります。
| versionOneIssueUrl | DTP の違反エクスプローラーとテスト エクスプローラーで作成された作業アイテムを VersionOne の作業アイテムにリンクするための URL テンプレートを指定します。 デフォルト:
|
|---|---|
| versionOne.workItemType.defect | DTP の違反エクスプローラーとテスト エクスプローラーから新しいタスクを作成するときに VersionOne で作成する作業アイテム タイプを指定します。これにより、VersionOne で構成したカスタムの欠陥トラッカーを DTP から作成された作業アイテムに関連付けることができます。 デフォルトでは、このプロパティは設定されていません。その結果、DTP で作成されたタスク作業アイテムは、VersionOne のタスク作業アイテムに関連付けられます。 |
| versionOne.workItemType.issue | DTP の違反エクスプローラーとテスト エクスプローラーから新しい課題を作成するときに VersionOne で作成する作業アイテム タイプを指定します。これにより、VersionOne で構成したカスタムの課題トラッカーを DTP から作成された作業アイテムに関連付けることができます。 デフォルトでは、このプロパティは設定されていません。その結果、DTP で作成された課題作業アイテムは、VersionOne のタスク作業アイテムに関連付けられます。 |
VersionOne との統合を設定した後、開発者、テスター、およびその他のユーザーは、統合によって実現される機能を活用できます。
テスト エクスプローラー ビューと違反エクスプローラー ビューを使用すると、ステータスに関係なく、テストと違反に対してそれぞれ課題と欠陥を作成できます。エクスプローラー ビューで VersionOne アセットを作成する方法については、以下のセクションを参照してください。
VersionOne のストーリーがクローズされても、API と UI のどちらを使用しているかに関係なく、DTP は引き続きアーティファクトを作成します。
VersionOne の「課題」とは、プロジェクト全体の可視性を必要とする項目を強調する作業アイテムを指します。課題は、プロジェクト チームのデリバリーを妨げている、または妨げる可能性があるものすべてを表すことがあります。「欠陥」とは、完成した機能の予想される振る舞いと実際の振る舞いとの間の食い違いを識別する作業アイテムです。欠陥は、ストーリー/バックログ項目と同じ方法でスプリント/イテレーションにスケジュールすることができます。または、スプリントの外部にある個別の作業キューとして追跡することもできます。 |
次の表は、VersionOne でアセットがどのように作成されるのかを示したものです。
| @req アノテーションに関連付け | @test アノテーションに関連付け | |
|---|---|---|
| 欠陥 |
|
|
| 課題 |
|
|
VersionOne の作業項目は、ストーリー、欠陥、またはテスト セットを表すアセットです。Parasoft ツールが実行するテスト コードに @test アノテーションおよび VersionOne のテスト ID を追加し、Parasoft テストを VersionOne テストに関連付けます。テストコードに @req アノテーションおよび VersionOne ストーリー ID を追加し、Parasoft のテストを VersionOne のストーリーに関連付けます。関連付けを追加する方法の詳細については Parasoft ツールのドキュメントを参照してください。作業項目 ID を取得する方法については VersionOne のドキュメントを参照してください。次の図は、VersionOne の環境に Parasoft DTP を統合するための自動インフラストラクチャの実装方法を示しています。
@test または @req アノテーションを使用して VersionOne の作業アイテム ID を追加します。アノテーションの追加の詳細については、C/C++test、dotTEST、または Jtest のドキュメントを参照してください。@test <VersionOne test ID> アノテーションを使用して、テストを VersionOne のテスト ケースと関連付けます。 @req <VersionOne story ID> アノテーションを使用して、テストを VersionOne のストーリーと関連付けます。VersionOne の作業アイテム ID は、いくつかの VersionOne インターフェイスで使用できます。
VersionOne の制限により、VersionOne ではテストケースを 1 つのストーリーにのみ割り当てることができます。テストケースに複数のストーリー ID を指定する
|
Sending Test Data to External System フローをデプロイした場合 (「Sending Test Data to External System フローのデプロイ」を参照)、Data Collector が Parasoft ツールからデータを受信すると、単体テストと機能テストの結果が VersionOne に自動的に送信されます。デフォルトでは、フローは Data Collector が受信した任意のプロジェクトの単体テストおよび機能テストの結果をフォワードしますが、特定のプロジェクトのデータだけを送信するようフローを設定できます (「特定の DTP プロジェクトの結果を送信する」を参照)。
また、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>" |
以下の表でエンドポイントのパラメーターについて説明します。
| パラメーター | 値 | 説明 | Required (必須) |
|---|---|---|---|
filterId | integer | テスト データを含むフィルター IDを指定します。フィルター ID は整数値です。フィルター名と混同しないでください。 | Required (必須) |
buildId | string | テスト データを含むビルド ID を指定します。 | Required (必須) |
groupResultsBySOAtestTST | boolean |
デフォルトは | 任意 |
フィルターおよびビルド ID は、テスト エクスプローラーの URL で利用できます。
filterId パラメーターと buildId パラメーターに一致するテスト結果を見つけ、そのデータを VersionOne の作業アイテムに送信します。次の応答を受け取るはずです。DTP は、@test <ID> で結果を見つけると、VersionOne で一致する ID を持つ単体テスト ケースを検索し、アイテムを更新します。VersionOne に単体テスト ケース ID が存在しない場合、アクションは実行されません。
DTP は、@req <ID> で結果を見つけると、VersionOne で一致する ID を持つ作業アイテムを検索し、関連する子単体テスト ケースを更新します。要件 ID に一致する単体テスト ケースが存在しない場合、単体テスト ケースが作成されます。要件 ID が見つからない場合も、単体テスト ケースが作成されます。
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"
]
} |
Sending Test Data to External System フローを使用して単体テストおよび機能テストの結果を送信している場合、デフォルトでは、すべての DTP プロジェクトのデータが VersionOne に送信されます。結果として、VersionOne ID に一致するアノテーションを含むすべての DTP プロジェクトで収集されたテストを含むよう、作業アイテムが更新されます。ただし、特定のプロジェクトのデータだけを送信するよう、フローを設定することもできます。
ノードをダブルクリックし、Property フィールドに次の文字列を指定します。
event.message.resultsSession.project |
フローを実行すると、指定した DTP プロジェクトのテスト結果だけが VersionOne に送信されます。
テスト データが DTP から正常に送信されると、VersionOne で結果を表示できるようになります。
結果をさらに展開して、DTP での作業アイテムについての詳細情報を確認できます。これには、ビルドおよび作成者情報のほか、DTP のテスト/違反へのリンクが含まれます。
ご使用のシステムに External System Traceability Report がデプロイされている場合 (「 Traceability Report の有効化」を参照)、ウィジェットをダッシュボードに追加して、作業アイテムからプロジェクトのテスト/静的解析/コードレビューまでのトレーサビリティをモニタリングできます。ウィジェットから、さらに詳細な情報を含むレポートを表示できます。
DTP ダッシュボード追加されたウィジェットは、個別のトレーサビリティ カテゴリに表示されます。ウィジェットを追加する方法については「ウィジェットの追加」を参照してください。
以下の設定を行うことができます。
| タイトル | デフォルトのタイトルの代わりにダッシュボードに表示する新しいタイトルを入力できます。 |
|---|---|
| フィルター | [ダッシュボード設定] を選択してダッシュボード フィルターを使用するか、ドロップダウン メニューからフィルターを選択します。フィルターの詳細については「フィルターの作成と管理」を参照してください。 |
| ターゲット ビルド | テストとコード解析を実行したビルド ID に設定する必要があります。ダッシュボード設定で指定されたビルド、最新ビルド、またはドロップダウン メニューで選択したビルドを使用できます。「ダッシュボードの設定」も参照してください。 |
| Type | Pie ウィジェットのみ 。ドロップダウン メニューからテスト、違反、またはレビューを選択し、そのステータスを示す円グラフを表示します。完全な概要をダッシュボードに表示するには、各タイプに設定したウィジェットのインスタンスを追加します。 |
| プロジェクト | ドロップダウン メニューから VersionOne プロジェクトを選択します。 |
このウィジェットには、指定された VersionOne プロジェクトの作業アイテムの数が表示されます。
ウィジェットをクリックすると、Requirement Traceability レポート が表示されます。
このウィジェットは、プロジェクトのすべての要件に対する、テストでカバーされた要件の割合を示します。
ウィジェットの中央をクリックすると、Requirement Traceability レポート が表示されます。
色付きのセグメントは、テストの対象となる要件を表しています。ウィジェットをクリックすると、With Tests カテゴリにフィルタリングされた Requirement Traceability レポート が表示されます。
単体テスト、機能テスト、静的解析、およびピア レビューは、作業アイテムが適切かつ徹底的に実装されているかを検証するための一般的なアクティビティです。このウィジェットは、それらのソフトウェア品質アクティビティのコンテキストにおけるプロジェクト作業アイテムの全般的なステータスを表示します。品質アクティビティの種類 (テスト、静的解析違反、レビュー) ごとにウィジェットを追加して、プロジェクト作業アイテムの実装の進捗をモニタリングすることができます。
グラフ上のセクションにマウス ポインタを置くと、品質アクティビティ タイプのステータスについて詳細情報が表示されます。ウィジェットをクリックすると、選択したタイプでフィルタリングされた Requirement Traceability レポートが表示されます。
このレポートは、VersionOne プロジェクトの作業アイテムとそれに関連するデータを表示します。
以下の操作を行うことができます。
Pie ウィジェットのセクションをクリックすると、ウィジェットで選択した品質アクティビティ タイプだけを含むレポートが表示されます。[Show files/reviews] オプションを無効にして、レポートの [Files] 列と [Reviews] 列を非表示にすることもできます。[Files] 列と [Reviews] 列にデータがあるのは、要件がソース ファイルにマッピングされている場合だけです (「Traceability Report の有効化」を参照)。この画面で [Files] 列および [Reviews] 列を無効にすると、関連するタブが Requirement Details レポート で非表示になります。
Requirement Details レポートは、VersionOne の特定の作業アイテムに関連したファイル、静的解析の指摘事項、およびテストについての情報を表示します。Dead とマークされたストーリーは、Traceability Report に表示されません。Traceability Report には、次の VersionOne の作業アイテムに関する情報が表示されます。
このレポートは、メインの Requirement Traceability レポートで作業アイテムをクリックすることで表示されます。
最初のタブには、作業アイテムを検証するために実行されたテストの結果が表示されます。
[View results in Test Explorer] リンクをクリックすると、要件に関連付けられたすべてのテストを テスト エクスプローラー で参照できます。
テーブルの個々のテスト名をクリックし、テスト エクスプローラーで個々のテストを参照することもできます。
2 番目のタブには、要件に関連付けられたファイルと、ファイルで検出された静的解析違反が表示されます。[違反] 列のリンクをクリックして、違反エクスプローラー で違反を確認できます。違反に関する詳細が表示されます。
このタブにデータがあるのは、要件がソース ファイルにマッピングされている場合だけです (「Traceability Report の有効化」を参照)。要件をソース ファイルにマッピングしなかった場合は、メインの Traceability レポート ページで [ファイル/レビューを表示] オプションを無効にし、詳細レポートを再読み込みすることで、このタブを非表示にできます。
ファイルに変更レビューまたはレビュー指摘事項が含まれる場合、それらは 3 番目のタブに表示されます。リンクをクリックすると、変更エクスプローラー で確認できます。
このタブにデータがあるのは、要件がソース ファイルにマッピングされている場合だけです (「Traceability Report の有効化」を参照)。要件をソース ファイルにマッピングしなかった場合は、メインの Traceability レポート ページで [ファイル/レビューを表示] オプションを無効にし、詳細レポートを再読み込みすることで、このタブを非表示にできます。