禅道中查看需求变更记录需通过四种方式:一、在需求详情页点击“变更”按钮查看结构化版本对比;二、在需求列表启用“变更状态”列筛选;三、导出Excel格式的变更日志用于审计;四、数据库查询zt_storychanges表获取原始快照。

如果您在禅道中需要追溯某项需求的修改过程,但无法直接看到历次调整内容,则可能是由于未通过标准变更流程操作或未进入变更记录专属视图。以下是查看需求变更记录的具体步骤:
一、通过需求详情页进入变更历史
禅道将每次正式提交的变更保存为独立版本,并在需求详情页提供结构化对比入口。该方式可直观呈现字段级差异,适用于已走完“变更→评审”流程的需求。
1、在【产品】模块下,点击目标需求的名称,进入该需求的详情页面。
2、在页面下方导航栏中,找到并点击“变更”按钮。
3、系统将列出该需求所有已提交的变更记录,按时间倒序排列,每条记录显示变更人、变更时间及当前状态(如“已变更”“确认通过”等)。
4、点击任意一条变更记录,即可进入变更详情页,页面中部以左右分栏形式展示变更前 vs 变更后的内容对比,高亮标出被修改的标题、描述、验收标准及附件变动。
二、在需求列表中启用变更列筛选
当需批量识别哪些需求存在未合并或待评审的变更时,可在需求列表视图中开启变更状态标识列,快速定位目标需求,避免逐个点开排查。
1、进入【产品】-【用户需求】或【研发需求】列表页。
2、点击列表右上方的“列设置”按钮(齿轮图标)。
3、在弹出的列配置面板中,勾选“变更状态”选项,点击“确定”保存设置。
4、列表中将新增一列显示每条需求的当前变更状态,例如“变更中”“已变更”“激活中”等,支持按此列排序或筛选。
三、导出变更日志进行离线审计
对于合规审查、项目复盘或跨团队同步场景,可通过导出功能获取结构化变更日志文件,包含完整时间戳、操作人、字段名及新旧值,便于归档与第三方分析。
1、进入【产品】-【用户需求】列表页,使用顶部搜索框输入需求关键词,或通过状态筛选缩小范围。
2、勾选需导出的一条或多条需求记录(支持全选)。
3、点击列表右上方的“导出”按钮,选择导出格式为Excel(含变更历史)。
4、下载完成后,打开Excel文件,切换至名为“变更日志”的工作表,即可查看每条变更的详细字段级修改记录。
四、检查数据库原始变更快照(高级运维方式)
当界面级操作不可用(如权限受限、页面异常),且具备服务器访问权限时,可直接查询禅道后台数据库中的变更快照表,获取最底层的原始修改数据,适用于故障回溯与数据一致性验证。
1、使用数据库客户端连接禅道所用MySQL实例,登录账户需具备zt_storychanges表读取权限。
2、执行SQL查询语句:SELECT * FROM zt_storychanges WHERE story = [需求ID] ORDER BY date DESC;(将[需求ID]替换为目标需求的实际数字ID)。
3、结果集中field字段标明被修改的属性名(如title、desc、pri),old与new字段分别存储变更前后的原始值,date字段为精确到秒的时间戳。










