章节目录：

概述

可以通过配置 Jtest 将测试与需求、缺陷、任务和功能请求等各类开发工件关联。

要成功将单元测试与工件关联，您需要：

1. 启用工件关联属性。
2. 指定问题跟踪标签。
3. （可选）配置 URL 关联。

4. 使用 Javadoc 中的标签

启用工件关联

确保将 report.associations 属性设置为 true，启用与工件的关联。这也会在 HTML 报告中启用/禁用测试关联。

report.associations=true

指定问题跟踪标签

启用报告关联后，将默认关联以下工件类型的标签：

• asset
• fr（增强）
• pr（缺陷）
• req（用户故事）
• task
• test

您可以使用 issue.tracking.tags 属性定义任意数量的额外跟踪标记。用逗号分隔标签名：

issue.tracking.tags=tag1,tag2,tag3

配置问题跟踪标签与 URL 关联

通过配置 report.assoc.url.tag{n} 选项，可在 HTML 报告中生成指向关联的链接：

report.assoc.url.tag1=[URL]

URL 可以包含 [%ID%] 或 ${id} 变量，这些变量将被问题标识符替代。例如：

report.assoc.url.tag1=http://bugzilla.company.com/show_bug.cgi?id=[%ID%]

启用测试详细信息

您可以启用或禁用在 HTML 报告中显示测试详细信息：

report.contexts_details=[true | false]

必须将 report.contexts_details 属性设置为 true 才能显示关联。产品的属性文件已预先配置为可以显示测试详细信息。

更多信息，请参阅报告设置。

使用 Javadoc 标签

使用 Javadoc 标签将单元测试与工件关联。

将标签放在 Javadoc 中，与您的测试关联。在 Javadoc 中使用的标签前应有一个 @ 字符。

/**
 * @bug 12345
 * @pr 223344
 * @tag1 5533
 */
@Test
public void testSomething()
{
   ...
}

您还可以将标签与类关联。这样，标签就能与该类中的所有测试关联。在以下示例中，tag 9876 与 Test 类中的两个 test 关联，而 tag 111 仅与 testSomething2 关联：

/**
 * @tag 9876
 */
public class Test {

    testSomething1()
    {
     ...
    }

    /**
     * @tag 111
     */
    testSomething2()
    {
      ...
    }
}

多重关联

您可以将一个标签与多个工件关联。使用逗号分隔多个关联项，逗号后不使用空格字符。

/**
 * @task 1234,2345
 */
@Test
public void testSomething()
{
   ...
}

如果用逗号和空格分隔 task，测试只会与列出的第一个工件关联。在以下示例中，测试仅与 task 1234 关联：

/**
 * @task 1234, 2345
 */
@Test
public void testSomething()
{
   ...
}