JUnit 报表宏用于显示通过 Confluence 服务器  JUnit 测试结果。JUnit是一个单元测试框架,它允许程序员进行测试并确定代码能够正常工作。

JUnit 报表宏如下图显示:

屏幕截图:Confluence 中的 JUnit 单元测试结果

注意:当 JUnit 报表宏生成报表的时候,需要将 Apache 的 Ant 格式设置成为 XML。

使用 JUnit 报表宏

To add the JUnit Report macro to a page:

参数

参数

是否是必须

默认值

说明

测试结果的 XML 文件的 URL(URL of the test result XML file)
(url

Must include either thedirectoryor the urlparameter

None

测试结果的 XML 文件参数。如果你同时还是用了 测试结果文件的目录(Directory (URL) of your test result files),这个参数将会覆盖掉 测试结果文件的目录(Directory (URL) of your test result files)中的配置。

例如,从一个 Confluence 实例中:http://yourConfluenceInstance.com/download/attachments/<page id>/file.xml

如果一个 Confluence 实例不允许匿名用户的访问,你可以指定登录用户名和密码再 URL 参数中。

  • os_username — 具有访问 JUnit 测试结果的 Confluence 用户用户名。
  • os_password — 具有访问 JUnit 测试结果的 Confluence 用户密码。

测试结果文件的目录(Directory (URL) of your test result files)
(directory

必须使用 directory 或 url 参数。

None

测试结果存储的文件路径。你必须指定的是目录名称,而不是一个具体的文件。如果你同时还是用了 测试结果文件的目录(Directory (URL) of your test result files),这个参数将会覆盖掉 测试结果文件的目录(Directory (URL) of your test result files)中的配置。

 本地文件的示例: file:///C:/TEMP/

网络文件的示例: http://*host*/*path*

报表细节(Report Detail)
(reportdetail

No

all

报表的细节,可以是 all, fixture, summary 或者 failuresonly。

调试(Debug)
(debug
No

None

显示错误信息或者系统运行显示失败的细节信息。

代码示例

宏名称: junitreport

宏内容: None

存储格式示例

<ac:structured-macro ac:name="junitreport">
  <ac:parameter ac:name="reportdetail">summary</ac:parameter>
  <ac:parameter ac:name="directory">
    <ri:url ri:value="http://confluence.com/download/attachments/123/"/>
  </ac:parameter>
  <ac:parameter ac:name="debug">true</ac:parameter>
  <ac:parameter ac:name="url">
    <ri:url ri:value="http://confluence.com/download/attachments/123/file.xml"/>
  </ac:parameter>
</ac:structured-macro>

Wiki 标记格式示例

从本地驱动器中载入 JUnit 报表:

{junitreport:directory=file:///C:/TEMP/}


从网络驱动器中载入 JUnit 报表:

{junitreport:url=http://*host*/*path*}


从Confluence 站点中载入 JUnit 报表:

{junitreport:url=http://yourConfluenceInstance.com/download/attachments/<page id>/file.xml}


从 Confluence 站点中载入 JUnit 报表,报表需要输入授权信息。

如果一个 Confluence 实例不允许匿名用户的访问,你可以指定登录用户名和密码再 URL 参数中。os_username 和 os_password 可以在 URL 参数中被使用(这个参数做为 URL 参数的一部分)。在这,我们指定用户名(username) 为 'admin',密码(password)为 'secret'。

{junitreport:url=http://yourConfluenceInstance.com/download/attachments/<page id>/file.xml?os_username=admin&os_password=secret}