Jama Connect中的需求审批通常由条目状态流程和Review Center配合完成。状态流程负责规定需求可以从哪个状态切换到哪个状态，以及哪些用户有权执行切换；Approval Review负责收集评审意见、批准结果和电子签名。需求已经完成评审，却仍停在In Review或其他中间状态时，可以分别检查【Workflow】配置、【Approval Review】参与者状态和【Transition Permissions】，确认审批动作与需求状态转换是否真正关联。

　　一、Jama Connect怎么设置需求审批流程

　　需求审批可以先为Requirement类型建立状态转换，再启用Approval Review模板。这样Moderator完成审批评审后，可以按照已配置的流程把一批需求切换到Approved等目标状态。

　　1、配置Requirement状态转换

　　①使用Organization Admin或具备相应管理权限的账号进入Jama Connect。

　　②打开【ADMIN】→【Organization】→【Workflow】。

　　③启用【Enable workflow for this organization】。

　　④在【Workflow Administration】中找到需求对应的Item Type。

　　⑤点击该类型右侧的【Config】。

　　⑥确认当前流程使用的状态Pick List，例如需求的【Status】字段。

　　⑦在【Current Status】中选择起始状态，例如【Draft】。

　　⑧在【New Status】中设置允许进入的状态，例如【In Review】。

　　⑨继续添加【In Review】到【Approved】以及需要使用的退回状态。

　　⑩点击【Save settings】保存配置。

　　Jama Connect的流程是按Item Type和状态字段控制的。项目存在不同需求类型时，要确认当前审批对象实际使用的是哪一种Item Type，避免只配置了相似类型。

　　2、配置状态转换权限和锁定方式

　　①进入对应Item Type的【Workflow Configuration】。

　　②找到需要限制的状态转换。

　　③打开【Transition Permissions】。

　　④把允许执行该转换的用户或Group加入许可范围。

　　⑤普通编辑人员不应直接把需求改为批准状态时，不要给对应角色开放该转换权限。

　　⑥返回流程配置页面，检查目标状态对应的【Lock】设置。

　　⑦需要批准后禁止继续修改需求时，为【Approved】状态启用系统锁定。

　　⑧根据项目要求配置【Notifications】。

　　⑨检查【Versioning】设置，选择状态改变时是否建立新版本。

　　⑩保存当前Workflow配置。

　　如果项目管理员启用了项目级流程覆盖，还要进入【ADMIN】→【Project】→【Workflow】检查当前项目是否使用了Override配置，不能只看Organization层的规则。

　　3、启用Approval Review并发起审批

　　①进入【ADMIN】→【Organization】→【Review Center】。

　　②启用【Approval review template】。

　　③保存Review Center设置。

　　④返回项目，在Explorer Tree中选择准备审批的需求。

　　⑤点击【Send for review】。

　　⑥在【Definition】中填写评审名称、截止时间并确认需求范围。

　　⑦进入【Settings】，选择【Approval】模板。

　　⑧项目要求电子签名时，启用【Require electronic signatures from approvers】。

　　⑨进入【Participants】，把审批人员设置为【Approver】。

　　⑩进入【Invitation】检查通知内容，然后点击【Initiate review】。

　　Moderator负责创建和管理评审，Approver负责批准或拒绝条目。只把用户加入评审，但角色仍是Reviewer时，该用户不能执行Approval操作。

　　二、Jama Connect需求审批状态无法推进如何排查

　　审批卡住时，要先判断是Review没有完成，还是Review已经完成但需求Item没有发生状态转换。这两种情况看起来都像“状态不动”，但对应的检查位置不同。

　　1、检查Approver是否真正完成审批

　　①打开当前Approval Review。

　　②进入【Stats】→【Item progress】。

　　③查看目标需求当前显示为Approved、Rejected还是未完成。

　　④检查每个Approver的完成状态。

　　⑤如果某个需求仍未表态，让对应Approver打开该条需求。

　　⑥点击批准图标或使用【Batch item actions】完成批准。

　　⑦审批人完成全部条目后，点击【Complete review】。

　　⑧要求电子签名时，在结束评审窗口完成签名并选择【Approve and sign】。

　　多个Approver参与同一条需求时，Item progress里的批准结果要结合全部审批人的完成情况判断。有人尚未结束自己的评审任务时，Moderator不应把个人批准动作当成整场审批已经结束。

　　2、检查Moderator是否完成Finalize

　　Approver完成审批以后，需求状态并不会靠单个批准按钮直接改成Approved，采用Review与Item Workflow联动时，还需要Moderator完成最终处理。

　　①使用Moderator账号进入目标Review。

　　②检查所有待处理意见和审批结果。

　　③打开【Manage review】。

　　④选择【Finalize approval review】。

　　⑤查看窗口里列出的Workflow transitions。

　　⑥确认需求当前状态存在对应目标转换。

　　⑦点击【Finalize review】。

　　⑧返回项目查看需求的【Status】。

　　如果没有看到关闭并转换需求状态的相关选项，可以进入Organization配置检查Workflow是否已经对当前Item Type启用。

　　3、检查Transition Permissions和当前状态

　　①打开一条无法推进的需求。

　　②记录当前【Status】。

　　③进入【ADMIN】→【Organization】→【Workflow】。

　　④打开该需求Item Type的【Config】。

　　⑤确认Current Status下确实存在目标New Status。

　　⑥点击该转换对应的【Transition Permissions】。

　　⑦确认执行转换的账号或Group具备权限。

　　⑧项目使用Workflow Override时，再进入【ADMIN】→【Project】→【Workflow】核对项目配置。

　　⑨保存修改后重新测试状态转换。

　　批量转换时，选择的需求还必须属于相同Item Type并处于相同流程状态。混合不同类型或不同状态的条目时，不能按同一条Transition一次处理。

　　三、流程配置正确但审批仍然停住怎么继续检查

　　权限和状态路径没有问题后，可以继续检查系统锁定、评审版本以及Review与Item Workflow之间的关联。这里可以拿一条测试需求单独跑一次审批，确认是哪一步开始不能继续。

　　1、检查需求是不是被系统锁定

　　①在Explorer或List View中找到目标需求。

　　②查看条目是否显示锁定标记。

　　③进入【ADMIN】→【Project】→【Workflow】。

　　④找到当前Item Type。

　　⑤检查当前状态对应的【Lock】配置。

　　⑥如果锁定位置设置错了，把锁定调整到真正需要保护的目标状态。

　　⑦保存流程配置。

　　⑧再通过正常状态Transition测试需求。

　　系统锁定和用户手工锁定并不是同一种状态。由Workflow产生的系统锁定更适合通过流程切换解除，不建议把管理员手工解锁当成常规审批动作。

　　2、用Batch transition检查可用状态

　　①进入目标Review。

　　②打开【Stats】→【Item progress】。

　　③选择几条相同Item Type、相同状态的需求。

　　④点击【Actions】→【Batch transition workflow】。

　　⑤查看是否存在可以选择的目标Transition。

　　⑥没有可用状态时，回到Workflow检查状态路径。

　　⑦再检查当前账号的【Transition Permissions】。

　　⑧修改后重新打开Batch transition窗口测试。

　　如果窗口没有任何可选目标状态，通常可以从当前状态没有下一条Transition、账号没有转换权限或条目锁定这几个方向继续定位。

　　总结

　　Jama Connect需求审批要把Review中的批准结果和需求Item本身的状态转换分开管理。审批人已经点击批准，并不代表需求状态已经完成切换，还要确认Moderator完成最终评审处理，同时检查当前Item Type存在对应状态路径和转换权限。把一条测试需求从草稿、评审到批准完整跑一遍，也更容易定位审批流程卡在哪个环节。如需进一步了解Jama Connect需求审批、Approval Review与状态转换异常排查方法，欢迎联系咨询。