.properties ファイルの設定を変更することで、レポートをカスタマイズできます (「設定の概要」を参照)。このセクションでは、レポート設定の例を説明します。レポートをカスタマイズするための完全な設定の一覧については「レポート設定」を参照してください。

レポートの出力場所の指定

解析時にレポートの出力ディレクトリを指定するには、report.location プロパティを使用します。例:

report.location=[path/to/location]

-report をスイッチを使用して HTML レポートの場所を変更することもできます。例:

jtestcli -report [path/to/location]

Ant および Maven のパターン

Ant または Maven で場所を指定するには、次のパターンを使用します。

<report>location</report>

レポートのフォーマットの指定

デフォルトでは、HTML レポートが生成されます。report.format プロパティを設定すると、指定されたディレクトリに PDF レポートやカスタム拡張を使用したレポートを生成できます。例:

report.format=pdf

カスタム レポート フォーマットのサポート

結果のフォーマットを指定するカスタム XSL 変換を構築することで、ローカルで生成されるレポートおよび E-mail で送信されるレポートをカスタマイズできます。たとえば、カスタム変換を使用すると、内部的なセキュリティ ポリシーへの準拠を証明するのに必要な書式にデータをマッピングできます。

カスタム レポート フォーマットを指定するには、次の操作を行います。

1. 1.XML データを変換する方法を指定する XSL ファイルを作成します。
2. XSL ファイルの場所を指定します。また、.properties ファイルで以下を設定し、結果ファイルに割り当てる拡張子を指定します。
   report.format=custom
report.custom.xsl.file=<full path to the XSL file>
report.custom.extension=<extension of the resulting file>
   
   IDE から解析を行う場合、XSL ファイルの場所および結果ファイルの拡張子は、レポート設定ページで指定できます (「レポートの生成」を参照)。

利用可能なパラメーター

カスタム XSL ファイルで以下のパラメーターを使用できます。

jtestcli: -config dtp://xtest-static.properties -settings /home/nightly/localsettings.properties -publish -report /home/nightly/reports/report.html -resource myproject -dtp.autoconfig [email protected]:8443

<xsl:value-of select="concat($output_dir,$dev_reports_prefix,$authid,'.csv')"/> 

<xsl:value-of select="concat('javascript:openWin(',$qt,$rules_dir_path,$id,'.html',$qt,')')"/>

<xsl:value-of select="concat($output_dir,$dev_reports_prefix,$authid,'.csv')"/>

レポート生成に使用する XSL ファイルのカスタマイズ

カスタム XSL 変換ファイルを一から作成するのではなく、任意の中間 XSL 変換ファイルをカスタマイズし、利用可能なすべてのフォーマットでレポートを生成するのに利用できます。XSL ファイルはインストール ディレクトリの etc/xsl ディレクトリにあります。2 つの方法があります。

• デフォルト ディレクトリ etc/xsl で直接ファイルをカスタマイズします。
• カスタマイズするファイルを別のディレクトリにコピーし、そちらを変更します。レポート生成時にデフォルトのディレクトリを探す前に別のディレクトリを使用するには、report.xsl.dir.user オプションを使用してディレクトリのパスを指定します。

レポートのフォーマット

次の表は、サポート対象のレポート フォーマットおよび各フォーマットで生成されるレポート ファイル名の一覧です。