自定义生命周期属性、工件和查询

如果您可以在创建项目时选择项目模板,则意味着模板中的工件、属性和查询已经过全面修改,可以满足您的需求。但是,您可能希望修改某些默认设置。例如,您的项目可能使用唯一的里程碑名称,并且可能希望修改各工件类型中的“目标里程碑”属性值,以反映这些名称。或者,您可能希望提供专用查询,以便向项目成员显示模板中已有查询尚未提供的信息。

必需的工件属性和规则自定义

域管理员可能已对项目模板中提供的工件和属性进行了某些必要的修改。具体说来,需要向几个属性分配几组值,另外还需要编辑两个属性依赖关系规则,以确保它们正常运行。

您需要为以下属性提供值

这些属性由 CollabNet 提供,因此它们的值仅为占位符。如果域管理员尚未配置这些属性,则您可以在项目级别上执行这些操作。

需要修改的依赖关系规则如下:

关于更改工件和属性的显示名的注意事项

不建议更改所提供的工件或属性的名称。而且,在考虑修改以下属性时应特别谨慎:

更改工件定义和添加工件类型

如果您要更改子页面或添加新页,这极有可能涉及更改一个或多个工件和查询。这些更改可能并不重要。例如,以下是您可能要执行的细微更改的示例:

其它更改可能很广泛。例如,以下是您可能要执行的重大更改的示例:

无论更改是适度的还是广泛的,您都需要按照基本流程添加或修改工件类型、获取用户需要用来查看此类型工件的查询,以及记录工件和查询的正确用法。

任务总览:修改生命周期工件和查询

  1. 编辑相关工件类型和属性定义。
  2. 创建使用新工件类型定义的自定义查询。
  3. 将查询 URL 复制到浏览器地址栏中。
  4. 编辑相应的子页面以显示新查询。
  5. 删除 URL 中的域前缀。
  6. 请确保已转义 URL 中的特殊字符。例如,应将“和”符号 ("&") 的所有实例都替换为 HTML 标记“&”。

编辑或创建工件类型定义:

  1. 单击“管理”页面。
  2. 单击“项目跟踪工具”>“工件类型”
  3. 按照联机帮助的说明添加或修改相应的工件类型。
    注意:添加或修改工件类型后,项目所有者必须将其添加到所有使用该工件类型的现有项目中。

创建自定义查询:

  1. 假定您创建的项目使用了您正在修改的流程,单击“项目”页面,然后单击使用该项目模板的项目。
  2. 在左侧导航窗格中单击“项目跟踪工具”>“查询工件”
  3. 单击“创建新的”
  4. 单击“高级查询”
  5. 定义查询条件。
  6. 当查询结果是您所需的结果时,请从浏览器地址栏中复制查询结果 URL。
  7. 将该 URL 粘贴到文本文件中。

编辑子页面或页面以反映更改:

  1. 导航到项目模板目录。
    例如,可以转到 project-templates/trunk/www/templates/My-Process/alm-process,
    其中 My-Process 是项目模板目录的名称。
  2. 使用 Subversion 更新 snippets 目录中的 top.html 文件。
  3. 编辑相应子页面或页面的 snippets 目录中的 top.html 或 bottom.html 文件。
    For example, you would edit project-templates/trunk/www/templates/My-Process/alm-process/1-Stages/1-Definition/snippets/top.html.
    其中 My-Process 是项目模板目录的名称。
  4. 将查询结果 URL 粘贴在“活动”区域或表的相应位置。
    例如,要更新“活动”区域的 URL,请在 <!-- Start Activity Box --> 注释下找到相应的列表项,例如:
    <li><a href="servlets/Scarab/remcurreport/true/template/Search.vm?nextTemplate=IssueList.vm&action= Search&eventSubmit_doSearch=Search& grp=si&si=&qattdelim=true&it=3&mitdelim=true& col=11%2C13%2C2&coldelim=true" title="查看所有已不再考虑的需求">已排除全部</a></li>
    注意:粘贴的 URL 看起来不会很美观。
  5. 删除查询 URL 的前缀。
    该前缀为 http:或 https://project.domain,其中 project 是捕获查询的项目的名称,domain 是项目驻留的域。URL 应以“servlets/Scarab”开头。
  6. 请确保已转义 URL 中的特殊字符。例如,应将“和”符号 ("&") 的所有实例都替换为 HTML 标记“&”。
  7. 在标题属性中添加信息,以便在用户将光标置于活动链接上方时显示工具提示。
  8. 使用版本控制工具提交更改。

CollabNet 基线项目模板工件类型

CollabNet 基线项目模板页包含显示与每个阶段相关的工件的查询。例如,“定义”页中显示的链接指向项目跟踪工具中的查询。这些查询返回正在开发的需求和已完成的需求。“设计”页中包含的链接指向正在设计的已完成需求的查询,以及设计工作也已经完成的已完成需求的查询。

使用 CollabNet 基线项目模板中的需求工件类型,用户可以在不同的阶段(从最初的定义阶段到设计、编码和测试阶段)跟踪需求。例如,用户可以通过将“生命周期中的子页面”属性值从“定义”更改为“设计”,将需求从计划子页面提升到设计子页面。“缺陷”工件类型允许在“测试”查询或“编码和构建”查询中显示缺陷。

下表汇总了 CollabNet 基线项目模板使用的工件类型、用户在不同子页面可对各种工件执行的活动,以及与查询条件匹配的属性值。

注意:可以修改这些工件类型,但这样做时应注意,您可能需要在相应的项目模板子页面中重新输入查询 URL。有关详细信息,请参见更改工件定义和添加工件类型。另外,如果您自定义了全局默认工件类型,自定义并不会应用于已存在的项目。它们仅应用于新项目,这些新项目中添加了已修改的工件类型。

CollabNet 基线项目模板中的默认工件类型

下面是 CollabNet 基线项目模板中的工件类型。

工件类型名称:CNALM-v1.1:需求

出现此工件类型的子页面:定义、设计、编码和构建、测试

描述:定义版本的新增功能的需求。

“查看所有已激活需求”查询链接显示尚未完成的工件。这些工件的“状态”属性具有以下选定值之一:“已提交”、“已开始”、“等待”或“重新打开”。

“当前处于某子页面”查询返回的需求具有以下属性值设置:

“准备某子页面”查询返回的需求与“当前处于某子页面”查询返回的需求区别如下:

输入由 CollabNet 分配的需求时,必需的属性包括:“摘要”、“总览”、“理由”、“状态”以及“生命周期中的阶段”。

工件类型名称:CNALM-v1.1:操作项

出现此工件类型的子页面:操作项出现在每个子页面。

描述:一项活动,例如处理客户案例或编写产品需求文档。

“查看所有已激活操作项”查询链接出现在大多数子页面中。使用此查询,用户可以查看所有尚未完成的操作项。

这些工件的“状态”属性具有以下选定值之一:“已提交”、“已开始”、“等待”或“重新打开”。

由 CollabNet 分配时,必需的属性包括:“源”、“优先级”、“摘要”、“总览”、“任务类型”、“客户案例 ID”、“客户关键?”、“受影响的客户”、“目标里程碑”、“目标的里程碑目标”以及“操作项”等类型。

工件类型名称:CNALM-v1.1:缺陷报告

出现此工件类型的子页面:代码和生成、测试

描述:

“缺陷报告(所有已激活项)”查询链接显示所有等候测试或正在进行测试的缺陷。这些工件的“状态”属性值设置为“已提交”、“已开始”、“等待”、“重新打开”

单击“当前处于某子页面的缺陷报告”查询链接后,用户可以查看所有正在进行测试的缺陷。这些工件设置了以下属性值:

单击“缺陷报告讨论标志”查询链接后,用户可以查看所有等候测试的缺陷。这些工件设置了以下属性值:

工件类型名称:CNALM-v1.1:客户案例

出现此工件类型的子页面:支持

描述:

“客户案例”描述客户报告的问题或增强申请。

单击“支持”页上的“所有激活项”查询链接后,用户可以查看所有正在处理的客户案例。“状态”属性值设置为“已提交”、“已开始”、“等待”、“重新打开”。

单击“客户案例讨论标志”查询链接后,用户可以查看所有已创建完毕但还在讨论中的客户案例。这些客户案例工件设置了以下属性值:

输入新的客户案例时,必需的属性包括:“源”、“源标识符”、“优先级”、“摘要”、“总览”、“任务类型”、“客户案例 ID”、“客户关键?”、“受影响的客户”、“目标里程碑”、“目标的里程碑目标”以及“生命周期中的子页面”。

工件类型名称:CNALM-v1.1:使用案例

出现此工件类型的子页面:CollabNet 基线项目模板中不存在使用案例的预定义查询。

描述:

使用案例描述用户要使用新增功能执行的实际任务。

输入新的使用案例时,必需的属性包括:“源”、“优先级”、“摘要”、“总览”、“理由”、“需求 ID”、“使用案例类型”以及“状态”。

用户可以基于“生命周期中的子页面”属性、相关需求的 ID 或工件类型,发出特殊的使用案例查询。除了提供“使用案例”工件类型外,CollabNet 基线项目模板还在模板目录中提供了一个 Word 格式的文档模板。用户通常可以从“定义”页或“设计”页上载此模板。

工件类型名称:CNALM-v1.1:测试案例

出现此工件类型的子页面:

描述:

测试案例描述一个必须经过测试以确保功能没有缺陷的方案。

输入测试案例时,必需的属性包括:“源”、“优先级”、“摘要”、“总览”、“系统”、“子系统”、“种类”、“子类”以及“状态”。

用户可以基于“生命周期中的子页面”属性、相关缺陷的 ID 或工件类型,发出特殊的测试案例查询。除了提供“测试案例”工件类型外,CollabNet 基线项目模板还在模板目录中提供了一个 Word 格式的文档模板。用户通常可以从测试子页面上载此模板。

工件类型名称:CNALM-v1.1:事件

出现此工件类型的子页面:部署

描述:事件描述由自动方法生成的事件。

工件类型名称:CNALM-v1.1:客户案例

出现此工件类型的子页面:支持

描述:客户案例描述客户报告的问题或增强申请。

输入客户案例时,必需的属性包括:“源”、“源标识符”、“优先级”、“摘要”、“任务类型”、“客户案例 ID”、“客户关键?”、“受影响的客户”、“目标里程碑”、“目标的里程碑目标”以及“生命周期中的阶段”。

工件类型名称:CNALM-v1.1:缺陷(只读)

出现此工件类型的子页面:测试

描述:只读缺陷描述 TestDirector 产品中所报告并上载到 CollabNet 的代码、用户界面或文档中的错误。

状态属性的转变

在很多 CollabNet 基线项目模板工件类型中使用的“状态”属性是一种状态类型属性。有关详细信息,请参见配置状态属性

下表总结了“状态”属性的有效状态转变:

如果“状态”属性
处于此状态
用户可选择以下状态
作为下一状态
初始 已提交
已提交 已开始、等待、将不会完成
等待 已完成、将不会完成
已开始 等待、将不会完成、已完成
已完成 重新打开
将不会完成 重新打开
重新打开 已开始、等待、将不会完成