工作流迁移映射表用来把源平台的工作流拆成可迁移的要素，逐条记录源端现状、目标端对应做法、迁移方式与验证结果，供评审、分工和上线检查使用。本文交付一份可直接复制到文档或表格工具中的空白主表与四张子表，并说明字段口径、必填规则、完整填写示例以及迁移期间和上线后的维护方法。填写人通常是负责工具替换或平台迁移的研发管理者、项目经理或配置管理员。
要点总览（TL;DR）
- 空白模板由一张主表和状态、字段、自动化规则、权限角色四张子表组成，主表固定十二列，子表通过“编号”与主表关联。
- 必填字段为编号、工作流名称、环节类型、源端现状、目标端对应、迁移方式、负责人；目标端对应未定时可标“待确认”并写明确认人。
- 源端现状与目标端对应按“对象+条件+动作”书写，迁移方式与验证结果使用固定取值，便于筛选、统计工作量和识别风险环节。
- 示例以一条缺陷处理审批流演示六类环节的填法，迁移方式、验证结果与备注三处相互呼应。
- 迁移期间按周更新并在评审前冻结，上线后保留整表作为配置基线，差异与不迁移的行单独整理成清单。
可复制的工作流迁移映射表（空白模板）
下面给出主表与四张子表的空白结构。使用时先复制表头到文档或在线表格，删除示例行后再逐行填写。主表一行对应一个迁移环节，子表用于记录状态、字段、自动化规则和权限角色的细粒度对应关系，通过“编号”与主表关联。
主表：工作流迁移映射主表
| 编号 | 工作流名称 | 所属项目或团队 | 源平台 | 目标平台 | 环节类型 | 源端现状 | 目标端对应 | 迁移方式 | 负责人 | 验证结果 | 备注 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| WF-001 | （示例行，填写后删除）缺陷处理流 | 产品研发组 | 源平台名称 | 目标平台名称 | 状态流转 | 当缺陷状态变为已解决时，流转至待验证 | 在目标平台配置同名状态并设置相同流转条件 | 等价改写 | 张三 | 待验证 | 需确认状态名称长度限制 |
表头固定为上述十二列，新增内容优先放入备注或对应子表，避免在主表中临时加列导致不同人填出的表无法合并。示例行仅用于说明格式，正式填写前整行删除。
子表一：状态映射子表
| 关联编号 | 源端状态名称 | 源端状态类别 | 目标端状态名称 | 目标端状态类别 | 进入条件 | 离开条件 | 备注 |
|---|---|---|---|---|---|---|---|
子表二：字段映射子表
| 关联编号 | 源端字段名称 | 字段类型 | 是否必填 | 目标端字段名称 | 目标端字段类型 | 取值或选项对应 | 备注 |
|---|---|---|---|---|---|---|---|
子表三：自动化规则子表
| 关联编号 | 规则名称 | 触发条件 | 执行动作 | 作用对象 | 目标端实现方式 | 验证结果 | 备注 |
|---|---|---|---|---|---|---|---|
子表四：权限与角色子表
| 关联编号 | 源端角色或用户组 | 可执行操作 | 作用范围 | 目标端角色或用户组 | 目标端权限配置 | 验证结果 | 备注 |
|---|---|---|---|---|---|---|---|
每个字段填什么：字段说明与取值口径
字段口径统一，表格才能被不同角色读懂并用于评审。以下逐列说明主表字段的含义与写法要求，子表字段按同样的“对象+条件+动作”原则书写。
| 字段 | 含义 | 填写口径 |
|---|---|---|
| 编号 | 环节的唯一标识 | 按“工作流缩写-序号”编制，如 WF-001，全表唯一且不复用 |
| 工作流名称 | 该环节所属的工作流 | 使用源平台中的正式名称，同一工作流的多行保持名称一致 |
| 所属项目或团队 | 工作流的使用范围 | 填写项目名或团队名，跨项目共用的工作流注明适用范围 |
| 源平台 / 目标平台 | 迁移的起点与终点 | 填写平台名称，必要时在备注补充版本 |
| 环节类型 | 该行记录的工作流要素类别 | 从固定取值中选择：触发条件、状态流转、审批、权限角色、字段、通知、自动化规则、扩展脚本 |
| 源端现状 | 源平台中该环节的实际做法 | 写清对象、条件、动作，例如“当缺陷状态变为已解决时，通知测试负责人”，避免只写功能名 |
| 目标端对应 | 目标平台中承接该环节的做法 | 同样写清对象、条件、动作；尚未确定时标注“待确认”并写明确认人 |
| 迁移方式 | 该环节的处理策略 | 从固定取值中选择：原样复制、等价改写、合并、拆分、放弃并说明替代做法 |
| 负责人 | 该环节的迁移责任人 | 填写具体人名，负责填写、验证和答复评审问题 |
| 验证结果 | 迁移后的核对结论 | 从固定取值中选择：待验证、通过、有差异、不迁移；有差异时在备注写明差异点 |
| 备注 | 补充信息 | 记录差异说明、确认人、关联需求或工单编号、限制条件 |
环节类型和迁移方式采用固定取值，是为了让表格可以按类型筛选和统计，例如统计“等价改写”的环节数量来估算配置工作量。源端现状与目标端对应两列建议成对书写，同一行读下来能直接看出“原来怎么做、之后怎么做”。
扩展脚本类环节需要单独留意。ONES 的 Jira 迁移方案建议先梳理实际使用的插件，再通过 ONES Project、Wiki、TestCase、流程自动化和开放能力进行功能匹配；已有定制场景需在迁移前逐项评估，不能假设所有插件都能一一对应。填写这类行时，源端现状应写明脚本或插件承担的具体动作，目标端对应写明承接方式或替代流程，无法承接的按“放弃并说明替代做法”记录。
必填与选填：哪些字段不能空
必填字段决定这张表能否被评审和交接。以下七个字段在任何情况下都不能为空，其余字段可按迁移阶段逐步补齐。
| 字段 | 要求 | 理由 |
|---|---|---|
| 编号 | 必填 | 子表关联、问题追踪和统计都依赖唯一编号 |
| 工作流名称 | 必填 | 没有名称无法判断环节归属，也无法按工作流汇总 |
| 环节类型 | 必填 | 决定该行由谁负责、按什么口径验证 |
| 源端现状 | 必填 | 是迁移的基准，缺失后无法判断目标端是否等价 |
| 目标端对应 | 必填（可暂标待确认） | 评审需要看到承接方案；未定时写“待确认”并注明确认人 |
| 迁移方式 | 必填 | 用于统计工作量和识别风险环节 |
| 负责人 | 必填 | 保证每个环节有人跟进和答复 |
选填字段包括所属项目或团队、源平台版本、验证结果、备注、关联需求或工单编号。所属项目在单团队迁移时可以后补；源平台版本在需要排查兼容问题时补充；验证结果在环节进入验证阶段前允许为空；备注和关联编号按需填写。
允许暂缺的字段需要按统一方式标记，避免空缺被误读为遗漏。目标端对应未定时填写“待确认（确认人：姓名）”；验证结果未开始时填写“待验证”；迁移方式尚未决策时填写“待评估”，并在备注写明评估时间点。任何暂缺都应有明确的补齐责任人和时间，评审时逐项核对。
填写示例：一条审批流的完整映射
以下示例演示一条缺陷处理审批流从源端到目标端的完整映射，覆盖触发条件、状态流转、审批节点、权限角色、通知与自动化规则。示例中的平台名称和人员为演示情景，实际填写时替换为真实信息。
主表示例行
| 编号 | 工作流名称 | 所属项目或团队 | 源平台 | 目标平台 | 环节类型 | 源端现状 | 目标端对应 | 迁移方式 | 负责人 | 验证结果 | 备注 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| WF-001 | 缺陷处理流 | 产品研发组 | 源平台A | 目标平台B | 触发条件 | 当缺陷被创建且严重级别为致命时，自动进入待处理 | 在目标平台配置创建时按严重级别自动流转至待处理 | 等价改写 | 张三 | 通过 | 严重级别选项需先完成字段映射 |
| WF-002 | 缺陷处理流 | 产品研发组 | 源平台A | 目标平台B | 状态流转 | 当缺陷状态变为已解决时，流转至待验证 | 配置同名状态并设置相同流转条件 | 原样复制 | 张三 | 通过 | — |
| WF-003 | 缺陷处理流 | 产品研发组 | 源平台A | 目标平台B | 审批 | 缺陷关闭前需测试负责人审批，审批通过后进入已关闭 | 配置关闭前审批节点，审批人取测试负责人角色 | 等价改写 | 李四 | 有差异 | 源端支持会签，目标端按单人审批实现，差异已由测试负责人王五确认 |
| WF-004 | 缺陷处理流 | 产品研发组 | 源平台A | 目标平台B | 权限角色 | 测试组成员可编辑缺陷状态，开发组成员只能评论 | 按角色配置状态编辑权限，开发组仅保留评论权限 | 原样复制 | 李四 | 待验证 | 需在权限配置完成后回归验证 |
| WF-005 | 缺陷处理流 | 产品研发组 | 源平台A | 目标平台B | 通知 | 缺陷被指派时，通知被指派人及其直属上级 | 配置指派事件通知，接收人取被指派人及其上级 | 等价改写 | 赵六 | 通过 | 上级关系依赖组织架构同步 |
| WF-006 | 缺陷处理流 | 产品研发组 | 源平台A | 目标平台B | 自动化规则 | 缺陷超过3天未更新时，自动提醒负责人 | 配置定时规则，按最后更新时间判断并发送提醒 | 等价改写 | 赵六 | 待验证 | 需确认目标平台定时规则的执行频率 |
子表示例行
| 关联编号 | 源端状态名称 | 源端状态类别 | 目标端状态名称 | 目标端状态类别 | 进入条件 | 离开条件 | 备注 |
|---|---|---|---|---|---|---|---|
| WF-002 | 已解决 | 处理中 | 已解决 | 处理中 | 开发人员提交解决说明 | 测试人员验证通过或退回 | — |
| WF-002 | 待验证 | 待处理 | 待验证 | 待处理 | 状态由已解决流转而来 | 验证通过进入已关闭，退回进入重新打开 | — |
| 关联编号 | 规则名称 | 触发条件 | 执行动作 | 作用对象 | 目标端实现方式 | 验证结果 | 备注 |
|---|---|---|---|---|---|---|---|
| WF-006 | 超时未更新提醒 | 缺陷超过3天未更新 | 向负责人发送提醒 | 未关闭的缺陷 | 定时规则按最后更新时间判断 | 待验证 | 确认执行频率后回归 |
示例中 WF-003 的迁移方式为“等价改写”，验证结果为“有差异”，备注写明了差异点和确认人，三者相互呼应。若某环节无法承接，迁移方式填“放弃并说明替代做法”，验证结果填“不迁移”，备注写明替代流程，例如“原会签审批改为单人审批加抄送”。示例的字段取值与第二节的字段说明、第三节的必填规则保持一致，实际填写时按同样口径处理。
调整与维护：迁移期间和上线后怎么改这张表
这张表在迁移期间是工作底稿，上线后是配置调整的依据，需要约定更新节奏和责任人，避免填完即弃。
迁移期间的更新节奏
建议按周更新：各环节负责人在每周固定时间前更新自己负责的行，配置管理员汇总后组织复核，重点核对“目标端对应”和“验证结果”两列。评审前冻结表格，冻结期间只允许修改备注和验证结果，新增环节走变更记录。冻结时间点与迁移里程碑对齐，例如配置完成前一周冻结主表，验证阶段只更新验证结果。
扩展方式
新增环节类型时，先在环节类型的固定取值中补充，再在对应子表中增加行，编号沿用“工作流缩写-序号”规则，不复用已删除的编号。需要新增子表时，保持关联编号列不变，其余列按“对象+条件+动作”的口径设计，并在表头注明适用阶段。字段口径一旦确定，迁移期间不随意改名，确需调整时在备注记录变更原因和生效时间。
上线后的归档与复查
上线后保留整张表作为配置基线，验证结果为“有差异”和“不迁移”的行单独整理成清单，作为后续配置调整和需求补充的输入。每次目标平台调整工作流配置时，回查对应编号的源端现状和验证结果，确认调整不破坏原有等价关系。归档时注明冻结日期、版本和负责人，便于后续接手的人理解当时的迁移决策。
在 ONES 承接迁移的场景中，工作流、字段配置和权限配置属于可迁移的系统配置范围，迁移后的状态流转、审批节点和自动化规则需要在目标平台中逐项核对。ONES 的 Jira 迁移方案围绕项目、工作项、状态、字段、流程、附件和历史记录进行迁移，映射表中的验证结果可以直接作为核对记录保留。对于依赖插件或扩展脚本的环节，迁移前先梳理实际使用清单并逐项评估功能匹配，评估结论写入备注，作为上线后复查的起点。
常见问题
源平台和目标平台之间只是部分工作流迁移，这张表要怎么缩小范围？
先按工作流名称筛选出本次迁移范围内的流程，再逐条拆成环节行。范围外的工作流不进入主表，可在备注或单独清单中记录“本期不迁移”，避免评审时被误认为遗漏。若同一工作流只有部分环节迁移，例如只迁移状态流转和审批、暂不迁移自动化规则，则在对应行把迁移方式填为“放弃并说明替代做法”，验证结果填“不迁移”，并写明过渡期的人工做法。
目标平台暂时无法确认某个环节能否承接，表格应该怎么填？
目标端对应一列填“待确认（确认人：姓名）”，迁移方式填“待评估”，并在备注写明需要确认的问题和计划确认时间。这类行在评审时单独列出，由确认人给出结论后回填。确认结论如果是无法承接，迁移方式改为“放弃并说明替代做法”，验证结果改为“不迁移”，备注写清替代流程。这样处理可以保留决策过程，后续接手的人能看懂当时的判断依据。
扩展脚本或插件类的环节，填写时要注意什么？
这类环节先梳理实际使用的脚本或插件清单，再逐项评估功能匹配，不预设一一对应。源端现状要写明脚本承担的具体动作，例如自动计算字段、批量同步状态或调用外部系统；目标端对应写明承接方式，可能是目标平台的原生配置、自动化规则，也可能是调整后的替代流程。ONES 的迁移方案建议先梳理实际使用的插件，再通过 ONES Project、Wiki、TestCase、流程自动化和开放能力进行功能匹配，已有定制场景需在迁移前逐项评估。评估结论写入备注，作为上线后复查的起点。
迁移完成后，这张表还需要保留吗？
建议保留。上线后这张表是配置基线，验证结果为“有差异”和“不迁移”的行单独整理成清单，作为后续配置调整和需求补充的输入。每次在目标平台调整工作流配置时，回查对应编号的源端现状和验证结果，确认调整不破坏原有的等价关系。归档时注明冻结日期、版本和负责人，便于后续接手的人理解当时的迁移决策。
多个团队同时填写时，如何保证表格能合并到一起？
关键是固定表头和取值口径。主表十二列不随意增删，新增信息放入备注或对应子表；编号按“工作流缩写-序号”编制，全表唯一且不复用；环节类型、迁移方式、验证结果都从固定取值中选择。各团队填写前先对齐工作流名称的写法，同一工作流的多行保持名称一致。汇总时按编号和环节类型排序检查，发现口径不一致的行退回填写人修正，再进入评审。
