JUnit 报表宏用于显示通过 Confluence 服务器 JUnit 测试结果。JUnit是一个单元测试框架,它允许程序员进行测试并确定代码能够正常工作。
JUnit 报表宏如下图显示:
屏幕截图:Confluence 中的 JUnit 单元测试结果
注意:当 JUnit 报表宏生成报表的时候,需要将 Apache 的 Ant 格式设置成为 XML。
使用 JUnit 报表宏
To add the JUnit Report macro to a page:
- 打开你希望编辑 Confluence 页面,然后单击 编辑(Edit)按钮。页面的编辑模式将会被打开。
- 下一步,在编辑工具栏中单击宏浏览器图标。这时候宏浏览器将会在屏幕的中间打开。
- 在宏浏览器中,在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项,在这里你可以对需要插入的宏设置相关参数,然后单击 插入(insert)来将需要的宏插入到页面中。
参数
宏参数的定义为,你可以使用这些参数在宏输出的内容和格式上进行定义。
Confluence 使用的存储格式或者 wikimarkup 格式中使用的参数和在宏浏览器中使用的标签是不同的,这些将会在下面在括号内容中列出(example
)。
参数 | 是否是必须 | 默认值 | 说明 |
---|
测试结果的 XML 文件的 URL(URL of the test result XML file)
(url ) | Must include either thedirectory or the url parameter | 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
存储格式示例
Wiki 标记格式示例
从本地驱动器中载入 JUnit 报表:
{junitreport:directory=file:
|
从网络驱动器中载入 JUnit 报表:
从Confluence 站点中载入 JUnit 报表:
从 Confluence 站点中载入 JUnit 报表,报表需要输入授权信息。
如果一个 Confluence 实例不允许匿名用户的访问,你可以指定登录用户名和密码再 URL 参数中。os_username
和 os_password
可以在 URL 参数中被使用(这个参数做为 URL 参数的一部分)。在这,我们指定用户名(username) 为 'admin',密码(password)为 'secret'。