Info |
---|
この機能は非推奨となり、今後のリリースで削除される予定です。 |
このセクションの内容:
Table of Contents | ||
---|---|---|
|
...
- Violations Explorer から VersionOne で手動で欠陥や課題を作成する機能
- Test Explorer から VersionOne で手動で欠陥や課題を作成する機能
- VersionOne の作業アイテムで Parasoft のテスト結果を送信、表示、および更新する機能。
- VersionOneのトレーサビリティレポートを使用してトレーサビリティを追跡することを計画しているユーザー向け。これを行うには、最初に Parasoft DTP から VersionOne にテスト結果を送信する必要があります。
- テスト、静的解析結果、コード レビューを VersionOne の作業アイテムから追跡する機能 (「Viewing the Traceability Report の表示」を参照)。
- Parasoft DTP のトレーサビリティ レポートを使用してトレーサビリティを追跡することを計画しているユーザー向け。これを行うには、@req を使用して、Parasoft の自動テストを VersionOne 要件に関連付けます。
...
この設定は、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 プロジェクトで課題を作成するのに十分な権限が必要です。
- [接続のテスト] をクリックして設定を確認し、[確認] をクリックします。
...
- 鉛筆アイコンをクリックして、ドロップダウンメニューから別の DTP プロジェクトを選択するか、[外部プロジェクト]フィールドに別の VersionOne プロジェクトの名前を指定します。
- [保存] をクリックします。
...
Traceability Report
...
の有効化
VersionOne に保存された作業アイテム、および Parasoft ツール (C/C++test、dotTEST、Jtest、SOAtest) から DTP に送信されたテスト データ、静的解析データ、ビルド レビュー データとの間のトレーサビリティを実証するのに役立つウィジェットとレポートを生成するように、DTP を構成できます。
...
DTP Extension Designer を使用して、External System Traceability Report および Sending Test Data to External System フローを環境にデプロイします。アーティファクトを展開する前に、「Connecting DTP to と VersionOne Serverサーバーの接続」で説明されているように、DTP が VersionOne に接続されていることを確認します。
...
- Extension Designer を開き、[サービス] タブをクリックします。
- 既存のサービスを選択してアーティファクトを展開するか、[DTP ワークフロー] カテゴリで新しいサービスを作成します。サービスとアーティファクトの編成に関する追加情報については、「Working with Services 」を参照してください。」を参照してください。
- 既存のサービスにアーティファクトを追加する場合は、新しい [フロー] タブを追加し (「Working with Flows」を参照)、縦の三点メニューから [読み込み] を選択します。
- [Local] > [Flows] > [Workflows] > [Traceability Pack] > [External System Traceability 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 ワークフロー] カテゴリで新しいサービスを作成します。サービスとアーティファクトの編成に関する追加情報については、「Working with Services 」を参照してください。
- 既存のサービスにアーティファクトを追加する場合は、新しい [フロー] タブを追加し (「Working with Flows」を参照)、縦の三点メニューから [次からのインポート読み込み] を選択します。
- [Library] > [Workflows] > [Traceability Pack] > [Sending Test Data to External System] を選択し、[インポート読み込み] をクリックします。
- [フロー] タブの中をクリックしてサービスにノードをドロップし、[デプロイ] をクリックします。
...
<DTP_DATA_DIR>/conf ディレクトリにある ExternalSystemSettings.properties 構成ファイルを変更して、統合のデフォルトの動作を変更できます。すぐに利用できるこの構成は、デフォルトまたは一般的に使用されるフィールドと作業アイテム タイプを使用します。ただし、VersionOne システムをカスタマイズしている場合は、次の設定を行って、DTP のデータをカスタム構成に合わせることができます。システムをカスタマイズしている場合は、以下で説明する設定を行って、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
と入力する必要があります。
Scroll Table Layout | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
versionOneIssueUrl | DTP の違反エクスプローラーとテスト エクスプローラーで作成された作業アイテムを VersionOne の作業アイテムにリンクするための URL テンプレートを指定します。 デフォルト:
|
---|---|
versionOne.workItemType.defect | DTP の違反エクスプローラーとテスト エクスプローラーから新しいタスクを作成するときに VersionOne で作成する作業アイテム タイプを指定します。これにより、VersionOne で構成したカスタムの欠陥トラッカーを DTP から作成された作業アイテムに関連付けることができます。 デフォルトでは、このプロパティは設定されていません。その結果、DTP で作成されたタスク作業アイテムは、VersionOne のタスク作業アイテムに関連付けられます。 |
versionOne.workItemType.issue | DTP の違反エクスプローラーとテスト エクスプローラーから新しい課題を作成するときに VersionOne で作成する作業アイテム タイプを指定します。これにより、VersionOne で構成したカスタムの課題トラッカーを DTP から作成された作業アイテムに関連付けることができます。 デフォルトでは、このプロパティは設定されていません。その結果、DTP で作成された課題作業アイテムは、VersionOne のタスク作業アイテムに関連付けられます。 |
...
Anchor |
---|
...
|
...
|
VersionOne との統合を設定した後、開発者、テスター、およびその他のユーザーは、統合によって実現される機能を活用できます。
...
VersionOne での欠陥と問題の手動作成
テスト エクスプローラー ビューと違反エクスプローラー ビューを使用すると、ステータスに関係なく、テストと違反に対してそれぞれ課題と欠陥を作成できます。エクスプローラー ビューで VersionOne アセットを作成する方法については、以下のセクションを参照してください。
...
@req アノテーションに関連付け | @test アノテーションに関連付け | |
---|---|---|
欠陥 |
|
|
課題 |
|
|
...
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 インターフェイスで使用できます。
Note title 1 つのテストケースを 1 つの VersionOne ストーリーに関連付ける VersionOne の制限により、VersionOne ではテストケースを 1 つのストーリーにのみ割り当てることができます。テストケースに複数のストーリー ID を指定する
@req
アノテーションが含まれている場合、テストケースは最初にリストされたストーリーにのみ関連付けられ、後続のストーリー ID はすべて無視されます。以下の例では、テストケースは VersionOne のストーリー S-012 にのみ関連付けられます。Code Block /** * @req S-012, D-131 * @req B-991 */
- CI プロセスの一部としてテストを実行します。ツールのデスクトップからテストを手動で実行することもできます。
- テスト実行の一環として、C/C++test はフィルターとビルド ID でテスト結果をタグ付けし、データを DTP に送信します。DTP ダッシュボードに Test Widgets を追加し、フィルターとビルド 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 プロジェクトの結果を送信する」を参照)。
また、DTP REST API エンドポイントに POST リクエストを手動で送信して、DTP データベースから VersionOne に結果を送信することもできます。API 呼び出しの DTP フィルターとビルド ID を URL パラメーターとして渡します。No Format 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 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 へのテスト結果の送信に関する進捗情報が含まれています。
...
No Format |
---|
{ "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 に送信されます。結果として、VersionOne ID に一致するアノテーションを含むすべての DTP プロジェクトで収集されたテストを含むよう、作業アイテムが更新されます。ただし、特定のプロジェクトのデータだけを送信するよう、フローを設定することもできます。 作業アイテムが更新されます。ただし、特定のプロジェクトのデータだけを送信するよう、フローを設定することもできます。
- Extension Designer を開き、Sending Test Data がデプロイされたサービスを開きます。
- ワークスペースに新しいスイッチ ノードをドラッグします。
- "DataCollectorProcessedEvent" ノードと "Is dynamic analysis" ノードの間の接続線を選択して削除します。
- "DataCollectorProcessedEvent" ノードからスイッチ ノード、またスイッチ ノードから "Is dynamic analysis" ノードに新しい接続をドラッグします。
ノードをダブルクリックし、Property フィールドに次の文字列を指定します。
No Format event.message.resultsSession.project
- 文字列フィールドに DTP プロジェクトの名前を指定します。
- (任意) ノードのわかりやすい名前を指定します。
- [終了] をクリックしてノードの設定を終了し、[デプロイ] をクリックします。
フローを実行すると、指定した DTP プロジェクトのテスト結果だけが VersionOne に送信されます。
...
VersionOne での結果の表示
テスト データが DTP から正常に送信されると、VersionOne で結果を表示できるようになります。
...
結果をさらに展開して、DTP での作業アイテムについての詳細情報を確認できます。これには、ビルドおよび作成者情報のほか、DTP のテスト/違反へのリンクが含まれます。
...
Traceability Report の表示
ご使用のシステムに External System Traceability Report がデプロイされている場合 (「 Enabling the Traceability Report の有効化」を参照)、ウィジェットをダッシュボードに追加して、作業アイテムからプロジェクトのテスト/静的解析/コードレビューまでのトレーサビリティをモニタリングできます。ウィジェットから、さらに詳細な情報を含むレポートを表示できます。
...
- レポートの [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 の作業アイテムに関係する変更レビュー関連の情報を表示します。
...
Pie ウィジェットのセクションをクリックすると、ウィジェットで選択した品質アクティビティ タイプだけを含むレポートが表示されます。[Show files/reviews] オプションを無効にして、レポートの [Files] 列と [Reviews] 列を非表示にすることもできます。[Files] 列と [Reviews] 列にデータがあるのは、要件がソース ファイルにマッピングされている場合だけです (「Enabling the Requirements Traceability Report の有効化」を参照)。この画面で [Files] 列および [Reviews] 列を無効にすると、関連するタブが Requirement Details レポート で非表示になります。
...
このタブにデータがあるのは、要件がソース ファイルにマッピングされている場合だけです (「Enabling the Requirements Traceability Report の有効化」を参照)。要件をソース ファイルにマッピングしなかった場合は、メインの Traceability レポート ページで [ファイル/レビューを表示] オプションを無効にし、詳細レポートを再読み込みすることで、このタブを非表示にできます。
...
このタブにデータがあるのは、要件がソース ファイルにマッピングされている場合だけです (「Enabling the Requirements Traceability Report の有効化」を参照)。要件をソース ファイルにマッピングしなかった場合は、メインの Traceability レポート ページで [ファイル/レビューを表示] オプションを無効にし、詳細レポートを再読み込みすることで、このタブを非表示にできます。
...