.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.XML データを変換する方法を指定する XSL ファイルを作成します。
XSL ファイルの場所を指定します。また、.property ファイルで以下を設定し、結果ファイルに割り当てる拡張子を指定します。
report.format=custom
report.custom.xsl.file=<path to the XSL file>
report.custom.extension=<extension of the resulting file>

IDE から解析を行う場合、XSL ファイルの場所および結果ファイルの拡張子は、レポート設定ページで指定できます (「レポートの生成」を参照)。

利用可能なパラメーター

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

パラメーター	説明
report_type=disk_report\|email_report	生成されるレポートを E-mail で送信するか、ローカルディスクドライブに保存するかを指定します。
test_params	このレポートを生成する製品の起動時に使用されたコマンドライン例: jtestcli: -config dtp://xtest-static.properties -localsettings /home/nightly/localsettings.properties -publish -report /home/nightly/reports/report.html -resource myproject -dtp.autoconfig [email protected]:8443
test_config_name	レポート生成時に実行されたテストコンフィギュレーション名例: Recommended Rules
output_dir=[dir]	レポートが作成されるディレクトリ。このパラメーターは、開発者レポートの作成に使用できます。例: <xsl:value-of select="concat($output_dir,$dev_reports_prefix,$authid,'.csv')"/>
rules_dir_path=[path]	ルールドキュメントが保存されているディレクトリ。ルールポップアップ/リンクの生成に使用できます。例: <xsl:value-of select="concat('javascript:openWin(',$qt,$rules_dir_path,$id,'.html',$qt,')')"/>
suppr_msgs=true\|false	`report.suppressed_msgs` オプションの値。詳細は「レポート設定」を参照してください。
dev_errors=true\|false	`report.developer_errors` オプションの値。詳細は「レポート設定」を参照してください。
dev_reports=true\|false	`report.developer_report` オプションの値。詳細は「レポート設定」を参照してください。
show_active_rules=true\|false	`report.active_rules` オプションの値。詳細は「レポート設定」を参照してください。
associations=true\|false	`report.associations` オプションの値。詳細は「レポート設定」を参照してください。
dev_reports_prefix=[prefix]	開発者レポート名を作成するための接頭辞例: <xsl:value-of select="concat($output_dir,$dev_reports_prefix,$authid,'.csv')"/>
attachments=true\|false	`report.mail.attachments` オプションの値。詳細は「レポート設定」を参照してください。
authors_details=true\|false	`report.authors_details` オプションの値。詳細は「レポート設定」を参照してください。
contexts_details=true\|false	`report.contexts_details` オプションの値。詳細は「レポート設定」を参照してください。

レポートファイル名

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

レポートのフォーマット	レポートファイル名
HTML	report.html
PDF	report.pdf
CSV	report.csv
XSL カスタム	report_custom.xml report_custom.html
JSON SARIF (Static Analysis Results Interchange Format)	report.sarif
JSON SARIF for Azure DevOps	report_azure.sarif
JSON SAST for GitLab	report.sast
XML SATE (Static Analysis Tool Exposition)	report_sate.xml
XML xUnit	report_xunit.xml

report.file.name 設定を使用してレポートファイル名をカスタマイズできます。

Page tree

Customizing Reports