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

自定义了项目阶段页和文档后，必须确保流程模板中提供的工件和属性可在您的环境中使用。

必须完成的 CollabNet 基线项目模板属性和规则自定义

即使 CollabNet 基线项目模板中的大部分内容都适合您的环境，有些项仍需要自定义。具体说来，需要为几个属性添加值集，另外还需要编辑两个属性依赖关系规则以确保它们正常运行。

您需要为以下属性提供值：

• CNALM：种类 - 此属性出现在“CNALM：缺陷报告”、“CNALM：需求”和“CNALM：测试案例”工件的“上下文和环境”属性组中。
• CNALM：受影响的客户 - 此属性出现在“CNALM：客户案例”、“CNALM：缺陷报告”、“CNALM：需求”和“CNALM：操作项”工件的“客户信息”属性组中。
• CNALM：发现缺陷的版本 - 此属性出现在“CNALM：客户案例”、“CNALM：缺陷报告”和“CNALM：需求”工件的“上下文和环境”属性组中。
• CNALM：硬件平台 - 此属性出现在“CNALM：客户案例”和“CNALM：缺陷报告”工件的“上下文和环境”属性组中。
• CNALM：操作系统 - 此属性出现在“CNALM：客户案例”和“CNALM：缺陷报告”工件的“上下文和环境”属性组中。
• CNALM：源 - 此属性出现在“CNALM：客户案例”、“CNALM：缺陷报告”、“CNALM：需求”、“CNALM：操作项”、“CNALM：测试案例”和“CNALM：使用案例”工件的“计划和执行”属性组中。
• CNALM：子组件 - 此属性出现在“CNALM：客户案例”、“CNALM：缺陷报告”、“CNALM：需求”和“CNALM：测试案例”工件的“上下文和环境”属性组中。
• CNALM：组件 - 此属性出现在“CNALM：客户案例”、“CNALM：缺陷报告”、“CNALM：需求”和“CNALM：测试案例”工件的“上下文和环境”属性组中。
• CNALM：目标里程碑 - 此属性出现在“CNALM：客户案例”、“CNALM：缺陷报告”、“CNALM：需求”、“CNALM：操作项”、“CNALM：测试案例”和“CNALM：使用案例”工件的“计划和执行”属性组中。

这些属性由 CollabNet 提供，因此它们的值仅为占位符。

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

• CNALM 子组件过滤器 - 此依赖关系规则必须指定具体的子系统属性值。如果编辑这些属性值，则可能需要编辑此规则。请注意，必须编辑每个工件类型定义中的每个规则定义。以下工件类型具有此规则：
  • CNALM：客户案例
  • CNALM：缺陷报告
  • CNALM：需求
  • CNALM：测试案例
• CNALM 种类过滤器 - 此依赖关系规则指定具体的种类属性值。如果编辑这些属性值，则可能需要编辑此规则。请注意，必须编辑每个工件类型定义中的每个规则定义。以下工件类型具有此规则：
  • CNALM：缺陷报告
  • CNALM：需求
  • CNALM：测试案例

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

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

• “状态”属性 - 这是“状态”属性。除非您已阅读有关“状态”属性的帮助并已熟悉此功能，否则不要修改“状态”属性。
• “生命周期中的阶段”属性 - CollabNet 基线项目模板提供的所有查询均依赖于此属性以及流程中提供的值。如果修改了此属性，则必须替换每页的“活动”区域（浅蓝色区域）中列出的许多查询。

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

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

• 在“测试”页上添加查询以返回所有严重性为 S2 或更高的缺陷。
• 从工件类型定义中删除某些属性，因为这些属性与您的组织无关。
• 添加查询以显示所有已标记为“已关闭”的需求。

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

• 添加新工件类型。
  例如，您可以在测试阶段和部署阶段之间添加一个名为“限定”的阶段，而此阶段可能需要一个名为“接受度测试”的工件类型。
• 更改人们将工件类型提升到新阶段所依据的规则。
  例如，您可能要求项目成员将使用案例文档与每个需求工件相关联，并且设置一个名为“使用案例完成”的属性值，然后才能将“定义完成”属性的值设置为“是”。

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

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

1. 编辑相关工件类型和属性定义。
2. 创建使用新工件类型定义的自定义查询。
3. 将查询 URL 复制到浏览器地址栏中。
4. 编辑相应的阶段页以显示新查询。
5. 删除 URL 中的域前缀。
6. 请确保已转义 URL 中的特殊字符。例如，应将“和”符号 ("&") 的所有实例都替换为 HTML 标记“&”。
7. 如果添加新工件类型或修改工件类型的全局名称，则必须在此流程模板的 template.properties 文件中加以说明。
   有关详细信息，请参见关于 template.properties。

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

1. 单击“管理”选项卡。
2. 单击“项目跟踪工具”>“工件类型”。
3. 按照联机帮助的说明添加或修改相应的工件类型。
   注意：添加或修改工件类型后，项目所有者必须将其添加到所有使用该工件类型的现有项目中。修改还必须在 templates.properties 文件中反映出来。

创建自定义查询：

1. 假定您创建的项目使用了您正在修改的流程，单击“项目”选项卡，然后单击使用该流程模板的项目。
2. 在左侧导航窗格中单击“项目跟踪工具”>“查询工件”。
3. 单击“创建新的”。
4. 单击“高级查询”。
5. 定义查询条件。
6. 当查询结果是您所需的结果时，请从浏览器地址栏中复制查询结果 URL。
7. 将该 URL 粘贴到文本文件中。
8. 请确保已转义 URL 中的特殊字符。例如，应将“和”符号 ("&") 的所有实例都替换为 HTML 标记“&”。

编辑阶段页或选项卡以反映更改：

1. 导航到流程模板目录。
   例如，可以转到 project-templates/trunk/www/templates/My-Process/alm-process，
   其中 My-Process 是流程模板目录的名称。
2. 使用 Subversion 更新 snippets 目录中的 top.html 文件。
3. 编辑相应阶段或选项卡的 snippets 目录中的 top.html 或 bottom.html 文件。
   例如，您可以编辑 project-templates/trunk/www/templates/My-Process/alm-process/1-阶段/1-定义/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 的代码、用户界面或文档中的错误。