迁移数据清单是一张逐条登记待迁移对象的表格，用来支撑盘点、字段映射、试迁移和切换核对。它通常包含五组信息：对象标识与来源、数据内容与字段、关联关系与附件、用户与权限归属、迁移批次与状态。本文提供一张可直接复制到表格工具的空白模板，并说明每列填写口径、必填规则、两条完整示例和维护方法。清单在ONES中也可承载为可协作的迁移记录，便于多人分工填写与状态跟踪。
要点总览（TL;DR）
- 迁移数据清单按实体类型分行，每行至少登记对象标识、来源定位、目标定位、字段映射、附件与链接处理、用户与权限归属、批次与状态。
- 必填列包括实体类型、对象标识、来源系统、来源定位、目标系统、字段映射、原账号/用户组、迁移批次、负责人和状态；缺失会阻断盘点、映射或权限核对。
- 来源定位与目标定位分开记录，字段映射按“源字段→目标字段：转换规则/默认值”填写，附件与链接分别写明数量、位置和处理方式。
- 清单按“待盘点→待映射→迁移中→已迁移→校验通过”推进，字段增删保留变更记录，清单存放位置保持唯一。
- 在ONES中可将每条记录承载为工作项，状态对应工作流状态，便于多人分工填写与按状态筛选待补齐和异常记录。
可复制空白迁移数据清单模板
先按实体类型拆分工作表，每张表使用同一套列结构。下面这张空白表可直接复制到Excel、在线表格或ONES工作项中填写。示例中保留一行表头，实际使用时按记录逐行追加。
| 序号 | 实体类型 | 对象标识 | 对象名称 | 来源系统 | 来源定位 | 目标系统 | 目标定位 | 字段映射与转换规则 | 附件与链接处理 | 原账号/用户组 | 目标账号/用户组 | 权限范围 | 迁移批次 | 负责人 | 状态 | 校验结果 | 备注 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
实体类型可按需求、缺陷、任务、文档页面、用户组等分别建表。同一张表内只登记一种实体，便于后续按类型分批执行和核对。列顺序可以调整，但同一批迁移中应保持各工作表列名一致，避免合并时错位。
清单字段说明：每一列记录什么
字段说明的作用是让产品、研发、测试、运维等不同角色按同一口径填写，合并清单时不出现同义不同名、定位方式不一致的问题。下表与空白模板逐列对应。
| 列名 | 记录内容 | 填写口径 |
|---|---|---|
| 序号 | 行号 | 按工作表内顺序编号，便于引用和核对，不随排序变化重复使用 |
| 实体类型 | 需求、缺陷、任务、页面、用户组等 | 使用统一枚举值，不写近义词；与工作表名称保持一致 |
| 对象标识 | 原系统中的唯一编号或键值 | 填写源系统原始ID，如问题Key、页面ID、账号ID；迁移后仍可凭此回查 |
| 对象名称 | 记录标题或显示名 | 照录源系统标题，便于人工识别；标题重复时以对象标识区分 |
| 来源系统 | 数据所在的原系统 | 写系统名称和实例，如“Jira 生产实例”，多实例时不可省略 |
| 来源定位 | 在原系统中的位置路径 | 记录项目、空间、目录、筛选条件等可回查路径，用于盘点与复核 |
| 目标系统 | 迁移后落入的系统 | 写目标产品及空间或项目名称，试迁移与正式迁移分别标注 |
| 目标定位 | 迁移后的落点 | 记录目标项目、工作项类型、页面路径；试迁移阶段可先填预期落点 |
| 字段映射与转换规则 | 源字段到目标字段的对应关系 | 按“源字段→目标字段：转换规则/默认值”记录，多字段用分号分隔；无法自动映射的单独注明处理方式 |
| 附件与链接处理 | 附件数量、存放位置、链接类型与处理方式 | 记录附件个数及迁移后位置；链接区分内部链接、外部链接、失效链接，分别写明保留、改写或剔除 |
| 原账号/用户组 | 源系统中的责任人与所属组 | 填写原账号名或用户组名，多人时全部列出 |
| 目标账号/用户组 | 迁移后对应的账号与组 | 填写映射后的账号；尚未开通的标注“待开通”，不空置 |
| 权限范围 | 该对象可见与可编辑范围 | 记录项目角色、空间权限或页面权限级别，用于迁移后权限核对 |
| 迁移批次 | 所属迁移轮次 | 使用统一批次编号，如“批次1-试迁移”“批次2-正式”，不写模糊时间 |
| 负责人 | 该条记录的跟进人 | 填写具体人名，负责补齐信息、执行迁移和确认校验结果 |
| 状态 | 当前处理阶段 | 使用统一状态值，如待盘点、待映射、迁移中、已迁移、校验通过、异常 |
| 校验结果 | 迁移后核对结论 | 记录字段、附件、权限的核对情况，异常时写明差异项 |
| 备注 | 补充说明 | 记录特殊情况，如历史数据缺失、需人工处理的事项 |
来源定位与目标定位要分开记录。只写目标位置，迁移后发现问题时无法回到原系统比对；只写来源位置，又无法确认数据是否落到正确位置。两列同时存在，盘点、试迁移和切换核对才能串成一条可追溯的链路。
必填与选填：哪些列不能空
必填列缺失会直接阻断对应环节，因此需要在填写规范中明确，而不是等到合并清单时再补。下表区分必填列与按需列。
| 列名 | 要求 | 缺失影响 |
|---|---|---|
| 实体类型 | 必填 | 无法按类型拆分工作表与安排批次 |
| 对象标识 | 必填 | 无法唯一识别记录，盘点与回查失去依据 |
| 来源系统 | 必填 | 多系统并行时无法判断数据出处 |
| 来源定位 | 必填 | 无法回查原记录，试迁移比对无法开展 |
| 目标系统 | 必填 | 无法确定落点，迁移执行缺少目标 |
| 字段映射与转换规则 | 必填（含自定义字段的实体） | 无法执行字段转换，迁移后数据可能错列或丢失 |
| 原账号/用户组 | 必填 | 无法建立身份映射，权限核对无法完成 |
| 迁移批次 | 必填 | 无法按轮次组织迁移与回滚 |
| 负责人 | 必填 | 记录无人跟进，异常无法闭环 |
| 状态 | 必填 | 无法判断进度，切换前无法确认完成度 |
| 对象名称 | 建议必填 | 不影响执行，但人工核对效率下降 |
| 目标定位 | 试迁移后必填 | 试迁移前可填预期落点，正式迁移后必须补齐实际落点 |
| 附件与链接处理 | 有附件或链接时必填 | 无附件无链接的记录可填“无”，不能空置 |
| 目标账号/用户组 | 有责任人时必填 | 账号未开通时填“待开通”，不能留空 |
| 权限范围 | 按需 | 涉及受限访问的对象必填，公开对象可简化 |
| 校验结果 | 迁移后必填 | 未校验的记录不能标记为完成 |
| 备注 | 选填 | 用于记录特殊情况，不影响执行 |
必填规则会随实体类型变化。需求、缺陷等工作项通常需要完整的字段映射和身份归属；文档页面更关注附件、图片和页面权限；用户组记录则以账号映射和权限范围为主。缺失必填项时，该条记录应停留在“待盘点”或“待映射”状态，由负责人补齐后再进入下一环节，不用默认值临时顶替。
填写示例：一条需求与一条缺陷记录
下面两条示例按前述字段说明填写，演示附件、链接与身份列的写法。示例中的系统名称、账号和编号为演示情景，实际填写时替换为真实信息。
| 列名 | 需求记录示例 | 缺陷记录示例 |
|---|---|---|
| 序号 | R-001 | B-001 |
| 实体类型 | 需求 | 缺陷 |
| 对象标识 | REQ-1024 | BUG-2087 |
| 对象名称 | 订单导出支持按时间范围筛选 | 导出文件在数据量较大时超时 |
| 来源系统 | Jira 生产实例 | Jira 生产实例 |
| 来源定位 | 项目 OMS / 需求池 / REQ-1024 | 项目 OMS / 缺陷池 / BUG-2087 |
| 目标系统 | ONES Project / 订单管理项目 | ONES Project / 订单管理项目 |
| 目标定位 | 订单管理项目 / 需求 / 待规划 | 订单管理项目 / 缺陷 / 待修复 |
| 字段映射与转换规则 | 优先级→优先级：P1映射为高；经办人→负责人：按账号映射表转换；自定义字段“业务线”→业务线：默认值“订单” | 严重程度→优先级：致命映射为紧急；复现步骤→描述：保留原文；环境→环境：值不变 |
| 附件与链接处理 | 附件2个，迁移至目标工作项附件区；内部链接1条指向REQ-1020，改写为目标工作项链接；外部链接1条保留原文 | 附件1个（日志文件），迁移至附件区；内部链接2条指向相关需求，改写为目标链接；失效链接1条剔除并记录 |
| 原账号/用户组 | zhang.li / 订单研发组 | wang.min / 订单测试组 |
| 目标账号/用户组 | zhangli / 订单研发组 | wangmin / 订单测试组 |
| 权限范围 | 项目成员可见可编辑 | 项目成员可见可编辑 |
| 迁移批次 | 批次1-试迁移 | 批次1-试迁移 |
| 负责人 | 李工 | 王工 |
| 状态 | 已迁移 | 校验通过 |
| 校验结果 | 字段与附件核对一致，链接可跳转 | 附件完整，失效链接已剔除并备注 |
| 备注 | 业务线字段为新增字段，需确认目标侧已创建 | 原缺陷含外部监控链接，保留原文 |
两条示例的写法与字段说明保持一致：字段映射按“源→目标：规则”记录，附件与链接分别写明数量、位置和处理方式，身份列同时给出原账号与目标账号。缺陷示例中的失效链接没有直接丢弃，而是在处理列和备注中记录，便于切换后追溯。
清单的调整与维护方法
清单在迁移推进中会持续变化，维护的重点是让状态、字段和版本始终对应同一批数据，避免多份表格并存造成口径漂移。
按实体类型拆分工作表
需求、缺陷、任务、文档页面、用户组各建一张工作表，表头保持一致。跨类型关联通过对象标识引用，不在同一行混填多种实体。拆分后每张表可独立安排批次和负责人，合并统计时按统一列名汇总。
批次推进时的状态更新规则
状态按“待盘点→待映射→迁移中→已迁移→校验通过”推进，异常记录单独标记为“异常”并写明差异项。每次批次执行后由负责人更新状态，校验结果未填写的记录不能改为“校验通过”。试迁移与正式迁移使用不同批次编号，同一记录在正式迁移时新增一行或更新批次列，保留试迁移结果供比对。
字段增删的变更记录方式
新增列时在表头下方增加一行变更说明，记录变更日期、变更人、新增列名和填写口径；删除列前先确认无记录依赖该列，删除后在变更记录中注明。字段映射规则调整时，同步更新字段说明表，避免模板与说明不一致。
清单版本与责任人维护
清单设置一名总体负责人，负责表头、枚举值和状态口径的统一；每张工作表设一名表负责人，负责本表记录补齐和状态更新。版本号按“主版本.次版本”记录，结构性调整升主版本，记录增补升次版本。清单存放位置保持唯一，历史版本归档不并行填写。
在ONES中，迁移清单可以作为工作项或文档承载：每条记录对应一个工作项，状态列对应工作流状态，负责人字段对应处理人，字段映射和附件处理写在描述或自定义字段中。这样盘点、映射、试迁移和校验结果在同一处更新，评审时按状态筛选即可看到待补齐和异常记录。ONES的Jira迁移方案覆盖项目、工作项、状态、字段、流程、附件和历史记录，Confluence迁移覆盖空间、页面、附件和权限结构，清单中的来源定位、字段映射和权限归属列可与这些迁移对象对应起来，作为迁移前盘点和迁移后核对的依据。
常见问题
迁移数据清单里，来源定位和目标定位能否只填一个？
建议两列都填，并在不同阶段使用不同口径。来源定位用于回到原系统回查记录，目标定位用于确认迁移后的落点。试迁移前目标定位可以先填预期落点，正式迁移后必须补齐实际落点。只填目标定位，迁移后出现字段或附件差异时缺少原系统比对依据；只填来源定位，则无法确认数据是否落到正确位置。
没有附件和链接的记录，附件与链接处理列怎么填？
填“无”，不要留空。留空会让后续核对无法区分“确实没有附件”和“漏填”。有附件时写明附件个数及迁移后位置；有链接时区分内部链接、外部链接和失效链接，分别写明保留、改写或剔除的处理方式。失效链接建议在处理列和备注中同时记录，便于切换后追溯。
目标账号尚未开通时，身份映射列如何处理？
填写“待开通”并保留原账号信息，不要空置。该条记录可以继续停留在“待映射”状态，由负责人跟进账号开通后再补齐目标账号。权限范围涉及受限访问的对象时同步填写，公开对象可简化记录。身份映射未补齐的记录不宜进入正式迁移批次。
试迁移和正式迁移的记录要放在同一行吗？
建议使用不同批次编号区分。可以在同一行更新批次列并保留试迁移结果，也可以为正式迁移新增一行，两种方式都要保证对象标识一致、可追溯。状态按批次推进更新，校验结果未填写的记录不能改为“校验通过”。
清单字段需要调整时，如何避免模板和字段说明不一致？
新增列时在表头下方增加变更说明，记录变更日期、变更人、新增列名和填写口径；删除列前确认无记录依赖该列，删除后在变更记录中注明。字段映射规则调整时同步更新字段说明表。结构性调整升主版本，记录增补升次版本，历史版本归档，不并行填写。
