本項目では、C++test の CUI で解析時に、DTP Standard と連携するための設定を説明します。
CUI で解析する場合、.properties ファイルに解析対象毎の設定を記述し、プロジェクト毎に読み込むファイル(設定値)を切り替える方法を推奨します。.properties に設定する DTP Standard 連携向けの設定は以下の通りです。
セッションタグ、ビルド ID の概念については、3.1 解析結果の収集に関する概念 を参照ください。
【設定項目】
プロパティ設定 |
設定値 |
例 |
dtp.enabled |
true / false |
true |
dtp.server |
DTP のホスト名 |
localhost |
dtp.port |
DTP のポート番号 |
8443 |
dtp.user |
DTP のログインユーザ |
userA |
dtp.password |
パスワード |
userA |
dtp.project |
DTP のプロジェクト |
Code Parser |
build.id |
任意のビルド ID |
${hash} (※１) |
report.dtp.publish |
true / false |
True |
report.coverage.images |
任意のカバレッジタグ |
${dtp_project};UnitTest |
report.scontrol (※2) |
min / full |
Min |
session.tag (※２) |
任意のセッションタグ |
${project_module}_${scontrol_branch} |
(※１) Git 連携している場合の具体的な設定方法例を以下に記します。
Git のコミットハッシュ値を取得して、環境変数「hash」に設定する一連の手順となります。
- Windows でコマンドラインから設定する場合
- pushd ＜git リポジトリ＞
- for /f "usebackq" %a in (`git rev-parse HEAD`) do set hash=%a
- popd
- Linux でコマンドラインから設定する場合
$ pushd ＜git リポジトリ＞
$ export hash=`git rev-parse HEAD`
$ popd
(※２)report.scontrol, session.tag の設定には、dtp.additional.settings 接頭辞が必要となります。改行コード(\r\n)は、Linux の場合(\n)に読み替えて設定をしてください。
例) dtp.additional.settings=session.tag\=${project_module}_${scontrol_branch}\r\nreport.scontrol\=min
(※3)"dtp_project"、"project_module"、"scontrol_branch"は C++test で使用可能な変数です。タグ名として設定する際の一例としてご参考ください。
"dtp_project"は設定ファイルの「dtp.project」オプションで設定したプロジェクト名。"project_module"はテスト対象プロジェクトのモジュール名。 "scontrol_branch"は構成管理システムと連携している場合のブランチ名。
にそれぞれ該当します。