迁移数据清单用于把“要迁什么、从哪里来、落到哪里、怎么对应、由谁确认”逐行固定下来，适合在迁移准备阶段作为底表使用。本文提供一张可直接复制的空白表，并说明各字段填写口径、必填与选填的区分、一行完整示例，以及迁移过程中调整和维护清单的方法。
要点总览（TL;DR）
- 迁移数据清单按“数据对象—来源—目标—字段映射—附件与链接—增量策略—责任人”逐行登记，先复制空白表再填写。
- 字段映射建议写成“源字段名 → 目标字段名（转换规则）”，用户身份映射单独登记源账号、目标账号与用户组。
- 序号、数据对象、来源系统、来源位置、目标系统、目标对象、责任人、状态为必填；字段映射与用户身份映射按对象必填。
- 暂时无法确定的信息统一写“待确认”并注明确认人，迁移执行前完成闭环，不直接留空。
- 清单按阶段留存版本，状态与责任人变更同步记录，多人流转时可登记到协作工具中统一维护。
可复制空白迁移数据清单表
下表按“数据对象”分组，每个数据对象下可以有多行，分别登记不同来源对象或不同字段映射。复制到表格工具后，保留表头，按实际迁移范围增删行即可使用。
| 序号 | 数据对象 | 来源系统 | 来源位置/标识 | 目标系统 | 目标对象 | 字段映射与转换规则 | 附件与链接 | 用户身份映射 | 数据量估算 | 增量策略 | 责任人 | 状态 | 备注 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
使用顺序建议为：先复制空白表，再按数据对象分组填写，随后逐行补齐字段映射与附件信息，最后对照示例检查必填列是否完整。数据对象通常包括项目、工作项、状态与字段配置、附件、评论、页面、空间权限、用户与用户组等，具体范围以本次迁移方案为准。
清单字段说明：每个字段填什么
字段说明的作用是让不同填写人采用同一口径。下表逐列解释含义与写法，模板、说明和示例中的字段名称保持一致。
| 字段 | 填写内容 | 填写口径 |
|---|---|---|
| 序号 | 行号 | 按填写顺序编号，便于评审时引用具体行。 |
| 数据对象 | 本次迁移的一类数据 | 使用统一名称，如“工作项”“页面”“附件”“用户组”。同一对象的多行放在相邻位置。 |
| 来源系统 | 数据当前所在系统 | 写系统名称与实例，如“Jira 生产环境”“Confluence 知识库”。 |
| 来源位置/标识 | 数据在来源系统中的定位 | 写项目键、空间键、页面路径、筛选条件或对象 ID 范围，确保执行人能找到对应数据。 |
| 目标系统 | 数据迁入的系统 | 写目标产品与空间或项目名称，如“ONES Project 研发项目”“ONES Wiki 产品空间”。 |
| 目标对象 | 数据在目标系统中的承载对象 | 写目标对象类型，如“工作项”“Wiki 页面”“用户组”。与来源对象不是一一对应时，在此说明拆分或合并关系。 |
| 字段映射与转换规则 | 源字段到目标字段的对应关系 | 建议写成“源字段名 → 目标字段名（转换规则）”。转换规则包括枚举值对照、日期格式、必填校验、默认值处理。多个字段用分号分隔。 |
| 附件与链接 | 附件数量、存储位置与外链处理 | 登记附件数量或估算值、附件存放位置、外链是否保留、失效链接的处理方式。没有附件时写“无”。 |
| 用户身份映射 | 源账号与目标账号的对应 | 登记源账号、目标账号、所属用户组与权限角色。涉及权限继承时，注明权限来源是空间权限还是页面权限。 |
| 数据量估算 | 记录数、附件大小或页面数 | 写数量与单位，如“约 1.2 万条工作项”“附件约 8 GB”。用于安排迁移窗口和校验工作量。 |
| 增量策略 | 迁移窗口内新增和变更数据的处理方式 | 写明冻结写入的时间、补迁范围与补迁次数。具体同步机制以所用迁移工具的能力为准。 |
| 责任人 | 该行数据的确认与执行人 | 写姓名与角色，如“数据负责人”“业务确认人”。一行涉及多方确认时可写主责人并在备注中列协同人。 |
| 状态 | 该行当前处理进度 | 使用统一取值，如“待确认”“已确认”“迁移中”“已完成”“有问题”。 |
| 备注 | 例外情况与补充说明 | 记录不迁移的内容、特殊格式、待确认事项及确认时间。 |
必填与选填：哪些列不能空
必填列决定这一行是否可执行。缺少必填信息时，该行不能进入迁移执行，只能停留在确认阶段。选填列用于补充判断，不影响执行但影响校验和交接效率。
| 类别 | 字段 | 理由 |
|---|---|---|
| 必填 | 序号、数据对象、来源系统、来源位置/标识、目标系统、目标对象、责任人、状态 | 缺少任一项，执行人无法定位数据、确定落点或找到确认人。 |
| 必填（按对象） | 字段映射与转换规则 | 涉及字段结构变化的数据对象必须填写；整对象原样搬运时写“原样迁移”。 |
| 必填（按对象） | 用户身份映射 | 涉及权限、创建人、经办人等身份信息时必须填写；纯内容数据可写“不涉及”。 |
| 选填 | 数据量估算 | 用于排期参考，可在盘点后补充。 |
| 选填 | 增量策略 | 一次性停机迁移时写“停机迁移”，分批迁移时再细化。 |
| 选填 | 备注 | 用于记录例外，无特殊情况可留空。 |
遇到暂时无法确定的信息，统一填写“待确认”，并在备注中写明待确认内容和确认人，不直接留空。留空与“待确认”含义不同：留空表示该字段不适用，待确认表示信息尚未取得。迁移开始前，所有必填列中的“待确认”都应完成闭环。
填写示例：一行完整数据怎么填
以下示例为演示情景，用于说明各字段的写法，不代表真实项目数据。
| 字段 | 示例填写 |
|---|---|
| 序号 | 12 |
| 数据对象 | 工作项 |
| 来源系统 | Jira 生产环境 |
| 来源位置/标识 | 项目键 DEV，问题类型为“需求”和“缺陷” |
| 目标系统 | ONES Project 研发项目 |
| 目标对象 | 工作项（需求、缺陷） |
| 字段映射与转换规则 | Summary → 标题（原样）；Description → 描述（保留富文本）；Priority → 优先级（Highest→最高，High→高，Medium→中，Low→低）；Due Date → 截止日期（统一为 YYYY-MM-DD）；自定义字段“模块” → 模块（按对照表映射） |
| 附件与链接 | 附件约 320 个，随工作项迁移；外部链接 18 条，保留原地址，失效链接在备注中登记 |
| 用户身份映射 | 源经办人账号映射到目标账号；开发组映射到“研发组”用户组，权限角色为项目成员 |
| 数据量估算 | 约 1.2 万条工作项 |
| 增量策略 | 迁移前 1 天冻结写入，切换前补迁一次变更数据 |
| 责任人 | 张三（数据负责人）、李四（业务确认人） |
| 状态 | 已确认 |
| 备注 | “模块”字段存在 3 个历史值未在对照表中，已标注待确认，确认人李四 |
对照检查时，重点看三处：字段映射是否写成“源 → 目标（规则）”的形式；附件与链接是否给出数量和失效处理；身份映射是否落到账号与用户组。示例中的“待确认”也说明，已确认状态与个别待确认项可以并存，但待确认项必须在迁移执行前关闭。
清单的调整与维护方法
清单在迁移准备、执行和交接三个阶段都会被修改，维护规则应提前约定，避免不同版本混用。
- 按项目规模增删列：小型迁移保留核心列即可；涉及多系统、多团队时，增加“迁移批次”“校验方式”“确认时间”等列。删除列前确认没有必填信息只存在于该列。
- 按数据对象分组维护：新增对象时在表尾追加分组，不插入到已有分组中间，减少行号变动带来的引用错误。
- 状态与责任人同步更新：每次状态变化记录更新人和更新时间；责任人变更时保留原责任人信息在备注中，便于追溯。
- 版本留存：迁移前、迁移执行前、迁移完成后各留存一版，文件名带日期和版本号，交接时以最新确认版为准。
- 待确认项闭环：每周汇总“待确认”行，明确确认人和截止时间，避免临近迁移窗口集中处理。
当清单需要在多人之间流转时，可以把表格登记到协作工具中统一维护。以 ONES 的迁移场景为例，从 Jira 迁移到 ONES Project 时涉及用户、用户组、项目与系统配置、问题属性与属性值、附件、评论等内容，从 Confluence 迁移到 ONES Wiki 时涉及空间、页面、附件和权限结构。这些对象正好对应清单中的“数据对象”和“目标对象”列，责任人可以在同一工作项上更新状态、补充备注并留下确认记录，迁移前后各版本的清单也能随项目文档留存，便于交接和回溯。具体迁移范围和执行方式以实际迁移工具与实施方案为准。
常见问题
迁移数据清单里的“待确认”和留空有什么区别？
留空表示该字段对当前行不适用，例如纯内容数据不涉及用户身份映射时可以写“不涉及”，选填列没有补充信息时可以空着。“待确认”表示信息尚未取得，需要有人跟进。填写时在备注中写明待确认的具体内容和确认人，并在迁移执行前逐项关闭。必填列中的“待确认”未关闭前，该行不进入迁移执行。
来源系统和目标系统的对象不是一一对应时，清单怎么登记？
在“目标对象”列说明拆分或合并关系，例如来源的多个问题类型合并为同一目标工作项类型，或来源的一个对象拆到目标的两类对象。字段映射列按拆分后的目标对象分别写对应规则，必要时把一行拆成多行，每行只对应一个目标对象，便于执行人逐项核对。
附件很多时，清单里需要逐个登记附件吗？
通常按数据对象登记附件数量或估算值、存放位置和处理方式即可，不必逐个列出附件文件名。附件数量大或存在特殊格式时，可在备注中说明抽样检查范围。附件容量上限、格式支持与外链保留规则以实际迁移工具和实施方案为准，清单中先登记需求，执行前再确认可行性。
迁移窗口内还有新数据写入，清单的增量策略列怎么写？
写明冻结写入的时间点、补迁范围和补迁次数。一次性停机迁移可写“停机迁移”；分批迁移则写清每批的范围与切换前补迁一次变更数据。具体同步机制取决于所用迁移工具的能力，清单中记录的是业务侧的安排和确认人，执行方式在迁移方案中另行明确。
清单填写完成后，由谁确认才能进入迁移执行？
每行都应有数据负责人和业务确认人。数据负责人核对来源位置、字段映射和附件信息，业务确认人确认目标对象、字段取值和权限归属是否符合业务预期。状态从“待确认”变为“已确认”时记录更新人和更新时间，全部必填列闭环后再安排迁移窗口。
