レポート設定は、GUI またはコマンドライン インターフェイス (ローカル設定を使用) から指定できます。ローカル レポートの生成に加えて、レポートを Parasoft DTP に送信することもできます。DTP にレポートを送信すると、高度な分析を適用して、テスト対象アプリケーションに関連するリスクを把握し、全般的な開発およびテスト プロセスを理解するのに役立ちます。
このセクションの内容:
GUI からの設定
用意されている GUI コントロールを使用して任意のテストのレポート設定を指定できます。テストはコマンドライン インターフェイスまたは GUI のどちらからでも実行できます。レポート設定を指定する前に、[設定] ウィンドウの以下の設定を参照して、タスクの作成者が正しく計算されるか、結果が適切な Team Server に送信されるか、正しい電子メール ホストを使用しているかなどを確認する必要があります。
GUI で指定した設定は、完全にあるいは部分的にローカル設定によって上書きされることがあります。
GUI からレポート設定を指定するには、以下の操作を行います。
- [Parasoft] > [設定] を選択します。[設定] ダイアログが表示されます。
- [Parasoft] > [レポート] を選択します。
- 設定を適切に指定します。利用できる設定については下記の「Report Configuration Settings」を参照してください。
- 宛先やホスト名などの電子メールの設定を GUI からもコマンドラインからもまだ行っていない場合、[Parasoft] > [E-mail] で設定します。
- [Parasoft] > [レポート] > [E-mail 通知] を選択します。
- 適切な E-mail 通知設定を指定します。次の設定を利用できます。
- レポートを E-mail で送信する: レポートを電子メールで送信するかどうかを指定します。
- E-mail の件名: レポートを含む電子メールの件名を指定します。送信する電子メールの件名を指定します。デフォルトの件名は "[product_name] Report" です。例えば件名を「Functional Testing Report for Project A」に変更するには、「Functional Testing Report for Project A」と入力します。
- マネージャー レポートの送信先: マネージャー レポートの送信先を指定します。1 つのアドレスまたはセミコロンで区切った複数のアドレスを指定できます。
- タスクのないレポートを送信する: レポートされたタスクが 0 件の場合にレポートを送信するかどうかを指定します。1 つのアドレスまたはセミコロンで区切った複数のアドレスを指定できます。
- 開発者レポートの送信先: 開発者レポートの送信先を指定します。1 つのアドレスまたはセミコロンで区切った複数のアドレスを指定できます。
- '不明な' 開発者レポートの送信先: "unknown" に割り当てられたタスク (特定の開発者に関連付けられなかったタスク) の開発者レポートの送信先を指定します。これらのレポートは、1 つのユーザー/アドレスにだけ送信できます。セミコロンで区切った複数のアドレスの指定は有効ではありません。
レポート構成の設定
レポートの内容
| 設定 | 説明 |
|---|---|
| 詳細な開発者レポート | マネージャー向けの概要レポートに加えて、カスタマイズされた詳細なレポートを個々のチーム メンバー向けに生成するかどうかを指定します。開発者レポートには、そのチーム メンバーに割り当てられたタスクだけが含まれます。 |
| 作成者ごとのタスクの概要 | 各開発者に割り当てられたタスクの種類と数の概要をレポートに含めるかどうかを指定します。 |
| チェックされたファイルおよび実行されたテストの概要 | チェックされたファイルおよび実行されたテストに関する情報をレポートに含めるかどうかを指定します。 静的解析の場合、このオプションをオンに設定すると、チェックされたファイルの一覧がレポートに含まれます。ルール違反の数がファイルごとに表示されます。ファイルに違反がある場合、違反の行番号、ルール名、ルール ID も表示されます。 単体テスト実行の場合、このオプションをオンに設定すると、実行されたテスト ケースと結果 (成功または失敗) の一覧がレポートに含まれます。テスト スイートごとに、テスト ケースの総数と成功したテスト ケースの数が表示されます。テスト ケースのタスクがレポートされた場合は、さらに詳細情報 (スタック トレースや結果など) が表示されます。 コード レビューの場合は、作成者 - レビューアー - 監督者間のメッセージがある、ペンディング中のすべての問題 (デフォルトではセッション タグでフィルター) が表示されます。 |
| タスクの詳細 | レポートされたすべてのタスクの詳細をレポートに含めるかどうかを指定します。 |
| テスト ケースの詳細 | 実行したすべてのテスト ケースについての詳細をレポートに含めるかどうかを指定します。 |
| 要求/欠陥の詳細 | テストに関連付けられた要求、欠陥、タスク、および機能要求をレポートに含めるかどうかを指定します。 この設定を有効にするには、下記の [最上位のテスト スイートのみ] オプションを無効にする必要があります。 |
| 最上位のテスト スイートのみ | このオプションを有効にすると、テスト スイート サマリー レポート セクションに .tst ファイルだけが表示されます。無効にした場合、 各 .tst ファイル中の個々のテストがツリー形式に似た形式で表示されます。 |
| アクティブな静的解析ルール | 有効に設定された静的解析ルールの一覧をレポートに含めるかどうかを指定します。 |
| 失敗したテストのみ | 失敗したテストだけを表示するかどうかを指定します。 |
| コマンドライン モードでフォーマット済みのレポートを生成 | テストをコマンドライン モードで実行した場合に、フォーマットされたレポートを生成するかどうかを指定します。 |
| グラフの締め切り日付 | トレンド グラフの開始日付を指定します。トレンド グラフは、ある期間にわたってさまざまなカテゴリのタスクを追跡します。 |
要求/欠陥の詳細情報へのハイパーリンク
成果物の URL を (例えば SOAtest テスト プロパティとして) 指定している場合、その URL はハイパーリンクとして HTML レポートに表示されます。
ハイパーリンクを作成したい場合で、「テストと開発アーティファクトの関連付け」にあるように成果物 ID だけを使って成果物の関連付けを指定している場合、ローカル プロパティを使って成果物 ID と URL のマッピングを指定できます。
例:
- report.assoc.url.pr=https://bugzilla.parasoft.com/show_bug.cgi?id=[%ID%]
- report.assoc.url.jira=https://jira.parasoft.com/browse/[%ID%]
- report.assoc.url.fr=https://bugzilla.parasoft.com/show_bug.cgi?id=[%ID%]
- report.assoc.url.task=http://dtp.parasoft.com.pl:8080/grs/jsf/planning/task/edit_task.jsf?entityId=[%ID%]
レポートのフォーマット
| 設定 | 説明 |
|---|---|
| フォーマット | レポートのフォーマットを指定します。
|
| XSL ファイル | レポートのフォーマットとして [XSL カスタム] を選択した場合、カスタム フォーマットを定義した XSL ファイルへのパスを入力します。 |
| レポート ファイルの拡張子 | デフォルトの .html 以外のファイル拡張子を使用する場合、[レポート ファイルの拡張子] フィールドに拡張子を入力します。 |
| レポート全体のコンテンツを含む追加のアーカイブを生成 | 指定のレポートの場所に圧縮ファイル (.zip) も生成するには、このオプションを有効にします。zip ファイルには、レポートを作成するために生成された全ファイルが含まれます。 どのレポート フォーマットでもアーカイブを作成できます (たとえば HTML、CSV、PDF など)。 アーカイブを生成することで、レポートのカスタム変換も実施できます。なぜなら、すべての要素が指定のフォルダーに生成されるからです。 |
詳細設定
| 設定 | 説明 |
|---|---|
| XML データにファイルの絶対パスを追加する | XML データにファイルの絶対パスを追加するかどうかを指定します。インポート時にデスクトップ上の Parasoft 製品にタスクを再配置したい場合、サーバー上の Parasoft 製品でこのオプションをオンにする必要があります (「インポート時のタスクの再配置 - 要件と制限事項」を参照)。 |
| セッション タグ | セッション タグはテスト実行のための固有の識別子であり、DTP で同様の実行と区別するために使用されます。チームの通常のテスト実行の結果にはそれぞれ固有の識別子を付けるべきです。「設定での変数の使用」で説明されている変数を使用できます。例えば、チームが静的解析、単体テスト、コード レビューを実行する場合、セッション タグとして Static、Execution、および Code Review を使用します。あるいは、session.tag=${config_name} または session.tag=${analysis_type} といった変数を使用します。 |
| ビルド ID | 結果をラベル付けするビルド識別子を指定します。ビルド識別子は、各ビルドに対して付ける場合もあれば、指定のビルドで実行された複数のテスト セッションに対して付ける場合もあります。 デフォルトは |
ローカル設定
詳細については、 「ローカル設定の指定」を参照してください。
従来のレポート形式
カスタム レポート フォーマットのサポート
結果のフォーマットを指定するカスタム XSLT トランスフォーマーを作成することによって、ローカルに生成されて電子メールで送付されるレポートをカスタマイズできます。カスタム XSLT トランスフォーマーを使って、例えば、内部のセキュリティ ポリシーへの準拠を示すために必要なフォーマットにデータをマッピングできます。
カスタム レポート フォーマットを指定するには、以下の操作が必要です。
- XML データの変換方法を指定する XSL ファイルを作成します。
- [設定] ウィンドウの [Parasoft] > [レポート] で、[フォーマット] として [XSL カスタム] を選択します。ステップ 1 で作成した XSL ファイルの場所およびレポート ファイルの拡張子を指定します。
別の方法として、ローカル設定ファイルの (results.)report.custom.extension および (results.)report.custom.xsl.file でこの情報を指定できます。
利用できるパラメーター
次のパラメーターをカスタム XSL ファイルで使用できます。
| パラメーター | 注意 |
|---|---|
| report_type=disk_report|email_report | 生成されたレポートを電子メールで送信するか、ローカル ディスク ドライブに保存するかを決定します。 |
| test_params | このレポートを生成した製品を起動するために使用されたコマンドライン。 例: soatestcli -config team://xtest-static.properties^ -localsettings /home/nightly/localsettings.properties^ -publish -report /home/nightly/reports/report.html^ -resource myproject^ -dtp.autoconfig [email protected]:8080 |
| test_config_name | このレポートを生成するために使用されたテスト コンフィギュレーションの名前。 |
| output_dir=[dir] | レポートが作成されるディレクトリ。このパラメーターを使って開発者レポートを生成できます。 例:
|
| rules_dir_path=[path] | ルール ドキュメントが保存されるディレクトリ。このパラメーターを使って ルールのポップアップ/リンクを生成できます。 例:
|
| dev_errors=true|false | [タスクの詳細] オプションの値。詳細については、「Report Configuration Settings」 を参照してください。 |
| dev_reports=true|false | [詳細な開発者レポート] オプションの値。詳細については、「Report Configuration Settings」 を参照してください。 |
| show_active_rules=true|false | [アクティブな静的解析ルール] オプションの値。詳細については、「Report Configuration Settings」 を参照してください。 |
| associations=true|false | [要求/欠陥の詳細] オプションの値。詳細については、「Report Configuration Settings」 を参照してください。 |
| dev_reports_prefix=[prefix] | 開発者レポートのファイル名に使用する接頭辞。 例:
|
| exec_cvg_details=true|false | [詳細レポート] オプションの値。詳細については、「Report Configuration Settings」 を参照してください。 |
| attachments=true|false | ローカル設定キー report.mail.attachments の値。詳細については、「ローカル設定の指定」 を参照してください。 |
| test_suites_only=true|false | ローカル設定キー report.test_suites_only の値。詳細については、「ローカル設定の指定」 を参照してください。 |
| test_cases_details=true|false | [テスト ケースの詳細] オプションの値。詳細については、「Report Configuration Settings」 を参照してください。 |
| failed_tests_only=true|false | ローカル設定キー report.failed_tests_only の値。詳細については、「ローカル設定の指定」 を参照してください。 |
| authors_details=true|false | [作成者ごとのタスクの概要 ] オプションの値。詳細については、「Report Configuration Settings」 を参照してください。 |
| contexts_details=true|false | [チェックされたファイルおよび実行されたテストの概要] オプションの値。詳細については、「Report Configuration Settings」 を参照してください。 |
