Jama Connect

当需求、缺陷、测试用例还有变更项这些东西都被放到同一个项目里去之后，要是工作项的类型没有提前梳理好，等到要新建内容的时候，就很容易把模板给挑错了。在Jama Connect这款工具里面，所谓的Item Type，其实指的就是工作项的类型，它会直接决定一条条目的名称、里面包含哪些字段、显示什么样的图标、类型的编码是什么，以及它是拿来干嘛用的。一般来说，建立和修改类型这件事，是由组织管理员来负责的，而各个项目里到底能看见哪些类型，则由项目管理员去决定。并且需要留意的是，工作项的类型属于组织这一层级的配置，不能只针对某一个项目去单独改动它的结构。

需求、测试用例还有评审文档，经过好几轮改来改去之后，光靠把文件导出来再去人工一行一行地找差异，是很不现实的。想要把Jama Connect里的版本对比搞清楚，得先弄明白怎么操作版本对比这件事，以及版本之间的差异到底从哪里去查看，动手之前先得确认一下，我们这次要比较的对象到底是一条单独的需求、一整组用基线管起来的需求集合，还是某一次评审专用的版本。Jama Connect本身会给内容留下版本记录，它也可以通过基线把某一个时间点上的对象状态和它们之间的关联关系存下来，这个能力很适合在需求冻结、评审快要完成，还有版本快要发布之前，拿来做差异核对。

很多团队一提到Jama Connect和Git对接，第一反应都是“能不能连上仓库”，可真正决定这件事有没有价值的，不只是代码库接通了没有，而是提交记录能不能顺着需求链一路回到Jama Connect。Jama Software官方现在对这条链路的表述已经很明确，Jama Connect支持通过集成和REST API与Git、GitLab等开发工具连接，把开发活动纳入Live Traceability这条追溯链里，让需求、开发和后续验证不再分散在各自的工具里。

在Jama Connect里，测试不是一上来先建测试计划，而是先把测试用例作为item建出来，再把它们组织进测试计划、测试组和测试周期。官方帮助把这条链路写得很清楚：测试用例先创建并直接关联到要验证的需求，再创建测试计划，把测试用例加入计划并按组组织，之后在测试计划里创建一个或多个测试周期，系统会为周期里的每个测试用例自动生成test run，测试结果再回卷到test case status。

很多团队在Jama Connect里做需求管理时，容易把“建基线”和“冻结当前需求”当成同一件事。实际上这两步是连着的，但作用并不一样。Jama官方帮助说明，Baseline是某个时间点上项目内容及其关系的快照，适合拿来做里程碑留档、导出依据和后续对比；而当前项目里的需求项是否还能继续改，更多取决于锁定和工作流控制。

当完成测试用例的整理工作后，还需要把它们安排进具体的测试计划和测试周期里，才能真正开始执行。在Jama Connect里，测试计划这一项是用来讲清楚验证范围、测试目标以及执行时间安排的；测试周期则是专门组织某一轮实际测试活动的；而测试运行，就负责把每条用例跑出来的结果记录下来。这三样东西各管各的，不要把它们当成一回事来用。另外需要注意的一点是，测试用例自身状态的变化，并不是手工直接去改的，而是由它所关联的那些测试运行结果，通过系统自动计算汇总出来的。

当需求、测试用例和变更项进入确认阶段以后，如果还是靠着几张表格和来回的邮件去传递信息，版本混成一团的事情就很容易冒出来。想要搞清楚在Jama Connect里面怎样去新建一轮评审，以及评审的提醒又该怎么发出去，就得把评审到底要覆盖哪些内容、参与者担任什么角色、截止时间卡在哪里，还有通知的整个传递路径，一并都设好才行。Jama Connect允许对项目里面的单条条目，或者凑成一组条目去提起评审，而发起评审的那个人，会被默认当作主持人，也就是Moderator。

Jama Connect导入Excel怎么做，先别急着把表格拖进去。官方帮助里把这件事拆得很清楚，Excel导入分单向导入和round-trip两种，前者适合把新条目导进Jama Connect，后者更适合把Jama里导出的表格改完后再回写更新；同时一张工作表只能导一种item type，层级也要提前在表里用缩进或颜色准备好。也就是说，导入前先把表格结构理顺，比后面反复重导更省事。

很多团队在Jama Connect里做完评审后，最容易漏掉的不是意见处理，而是后面怎么把记录导出来、怎么把证据留成一套可审计材料。按Jama Connect官方帮助的口径，评审导出和评审归档本来就是两件事：导出解决的是把评审活动、签名状态、评论和评审内容带出系统，归档解决的是让已完成评审从日常列表中收口，同时保留后续可查可恢复的历史记录。

很多团队在用Jama Connect时，前期最容易出的问题，不是谁不会点权限，而是把许可证、角色、项目访问和对象层级这几件事混成了一套。按官方帮助中心的口径，Jama Connect里有两条线要先分清，一条是role，也就是谁能做管理动作，另一条是permission，也就是谁能在项目里看和改哪些内容；再往下还有license type，会直接影响用户能不能创建、编辑、执行测试或只读查看。只有先把这三层拆开，后面的项目权限才不会越配越乱。

需求的数量慢慢变多以后，一条一条地去改动状态、负责人和优先级这些东西，常常会耗掉不少时间；所以很多使用者会关心，在Jama Connect里面到底怎么对数据进行批量更新，还有在批量操作之后如果不小心改错了，又该怎么进行回退，处理这种事情之前，得先判断一下这一次要改动的规模有多大，如果只是很少几项类型完全相同的条目，直接使用它自带的批量编辑功能就非常省事，而如果是跨了好几个字段、修改的范围又特别大的情况，那就更适合借助Excel的往返导入功能来完成了，在正式把修改提交上去之前，最好先创建一个基线，这样就算不当心改错了，也不用只靠着记忆去一条一条地恢复，能够省下许多力气。

随着项目里的需求、缺陷还有测试用例越积越多，再想靠在Explorer Tree里面一条一条地翻看，就会变得很费时间。要弄明白Jama Connect里头报表是怎么生成的，以及报表里的字段又要怎么去筛选，动手之前得先把两类需求给分清楚：一类是直接生成那种格式固定的项目汇总报表，另一类是按照设定好的条件把条目筛出来，再导出成Word、Excel或者PDF文件。Jama Connect的报表可以带上图表、表格、指标还有汇总数据，也能够只针对某一个项目，或者一口气拉上好几个项目一起跑。

把原来写在Excel、Word或者其他管理工具里的需求搬到Jama Connect的时候，不能简单地把文件往里一丢就觉得完成了。在正式开始导入之前，有几件事得先理清楚，比如需求的类型怎么划分、字段的名字要对齐、需求的层级关系是什么，还有那些从固定列表里选的枚举值，都得提前确认好，不然导进去以后很容易乱掉。Jama Connect里面数据的组织方式是以工作项作为基本单位的，需求、测试用例、文件夹这些东西，虽然外表看起来都待在项目里，但其实是不同的对象类型，不能一概而论。根据官方帮助资料里的说明，数据导入向导（Data Import Wizard）能够处理的文件类型包括doc、docx、xls、xlsx和csv等，而且它会根据你选的文件格式，自动显示出相关的导入选项，所以不用自己从头猜配置。

很多团队在Jama Connect里做追溯，真正容易乱掉的不是关系建不出来，而是单条建链和批量维护没有先分开。按官方帮助的口径，日常小范围补链，更适合在List View或Trace View里直接批量选择条目后建立关系；如果是大批量导入既有条目之间的关系，则更适合用Relationship Import Plugin配合CSV一次导入。再往上，关系规则和关系类型由组织管理员统一配置，后续Coverage Explorer、Trace View和Live Trace Explorer再负责检查覆盖缺口和追溯完整度。

Jama Connect做评审时，最容易乱掉的通常不是入口找不到，而是“从哪里发起评审”“谁来当主持人”“谁是评审人、谁是审批人”这几件事没有先分清。按Jama Connect官方帮助，评审本身是通过Review Center发起的，创建时会经过设置、参与人、邀请这几步；默认情况下，创建评审的人就是moderator，也就是主持人。只要先把发起入口、角色分工和人数范围定清，后面的评审流程会顺很多。

在Jama Connect里面，需求、测试用例和评审内容经过好几轮修改之后，光靠给文档加个版本号，是很难还原出完整的修改过程的。要想看审计记录，先得把查看的范围分清楚，因为它的入口不止一处：如果只是想追查单独一条需求被谁改过，更适合去看那条需求的Item Activity Stream；如果是要梳理整个项目的变动，那就应该去看Project Activity Stream；而基线和评审相关的内容，则要进到各自的活动记录里面去查。Jama Connect会把新增、编辑、删除、恢复、评论，还有关联关系的变化，以及跟基线和评审有关的各种动作，都一一记录下来。

当团队把需求评审、缺陷跟踪和版本变更都集中到Jama Connect以后，通知太少会让人错过关键动作，通知太多又容易把真正重要的信息淹没，所以很有必要弄清楚Jama Connect里的通知到底该怎么配置，以及通知的规则又该怎样去调整；处理的时候需要先分清几样东西：个人订阅、项目订阅、管理员代订的订阅，还有评审环节的通知，比较稳妥的顺序是先定好接收频率，再去决定哪些需求、哪些容器和哪些评审需要持续关注。

在刚开始搭建需求管理项目的时候，目录结构怎么搭、模板怎么选，这些东西会直接影响到后面的评审、追踪，还有测试管理。要搞清楚Jama Connect里面怎么去新建一个项目，还有项目模板要怎么挑，关键就是先判断清楚当前这个项目到底是一个全新的产品，还是在既有版本上做升级，又或者是同类产品弄出来的一个分支。在Jama Connect里面，项目这个东西可以被理解成一个独立的工作空间，它通常对应的就是一个产品或者一个系统的版本，而项目的内部，再通过Component、Set、Folder还有Item这些东西，把需求、测试和其他内容给组织起来。

很多团队刚把Jama Connect用到测试环节时，容易把“测试执行”和“测试管理”混成一件事。实际上，Jama Connect的测试对象是分层管理的，通常先有Test Plan，再在计划里建立一个或多个Test Cycle，随后把测试用例关联进周期，系统才会为每个关联的测试用例生成对应的Test Run。真正落地时，测试执行主要围绕Test Run展开，测试周期管理则更多是在管范围、时间、人员、锁定和归档。

Jama Connect里所谓“追溯缺链”，很多时候并不是系统没算出来，而是项目的关系规则已经定义了必须有上游或下游关系，但当前条目没有按规则连上，所以状态指示器直接变红。官方帮助写得很清楚，Relationship Status Indicator会在缺少必需上游、缺少必需下游、存在suspect link，或者因为上游变更导致下游关系可疑时发出红色提示；而Trace View和Live Trace Explorer也都会把coverage gap直接暴露出来。也就是说，缺链先别急着逐条手翻，先用系统现成的缺口视图把问题位置圈出来，再去补链会快很多。