Page tree
Skip to end of metadata
Go to start of metadata

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

JUnit 报表宏如下图显示:

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

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

使用 JUnit 报表宏

To add the JUnit Report macro to a page:

  1. 打开你希望编辑 Confluence 页面,然后单击 编辑(Edit)按钮。页面的编辑模式将会被打开。
  2. 下一步,在编辑工具栏中单击宏浏览器图标。这时候宏浏览器将会在屏幕的中间打开。
  3. 在宏浏览器中,在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项,在这里你可以对需要插入的宏设置相关参数,然后单击 插入(insert来将需要的宏插入到页面中。

参数

宏参数的定义为,你可以使用这些参数在宏输出的内容和格式上进行定义。

Confluence 使用的存储格式或者 wikimarkup 格式中使用的参数和在宏浏览器中使用的标签是不同的,这些将会在下面在括号内容中列出(example)。

参数

是否是必须

默认值

说明

测试结果的 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

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

代码示例

下面的代码是提供给希望进一步编辑 Confluence 页面的高级用户使用的。

宏名称: 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}
  • No labels