この設定は、Parasoft 管理者が一度だけ行う必要があります。
このセクションの内容:
DTP と Codebeamer ALM サーバーの接続
- 設定メニュー (歯車のアイコン) から [Report Center 設定] を選択します。
- [External System] を選択して [設定の編集] をクリックし、[システム タイプ] メニューから Codebeamer を選択します。
- [Enabled] オプションを有効化します。
- [名前] フィールドに Codebeamer ALM のインスタンス名を入力します。名前は必須ですが、接続設定に影響したり、他のインターフェイスで表示されたりすることはありません。
- [アプリケーション URL] フィールドに Codebeamer サーバーの URL を入力します。URL には、プロトコル、ホスト、およびポート番号を含める必要があります。パスまたはパラメーターは含めないでください。
- [表示 URL] フィールドは、Codebeamer システムへのリンクが Web ブラウザーに表示されるときに Parasoft DTP ページに表示される URL を定義します。通常、これは上記のアプリケーション URL フィールドと同じである必要があります。ただし、たとえば、リバース プロキシ環境で作業していて、Parasoft DTP を使用するユーザーのローカル Web ブラウザーから Codebeamer へのリンクが Parasoft DTP サーバーとは異なる場合は、違うことがあります。
- [Username] および [Password/API tokens] フィールドにログイン認証情報を入力します。ログインには、[プロジェクトの関連付け] セクションで指定された Codebeamer プロジェクトで課題を作成するのに十分な権限が必要です。
- [接続のテスト] をクリックして設定を確認し、[確認] をクリックします。
Parasoft プロジェクトと Codebeamer ALM プロジェクトの関連付け
Parasoft プロジェクトと Codebeamer プロジェクトを関連付けると、違反エクスプローラーまたはテスト エクスプローラー ビューから欠陥を作成し、Codebeamer の適切なプロジェクトにリンクすることができます。Sending Test Data to External System フロー を使用する場合、関連付けも重要です。DTP の複数のプロジェクトを 1 つの Codebeamer プロジェクトと関連付けることはできますが、同じ DTP プロジェクトを複数の Codebeamer プロジェクトと関連付けることはできません。
- [プロジェクトの関連付けを作成] をクリックし、[DTP プロジェクト] メニューからプロジェクトを選択します。
- [外部プロジェクト] フィールドに Codebeamer プロジェクトの名前を入力して [Create] をクリックし、関連付けを保存します。
プロジェクトの関連付けを削除するには、ゴミ箱のアイコンをクリックします。プロジェクトの関連付けを削除しても、DTP のエクスプローラー ビューから Codebeamer の欠陥へのリンクは削除されません。関連付けを削除してから再作成すると、違反と Codebeamer の課題との既存リンクが再び有効になります。
DTP と Codebeamer プロジェクトの既存の関連付けの設定を変更できます。
- 鉛筆アイコンをクリックし、メニューから別の DTP プロジェクトを選択するか、[外部プロジェクト] フィールドに別の Codebeamer プロジェクトの名前を指定します。
- [保存] をクリックします。
詳細設定
<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 パス接頭辞は通常 デフォルト:
|
|---|---|
| codeBeamerIssueUrl | DTP の違反エクスプローラーとテスト エクスプローラーで作成された作業アイテムを Codebeamer の作業アイテムにリンクするための URL テンプレートを指定します。 デフォルト:
|
| codeBeamer.import.chunkSize | 1 回の実行で Codebeamer に送信するテスト ケースの結果の最大数を指定します。 デフォルト:
|
| codeBeamer.tracker.requirements | 要件を含む Codebeamer のトラッカーの名前を指定します。これにより、Codebeamer で構成したカスタムの要件トラッカーを DTP でのテスト結果に関連付けることができます。このトラッカーは、Traceability レポートに表示する要件も決定します。 デフォルト:
"Information" および "Folder" 要件タイプは DTP レポートで無視されます。 注意: この設定はデフォルトでグローバルですが、設定の最後に Codebeamer プロジェクトの名前を追加することで、特定の Codebeamer プロジェクトに使用できます。プロジェクト名にスペースが含まれている場合は、以下の 2 番目の例に示すように、スペースの代わりに文字シーケンス
上記の例では、"Project1"と "Project 1" は Codebeamer プロジェクト名であるため、これらの設定はそれらの Codebeamer プロジェクトにのみ適用されます。異なる名前を使用して、複数のプロジェクト固有のこの設定を定義できます。プロジェクト固有の設定は、グローバル設定よりも優先されます。 |
| codeBeamer.tracker.tests | Parasoft DTP のテスト結果に関連付けるテストケースを含む Codebeamer のトラッカー名を指定します。複数のテストトラッカーを指定する場合はセミコロン (;) で区切ります。 デフォルト:
例:
この設定は、以下の Parasoft DTP の機能が Codebeamer 内のテストケースを検索するために使用します。
注意: この設定はデフォルトでグローバルですが、設定の最後に Codebeamer プロジェクトの名前を追加することで、特定の Codebeamer プロジェクトに使用できます。プロジェクト名にスペースが含まれている場合は、以下の 2 番目の例に示すように、スペースの代わりに文字シーケンス
上記の例では、"Project1"と "Project 1" は Codebeamer プロジェクト名であるため、これらの設定はそれらの Codebeamer プロジェクトにのみ適用されます。異なる名前を使用して、複数のプロジェクト固有のこの設定を定義できます。プロジェクト固有の設定は、グローバル設定よりも優先されます。 Codebeamer 構成についての注意： Parasoft のテストに |
| codeBeamer.tracker.testRuns | Codebeamer にテスト結果を送信するときに DTP がテスト実行を作成する Codebeamer のテスト実行トラッカー名を指定します。この設定は、/syncTestCases API を使用して DTP から Codebeamer にテスト結果を送信する際に使用されます。 典型的な使用例: 単一のテスト実行トラッカー ほとんどの場合、Codebeamer のテスト実行トラッカーは 1 つだけなので、この設定は空白のままにしておくことができます。これがデフォルトです。この設定を空にすると、DTP は Codebeamer の最初の (この場合、唯一の) テスト実行トラッカーにテスト実行を作成します。 高度な使用例: 複数のテスト実行トラッカー Codebeamer プロジェクトに複数のテスト実行トラッカーがあり、そこに DTP のテスト実行を挿入したい場合、この設定で定義することができます。複数のテスト実行トラッカーを指定する場合はセミコロン (;) で区切ります。 例:
複数のテスト実行トラッカーを定義すると、特定のプロジェクトの Codebeamer テストケース トラッカー (上記の codeBeamer.tracker.tests を参照) とテスト実行トラッカーの間のマッピングを指定し、テスト実行の作成場所を制御できます。たとえば、次の設定を行なったとします。
この状態で、DTP が /sendTestCases API を実行し、DTP の特定のテストケースに対して Codebeamer のテストケース (たとえば もし DTP が 注意: この設定はデフォルトでグローバルですが、設定の最後に Codebeamer プロジェクトの名前を追加することで、特定の Codebeamer プロジェクトに使用できます。プロジェクト名にスペースが含まれている場合は、以下の 2 番目の例に示すように、スペースの代わりに文字シーケンス
上記の例では、"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.task | DTP の違反エクスプローラーとテスト エクスプローラーから新しいタスクを作成するときに Codebeamer で作成する作業アイテム タイプを指定します。これにより、Codebeamer で構成したカスタムのタスク トラッカーを DTP から作成された作業アイテムに関連付けることができます。 デフォルトでは、このプロパティは設定されていません。その結果、DTP で作成されたタスク作業アイテムは、Codebeamer のタスク作業アイテムに関連付けられます。 |
