このセクションの内容:

はじめに

Jama Connect は、要件を管理するための一般的なブラウザー ベースのプラットフォームです。Parasoft DTP は Jama Connect と統合し、以下の機能を提供します。

• Parasoft プロジェクトと Jama Connect プロジェクトの関連付け
• Jama Connect へのテスト データの送信
• Parasoft から JamaConnect のトレーサビリティ レポート

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

要件

次の要件は、テスト結果を Jama Connect に送信する場合にのみ適用されます。

• 次の Parasoft ツールが実行するテストがサポートされていること:
  • C/C++test Professional、dotTEST、Jtest 10.4.3 以降
  • Selenic 2020.1 以降
  • SOAtest 9.10.8 以降
• Jama Connect で要件を作成済みである必要があります。 
• Jama Connect プロジェクトは、Set of Test Cases アイテム タイプを含むように構成する必要があります。 

設定

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

DTP を Jama Connect に接続する

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

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

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

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

プロジェクトの関連付けを削除するには、ゴミ箱のアイコンをクリックします。プロジェクトの関連付けを削除しても、DTP のエクスプローラー ビューから Jama Connect の欠陥へのリンクは削除されません。関連付けを削除してから再作成すると、違反と Jama Connect の課題との既存リンクが再び有効になります。 

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

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

Requirements Traceability Report の有効化

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

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

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 Jama Connect」で説明されているように、DTP が Jama Connect に接続されていることを確認します。

Traceability Pack をインストールする

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

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

Traceability Report をデプロイする

Traceability Pack をインストールした後、レポート コンポーネントを DTP 環境にデプロイします。 

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

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

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

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

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

詳細設定

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

jama.item.types.to.skip=BUG;SET;TXT;FLD;TC;LTC;HTC;VALTC

jama.sync.testcase.relationship.type=Verified By

jama.testcase.relationship.types=Verified by;Validated by

jama.testcase.types=TC;LTC;HTC;VALTC

使用方法

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

Jama Connect でのバグとタスクの手動作成

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

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

Jama Connect へのテスト データの送信 

次の図は、Jama Connect 環境に Parasoft DTP および Parasoft テスト実行ツールを統合するための自動インフラストラクチャの実装方法を示しています。

1. Parasoft ツールによって実行されるテストに関連付けることができる要件を Jama Connect で作成します。 

2. テスト ファイルで、次のアノテーション形式を使用して、Jama Connect システム要件 ID をテストにマッピングします。
   

   * The following annotation maps the test to a requirement:
   * @req <Jama System Requirement ID> 
   @TEST
   ...

   
   

   • @test <Jama Test ID> アノテーションを使用して、テストを Jama のテスト定義に関連付けます。@test を使用する場合は、Parasoft DTP から Jama に送信する予定の実行ステータスのテストに、テストケースのステップが定義されていないことを確認してください。Parasoft DTP は、ステップが定義されているテストケースのテストケース実行を更新できません。

   • @req <Jama Story ID> アノテーションを使用して、テストを Jama のストーリーに関連付けます。@req を使用するときは、結果を送信する予定の Jama プロジェクトで次の関係タイプが定義されていることを確認してください。"verified by"。このような関係は、Parasoft DTP が Jama でテストケースを作成し、それを Jama の要件に関連付けるときに必要になります。

   テストにアノテーションを付けると、DTP レポートで視覚化できるように、テストが Jama Connect のエンティティにリンクされます。アノテーションは、Parasoft 言語ツール (C/C++test、dotTEST、Jtest) の単体テスト ファイルに追加されます。SOAtest で実行される機能テストの場合、アノテーションは .tst ファイルに追加されます。アノテーションの追加方法の詳細については、ご使用のツールのドキュメントを参照してください。UI で生成された ID ではなく、Jama Connect URL からの ID を使用する必要があります。

     
3. CI プロセスの一部としてテストを実行します。IDE からテストを手動で実行することもできます。
4. テスト実行の一環として、Parasoft テスト実行ツールはフィルターとビルド ID でテスト結果をタグ付けし、データを DTP に送信します。DTP ダッシュボードに テスト ウィジェット を追加し、フィルターとビルド ID を設定することにより、DTP で結果を確認できます。開発者は、テスト実行データを DTP から IDE にダウンロードして、失敗したテストに対処できます。
   

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

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

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

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

   パラメーター	値	説明	必須
   filterId	integer	テスト データを含むフィルター IDを指定します。フィルター ID は整数値です。フィルター名と混同しないでください。	Required (必須)
   buildId	string	テスト データを含むビルド ID を指定します。	Required (必須)
   groupResultsBySOAtestTST	boolean	true に設定すると、SOAtest の結果が .tst ファイルでグループ化されます。その結果、1 つの .tst ファイルが 1 つの Jama テストに関連付けられます。 false に設定すると、SOAtest.tst 内の各テストステップが Jama テストに関連付けられます。 デフォルトは false です。	任意
   testCaseSetId	テストケース セットの ID	Jama にテストケース定義がない場合、Parasoft DTP が新しいテストケース定義を作成する Jama のテストケース セットのIDを指定します。テストケース定義が Jama で見つかった場合、この testCaseSetId であろうとなかろうと、テストケース定義は単に更新されるだけで、この特定のテストケース セットに移動されるわけではありません。  testCaseSetId パラメーターの値は、Jama の "Set of Test Cases" アイテム タイプの ID でなければなりません (「Requirements」を参照)。UI で生成された ID ではなく、Jama Connect URL からの ID を使用する必要があります。プロジェクト ツリーのテスト ケース ノードをクリックした後、URL から ID を取得できます。	任意

   
   テスト ケース セットは、DTP が必要に応じて新しいテスト ケースを作成できるアイテムです。次のステップで説明するように、同等のテスト ケースが存在しない場合、DTP は Jama Connect に結果を送信するときに新しいテスト ケースを作成します。  
   

6. DTP は、filterId パラメーターと buildId パラメーターに一致するテスト結果を見つけ、そのデータを Jama Connect のシステム要件に送信します。 
   • DTPは @req <ID> で結果を検索すると、Jama Connect で一致するアイテムを検索します。一致が見つかった場合、アイテムに関連付けられたテスト ケースにテスト実行が追加されます。要件 ID に一致するテスト ケースがない場合は、テスト ケースが作成されてテスト実行が追加されます。
   • external-app-sync.log ファイルも <DTP_INSTALL>/logs ディレクトリに書き込まれます。このログ ファイルには、DTP から Jama Connect へのテスト結果の送信に関する進捗情報が含まれています。 

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

{
   "createdTestSession": "DTPP-521",
    "created": [
        "DTPP-519, testName = testBagSumAdd"
    ],
    "updated": [
        "DTPP-519, testName = testBagSumAdd",
        "DTPP-518, testName = testBagSimpleAdd"
    ],
    "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 プロジェクトのデータが Jama Connect に送信されます。結果として、Jama Connect ID に一致するアノテーションを持つすべての DTP プロジェクトで収集されたテストを含むよう、作業アイテムが更新されます。ただし、特定のプロジェクトのデータだけを送信するよう、フローを設定することもできます。 

1. Extension Designer を開き、Sending Test Data がデプロイされたサービスを開きます。
2. ワークスペースに新しいスイッチ ノードをドラッグします。
   
3. "DataCollectorProcessedEvent" ノードと "Is dynamic analysis" ノードの間の接続線を選択して削除します。
4. "DataCollectorProcessedEvent" ノードからスイッチ ノード、またスイッチ ノードから "Is dynamic analysis" ノードに新しい接続をドラッグします。
    

5. ノードをダブルクリックし、Property フィールドに次の文字列を指定します。

    event.message.resultsSession.project

6. 文字列フィールドに DTP プロジェクトの名前を指定します。
7. (任意) ノードのわかりやすい名前を指定します。
   
8. [終了] をクリックしてノードの設定を終了し、[デプロイ] をクリックします。

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

Jama Connect での結果の表示

テスト データを送信した後、Jama Connect で結果を表示できます。次の画像は、Jama Connect のいくつかのテスト ケースを含む一連のテスト ケースを示しています。 

個々のテスト ケースについて、テスト実行などの詳細情報をさらに確認できます。

テスト実行をクリックして実行の詳細を表示します。

Traceability Report の表示

ご使用のシステムに External System Traceability Report がデプロイされている場合 (「 Enabling the Requirements Traceability Report」を参照)、ウィジェットをダッシュボードに追加して、要件からプロジェクトのテスト/静的解析/コードレビューまでのトレーサビリティをモニタリングできます。ウィジェットから、さらに詳細な情報を含むレポートを表示できます。DTP のウィジェットとレポートでテストと Jama Connect アイテム間のトレーサビリティ情報を表示するには、上記のテスト実行およびレポート ワークフローのステップ 2 で説明されているように、テストを Jama Connect アイテムに関連付ける必要があります。

DTP のトレーサビリティ ウィジェットとレポートには、次のタイプの Jama Connect エンティティを除き、要件と見なされる可能性のある指定された Jama Connect プロジェクト内のすべてのアイテムが含まれます。

• defects
• test cases
• sets
• folders
• text items

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

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

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

Requirements Widget

このウィジェットには、指定された Jama Connect プロジェクトの要件の数が表示されます。 

ウィジェットをクリックすると、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 とは

このレポートは、Jama Connect プロジェクトの要件とそれに関連するデータを表示します。

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

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

Requirement Traceability Report by Type

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

Requirement Details Report とは

Jama Connect Requirement Details レポートは、特定の Jama Connect 要件に関連したファイル、静的解析の指摘事項、およびテストについての情報を表示します。このレポートは、Jama Connect Requirement Traceability レポートで要件をクリックすることで表示されます。

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

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

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

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

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

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

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