このセクションの内容:
Azure DevOps は、Microsoft の SaaS (Software as a service) プラットフォームであり、ソフトウェアの開発・デプロイのためのエンドツーエンドの DevOps プログラミング ツールを提供します。DTP を Azure DevOps Server Express および Azure DevOps Server に接続することで、以下の機能が提供されます。
この設定は、Parasoft 管理者が一度だけ行う必要があります。
Azure DevOps (https://dev.azure.com/{yourorganization} ) で自分の組織にサインインします。
ホームページからユーザー設定を開き、[Personal Access Tokens] を選択します。
このトークンのスコープを選択して、特定のタスクを承認します。
個人用アクセス トークンが作成されると、Azure DevOps での認証にユーザー資格情報が必要な場所ならどこでも使用できます。
Azure DevOps に保存された要件と、Parasoft ツール (C/C++test、dotTEST、Jtest) から DTP に送信されたテスト データ、静的解析データ、ビルド レビュー データとの間のトレーサビリティを実証するのに役立つウィジェットとレポートを生成するように、DTP を構成できます。
Traceability Report にコード レビューと静的解析情報を含める場合は、ソース コード ファイルを Azure DevOps の要件に関連付ける必要があります。このオプション機能を有効にする手順については 「要件とファイルの関連付け」を参照してください。
Traceability Pack に同梱されている External System Traceability Report アーティファクトをデプロイすることで、トレーサビリティを表示および追跡する DTP インターフェイスが有効になります。Traceability Pack には、トレーサビリティ ワークフローの一部を自動化する Sending Test Data to External System フローも含まれています。
DTP Extension Designer を使用して、External System Traceability Report および Sending Test Data to External System フローを環境にデプロイします。アーティファクトを展開する前に、「DTP を Azrue DevOps に接続する」で説明されているように、DTP が Azure DevOps に接続されていることを確認します。
最初のステップは、 Traceability Pack アーティファクトをインストールすることです。このアーティファクトは、トレーサビリティを可能にする構成ファイルとアセットの集合です。
<DTP_DATA_DIR>/conf ディレクトリにある ExternalSystemSettings.properties 構成ファイルを変更して、統合のデフォルトの動作を変更できます。すぐに利用できる DTP と Azure DevOps の統合は、デフォルトまたは一般的に使用されるフィールドと作業アイテム タイプを使用するように構成されています。ただし、Azure DevOps システムをカスタマイズしている場合は、次の設定を行って、DTP のデータをカスタム構成に合わせることができます。
| azuredevops.workItem.url | AzureDevOps の特定の項目への URL テンプレートを指定します。 デフォルト:
|
|---|---|
azuredevops.workItemType.requirements | DTP トレーサビリティ レポート、Parasoft C/C++ および SOAtest の [要件] ビュー、およびテストケースの同期処理で要件として扱われる Azure DevOps の作業項目タイプのリストを指定します。名前はセミコロン (;) で区切ります。 デフォルト:
|
2021.2 以前のバージョンから Parasoft DTP をアップグレードした場合、これらの Azure DevOps パラメーターが ExternalSystemSettings.properties ファイルにない可能性があります。その場合、上記の表にあるデフォルト値が使用されます。これらのパラメーターを変更するには、必ずパラメーターを ExternalSystemSettings.properties ファイルに追加してください。 |
次の要件は、テスト結果を Azure DevOps に送信する場合にのみ適用されます。
Azure DevOps との統合を設定した後、開発者、テスター、およびその他のユーザーは、統合によって実現される機能を活用できます。
テスト エクスプローラーと違反エクスプローラーを使用すると、ステータスに関係なく、テストと違反に対してそれぞれ課題と欠陥を作成できます。テスト エクスプローラーまたは違反エクスプローラーで Azure DevOps アセットを作成する方法については、以下のセクションを参照してください。
次の図は、Azure DevOps 環境に Parasoft DTP および Parasoft テスト実行ツールを統合するための自動インフラストラクチャの実装方法を示しています。
Azure ユーザー設定要件：Parasoft DTP がテスト結果を Azure DevOps に送信できるようにするには、ユーザー アクセス レベルに Azure DevOps の「テスト計画」を含める必要があります。この設定は、Parasoft DTP がテスト結果を Azure DevOps に送信する際にテスト計画を作成するために必要です。
ローカル版の Azure DevOps でテスト計画を設定するには、次のことを行う必要があります。
Azure DevOps でクラウド用のテスト計画を設定するには、次のことを行う必要があります。
|
テスト データを Azure DevOps に送信するには：
テストファイルで、以下のアノテーション形式を使用して、Azure DevOps システムの要件 ID をテストにマッピングします。
Azure DevOps でトレーサビリティ結果を見るために独自のテストケース定義を作成していないユーザーの場合は、@req を使用します。
|
Parasoft で @req を使用し、Parasoft DTP から Azure DevOps への結果の送信をトリガーします。
Azure DevOps で独自のテストケース定義を作成したユーザーには、@test を使用します。
* 次のアノテーションは、テストを要件にマッピングします。*@test <<Azure DevOps ID> > @TEST... |
各テストケース定義を、Azure DevOps でテストした要件に関連付けます。
@test <Azure DevOps ID> アノテーションを使用して、テストを Azure DevOps のテスト定義に関連付けます。@test を使用する場合は、Parasoft DTP から Azure DevOps に送信する予定の実行ステータスのテストに、テストケースのステップが定義されていないことを確認してください。Parasoft DTP は、ステップが定義されているテストケースのテストケース実行を更新できません。
Sending Test Data to External System フローをデプロイした場合 (「Sending Test Data to External System フローのデプロイ」を参照)、Data Collector が Parasoft ツールからデータを受信すると、単体テストと機能テストの結果が Azure DevOps に自動的に送信されます。デフォルトでは、フローは Data Collector が受信した任意のプロジェクトの単体テストおよび機能テストの結果をフォワードしますが、特定のプロジェクトのデータだけを送信するようフローを設定できます (「Sending Results from a Specific DTP Project」を参照)。
また、DTP REST API エンドポイントに POST リクエストを手動で送信して、DTP データベースから Azure DevOps に結果を送信することもできます。API 呼び出しの URL パラメーターとして、DTP フィルターとビルドの ID、および一連の Azure DevOps テスト ケースの ID を渡します。
curl -X POST -u <username>:<password> "http://<host>:<port>/grs/api/v1.7/linkedApps/configurations/1/syncTestCases?filterId=<filterID>&buildId=<buildID>&testCaseSetId=<Azure DevOps_TEST_CASE_SET_ID>" |
フィルター ID とビルド ID は、テスト エクスプローラーの URL で確認できます。
次の表で、エンドポイント パラメーターについて説明します。
| パラメーター | 値 | 説明 | 必須 |
|---|---|---|---|
filterId | integer | テスト データを含むフィルター IDを指定します。フィルター ID は整数値です。フィルター名と混同しないでください。 | Required (必須) |
buildId | string | テスト データを含むビルド ID を指定します。 | Required (必須) |
| boolean |
デフォルトは | 任意 |
testCaseSetId | テストケース セットの ID | Azure DevOps にテストケース定義がない場合、Parasoft DTP が新しいテストケース定義を作成する Azure DevOps のテストケース セットの ID を指定します。テストケース定義が Azure DevOps で見つかった場合、この testCaseSetId パラメーターの値は、Azure DevOps の "Set of Test Cases" アイテム タイプの ID でなければなりません (「要件」を参照)。UI で生成された ID ではなく、Azure DevOps URL からの ID を使用する必要があります。プロジェクト ツリーのテスト ケース ノードをクリックした後、URL から ID を取得できます。 | 任意 |
テスト ケース セットは、DTP が必要に応じて新しいテスト ケースを作成できるアイテムです。次のステップで説明するように、同等のテスト ケースが存在しない場合、DTP は Azure DevOps に結果を送信するときに新しいテスト ケースを作成します。
filterId パラメーターと buildId パラメーターに一致するテスト結果を見つけ、そのデータを Azure DevOps のシステム要件に送信します。external-app-sync.log ファイルも <DTP_INSTALL>/logs ディレクトリに書き込まれます。このログ ファイルには、DTP から Azure DevOps へのテスト結果の送信に関する進捗情報が含まれています。
DTP がレポートを処理し、結果を Azure DevOps に送信した後、以下のような応答があります。
{ "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 プロジェクトのデータが Azure DevOps に送信されます。結果として、Azure DevOps ID に一致するアノテーションを持つすべての DTP プロジェクトで収集されたテストを含むよう、作業アイテムが更新されます。ただし、特定のプロジェクトのデータだけを送信するよう、フローを設定することもできます。
ノードをダブルクリックし、Property フィールドに次の文字列を指定します。
event.message.resultsSession.project |
フローを実行すると、指定した DTP プロジェクトのテスト結果だけが Azure DevOps に送信されます。
テスト データを送信した後、Azure DevOps で結果を表示できます。次の画像は、Azure DevOps の System Requirement Specifications の要件を示しています。要件にいくつかのテスト ケースがあります。
個々のテスト ケースについて、テスト実行などの詳細情報をさらに確認できます。
ご使用のシステムに External System Traceability Report がデプロイされている場合 (「 Enabling the Requirements Traceability Report」を参照)、ウィジェットをダッシュボードに追加して、Azure DevOps の要件からプロジェクトの Parasoft DTP テスト/静的解析/コードレビューまでのトレーサビリティをモニタリングできます。ウィジェットから、さらに詳細な情報を含むレポートを表示できます。
DTP ダッシュボード追加されたウィジェットは、個別のトレーサビリティ カテゴリに表示されます。ウィジェットを追加する方法については「ウィジェットの追加」を参照してください。
以下の設定を行うことができます。
| タイトル | デフォルトのタイトルの代わりにダッシュボードに表示する新しいタイトルを入力できます。 |
|---|---|
| フィルター | [ダッシュボード設定] を選択してダッシュボード フィルターを使用するか、ドロップダウン メニューからフィルターを選択します。フィルタの詳細については「フィルタの作成と管理」を参照してください。 |
| ターゲット ビルド | テストとコード解析を実行したビルド ID に設定する必要があります。ダッシュボード設定で指定されたビルド、最新ビルド、またはドロップダウン メニューで選択したビルドを使用できます。「ダッシュボードの設定」も参照してください。 |
| Azure DevOps プロジェクト | ドロップダウン メニューから Azure DevOps プロジェクトを選択します。 |
このウィジェットには、指定された Azure DevOps プロジェクトの要件の数が表示されます。
ウィジェットをクリックすると、Requirement Traceability レポートが表示されます。
このウィジェットは、プロジェクトのすべての要件に対する、テストでカバーされた要件の割合を示します。
ウィジェットの中央をクリックすると、Requirement Traceability レポートが表示されます。
色付きのセグメントは、テストの対象となる要件を表しています。ウィジェットをクリックすると、With Tests カテゴリにフィルタリングされた Requirement Traceability レポート が表示されます。
単体テスト、機能テスト、静的解析、およびピア レビューは、要件が適切かつ徹底的に実装されているかを検証するための一般的なアクティビティです。このウィジェットは、それらのソフトウェア品質アクティビティのコンテキストにおけるプロジェクト要件の全般的なステータスを表示します。品質アクティビティの種類 (テスト、静的解析違反、レビュー) ごとにウィジェットを追加して、プロジェクトの要件実装の進捗をモニタリングすることができます。
グラフ上のセクションにマウス ポインタを置くと、品質アクティビティ タイプのステータスについて詳細情報が表示されます。ウィジェットをクリックすると、選択したタイプでフィルタリングされた Requirement Traceability レポートが表示されます。
このレポートは、Azure DevOps 要件とそれに関連する Parasoft DTP テストを表示します。
以下の操作を行うことができます。
Azure DevOps Requirements - Pie ウィジェットのセクションをクリックすると、ウィジェットで選択した品質アクティビティ タイプだけを含むレポートが表示されます。ドロップダウン メニューを使ってタイプとステータスを切り替えることができます。[Show files/reviews] オプションを無効にして、レポートの [Files] 列と [Reviews] 列を非表示にすることもできます。[Files] 列と [Reviews] 列にデータがあるのは、要件がソース ファイルにマッピングされている場合だけです (「Requirements Traceability レポート」を参照)。この画面で [Files] 列および [Reviews] 列を無効にすると、関連するタブが Requirement Details レポート で非表示になります。
Azure DevOps Requirement Details レポートは、特定の Azure DevOps 要件に関連したファイル、静的解析の指摘事項、およびテストについての情報を表示します。このレポートは、Azure DevOps Requirement Traceability レポートで要件をクリックすることで表示されます。
最初のタブには、作業アイテムを検証するために実行されたテストの結果が表示されます。
[View results in Test Explorer] リンクをクリックすると、作業アイテムに関連付けられたすべてのテストをテスト エクスプローラーで参照できます。
テーブルの個々のテスト名をクリックし、テスト エクスプローラーで個々のテストを参照することもできます。
2 番目のタブには、要件に関連付けられたファイルと、ファイルで検出された静的解析違反が表示されます。[違反] 列のリンクをクリックして、 違反エクスプローラー で違反を確認できます。違反に関する詳細が表示されます。
このタブにデータがあるのは、要件がソース ファイルにマッピングされている場合だけです (「Enabling the Requirements Traceability Report」を参照)。要件をソース ファイルにマッピングしなかった場合は、メインの Traceability レポート ページで [ファイル/レビューを表示] オプションを無効にし、詳細レポートを再読み込みすることで、このタブを非表示にできます。
ファイルに変更レビューまたはレビュー指摘事項が含まれる場合、それらは 3 番目のタブに表示されます。リンクをクリックすると、変更エクスプローラー で確認できます。
このタブにデータがあるのは、要件がソース ファイルにマッピングされている場合だけです (「Enabling the Requirements Traceability Report」を参照)。要件をソース ファイルにマッピングしなかった場合は、メインの Traceability レポート ページで [ファイル/レビューを表示] オプションを無効にし、詳細レポートを再読み込みすることで、このタブを非表示にできます。