この設定は、Parasoft 管理者が一度だけ行う必要があります。

このセクションの内容:

DTP と Codebeamer ALM サーバーの接続

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

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

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

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

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

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

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

詳細設定

<DTP_DATA_DIR>/conf ディレクトリにある ExternalSystemSettings.properties 構成ファイルを変更して、統合のデフォルトの動作を変更できます。すぐに利用できる DTP と Codebeamer の統合は、デフォルトまたは一般的に使用されるフィールドと作業アイテム タイプを使用するように構成されています。ただし、Codebeamer システムをカスタマイズしている場合は、以下で説明する設定を行って、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 と入力する必要があります。

codeBeamer.restApi.path

Codebeamer が公開する REST API へのパス接頭辞を指定します。Codebeamer の新しいバージョンでは、デフォルトの API パス接頭辞は通常 /rest ですが、古いバージョンでは /cb/rest などの他のデフォルト パスが使用されていました。

デフォルト:

codeBeamer.restApi.path=/cb/rest

codeBeamerIssueUrl

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

デフォルト:

codeBeamerIssueUrl=<CODEBEAMER_URL>/issue/<ID>

codeBeamer.import.chunkSize

1 回の実行で Codebeamer に送信するテスト ケースの結果の最大数を指定します。

デフォルト:

codeBeamer.import.chunkSize=1000 

codeBeamer.tracker.requirements

要件を含む Codebeamer のトラッカーの名前を指定します。これにより、Codebeamer で構成したカスタムの要件トラッカーを DTP でのテスト結果に関連付けることができます。このトラッカーは、Traceability レポートに表示する要件も決定します。

デフォルト:

codeBeamer.tracker.requirements=System Requirement Specifications 

"Information" および "Folder" 要件タイプは DTP レポートで無視されます。 

注意: この設定はデフォルトでグローバルですが、設定の最後に Codebeamer プロジェクトの名前を追加することで、特定の Codebeamer プロジェクトに使用できます。プロジェクト名にスペースが含まれている場合は、以下の 2 番目の例に示すように、スペースの代わりに文字シーケンス \u0020 を使用します。

codeBeamer.tracker.requirements.Project1=Project1 Requirements

codeBeamer.tracker.requirements.Project\u00201=Project 1 Requirements

上記の例では、"Project1"と "Project 1" は Codebeamer プロジェクト名であるため、これらの設定はそれらの Codebeamer プロジェクトにのみ適用されます。異なる名前を使用して、複数のプロジェクト固有のこの設定を定義できます。プロジェクト固有の設定は、グローバル設定よりも優先されます。

codeBeamer.tracker.tests

Parasoft DTP のテスト結果に関連付けるテストケースを含む Codebeamer のトラッカー名を指定します。複数のテストトラッカーを指定する場合はセミコロン (;) で区切ります。

デフォルト:

codeBeamer.tracker.tests=Test Cases

例:

codeBeamer.tracker.tests=Test Cases;Integration Tests

この設定は、以下の Parasoft DTP の機能が Codebeamer 内のテストケースを検索するために使用します。

    • DTP から Codebeamer へ /syncTestCases API を使用してテスト結果を送信します。
      • Codebeamer の既存のテスト定義は、Parasoft ツールで定義された @test T_ID を元に検索されます。T_ID が見つからない場合は、無視されます。
      • 既存のテスト定義は、Codebeamer の要件 (Parasoft の @req で検索) に関連して検索されます。
        • 注意: /syncTestCases API は、Codebeamer に特定の Parasoft テスト定義 (@req で注釈された Parasoft テストに対応) が見つからない場合、Codebeamer に新しいテスト定義を作成します。このテスト定義は、codeBeamer.tracker.tests リストで定義された最初のテスト トラッカーに作成されます。
    • C/C++test の [要件] ビューに表示される要件とテストの階層を提供します。

注意: この設定はデフォルトでグローバルですが、設定の最後に Codebeamer プロジェクトの名前を追加することで、特定の Codebeamer プロジェクトに使用できます。プロジェクト名にスペースが含まれている場合は、以下の 2 番目の例に示すように、スペースの代わりに文字シーケンス \u0020 を使用します。

codeBeamer.tracker.tests.Project1=Project1 Test Cases

codeBeamer.tracker.tests.Project\u00201=Project 1 Test Cases

上記の例では、"Project1"と "Project 1" は Codebeamer プロジェクト名であるため、これらの設定はそれらの Codebeamer プロジェクトにのみ適用されます。異なる名前を使用して、複数のプロジェクト固有のこの設定を定義できます。プロジェクト固有の設定は、グローバル設定よりも優先されます。

Codebeamer 構成についての注意

Parasoft のテストに @req アノテーションを付けると、Codebeamer に同等のテストケースが作成され、テストケースと要件の間に Verifies の関係が作成されます。正しく機能するようにするには、Codebeamer 構成のテストケースと要件トラッカーで "Verifies" オプションが有効になっていることを確認してください。

codeBeamer.tracker.testRuns

Codebeamer にテスト結果を送信するときに DTP がテスト実行を作成する Codebeamer のテスト実行トラッカー名を指定します。この設定は、/syncTestCases API を使用して DTP から Codebeamer にテスト結果を送信する際に使用されます。

典型的な使用例: 単一のテスト実行トラッカー

ほとんどの場合、Codebeamer のテスト実行トラッカーは 1 つだけなので、この設定は空白のままにしておくことができます。これがデフォルトです。この設定を空にすると、DTP は Codebeamer の最初の (この場合、唯一の) テスト実行トラッカーにテスト実行を作成します。

高度な使用例: 複数のテスト実行トラッカー

Codebeamer プロジェクトに複数のテスト実行トラッカーがあり、そこに DTP のテスト実行を挿入したい場合、この設定で定義することができます。複数のテスト実行トラッカーを指定する場合はセミコロン (;) で区切ります。

例:

codeBeamer.tracker.testRuns=<TRT1>;<TRT2>;<TRT3>

複数のテスト実行トラッカーを定義すると、特定のプロジェクトの Codebeamer テストケース トラッカー (上記の codeBeamer.tracker.tests を参照) とテスト実行トラッカーの間のマッピングを指定し、テスト実行の作成場所を制御できます。たとえば、次の設定を行なったとします。

codeBeamer.tracker.tests=<TCT1>;<TCT2>;<TCT3>;<TCT4>

codeBeamer.tracker.testRuns=<TRT1>;<TRT2>;<TRT3>

この状態で、DTP が /sendTestCases API を実行し、DTP の特定のテストケースに対して Codebeamer のテストケース (たとえば TCT1) を見つけると、そのテスト実行は対応するテスト実行トラッカー (この場合は TRT1) に作成されることになります。マッピングはそれぞれの設定の位置に基づいているので、この例では、TCT2 は TRT2 に、TCT3TRT3 にマッピングされます。

もし DTP が TCT4 で定義されたテストケースを Codebeamer で見つけた場合、DTP に TRT4 トラッカーが設定されていないため (または DTP に設定されていても Codebeamer に TRT4 が存在しない場合)、テスト実行は TRT1 に作成されます (設定されたテスト実行トラッカーのリストの最初の項目であるため)。

注意: この設定はデフォルトでグローバルですが、設定の最後に Codebeamer プロジェクトの名前を追加することで、特定の Codebeamer プロジェクトに使用できます。プロジェクト名にスペースが含まれている場合は、以下の 2 番目の例に示すように、スペースの代わりに文字シーケンス \u0020 を使用します。

codeBeamer.tracker.testRuns.Project1=Project1 Test Case Runs

codeBeamer.tracker.testRuns.Project\u00201=Project 1 Test Case Runs

上記の例では、"Project1"と "Project 1" は Codebeamer プロジェクト名であるため、これらの設定はそれらの Codebeamer プロジェクトにのみ適用されます。異なる名前を使用して、複数のプロジェクト固有のこの設定を定義できます。プロジェクト固有の設定は、グローバル設定よりも優先されます。

codeBeamer.workItemType.bug.status

DTP の違反エクスプローラーおよびテスト エクスプローラーで作業アイテムを作成するときに Codebeamer で作成されるバグのステータスを指定します。

デフォルト: オープン 

codeBeamer.workItemType.bug

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

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

codeBeamer.workItemType.task.status

DTP の違反エクスプローラーおよびテスト エクスプローラーで作業アイテムを作成するときに Codebeamer で作成されるタスクのステータスを指定します。

デフォルト: オープン 

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

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

  • No labels