研发数据迁移映射表的设计，核心是把源系统每个对象、字段与目标系统的落点、转换规则、责任人和核验方式逐行写清。可执行的做法是：先锁定源系统、目标系统、版本与迁移对象范围，再为每个字段定义源字段、目标字段、类型长度、取值转换、空值与默认值处理、唯一性约束和校验样例，最后用抽样数据回放验证映射是否成立，并为无法一一对应的字段预留挂起与回退处理。
要点总览（TL;DR）
- 先锁定源系统、目标系统、版本与迁移对象范围，用纳入/排除清单控制映射表边界，再进入字段填写。
- 映射表以“对象—字段”为最小行单位，必备列为对象、源字段、目标字段、数据类型、转换规则、空值处理、默认值、唯一性、责任人和状态。
- 转换规则归为直接映射、枚举转换、拼接拆分、计算派生、无对应挂起五类，同名不同义字段需补充语义说明并走枚举对照。
- 映射表填写完成后用抽样数据回放验证，样本覆盖每类对象、每种规则和空值、超长值、枚举边界等情形，差异回写到行级状态。
- 提前约定挂起与停止条件，关键字段错误率超阈值时回退修订映射表，迁移结果核验交由独立环节执行。
映射表要覆盖哪些迁移对象与范围
映射表的第一项工作不是填字段，而是划定边界。研发数据迁移涉及的对象类型多，如果一开始就把所有对象都放进同一张表，映射表会迅速膨胀，评审和验证都难以推进。建议先写一份迁移范围清单，明确源系统与目标系统的产品名称、版本号、部署环境，再列出本次纳入迁移的对象清单。
研发场景中常见的迁移对象包括：需求、任务、缺陷、用例、迭代、附件、评论、用户与组织。每类对象还要说明迁移的数据量级和时间窗口，例如“需求及其历史版本，近三年数据”。范围清单应同时给出纳入与暂不纳入两类结论，暂不纳入的对象要写明原因，例如历史归档数据保留只读、附件仅迁移近一年文件等。
同名对象在不同系统中的边界差异需要单独标注。例如“任务”在源系统中可能同时承载子任务和工时记录，在目标系统中子任务可能是独立对象类型；又如“迭代”在源系统中可能等同于版本发布，在目标系统中则是独立的时间盒。这类差异会直接影响后续字段映射，应在范围阶段就记录到对象级纳入/排除表中，作为映射表设计的输入。
| 对象 | 是否纳入本次迁移 | 边界说明 | 责任人 |
|---|---|---|---|
| 需求 | 纳入 | 含状态、优先级、负责人、关联任务 | 产品负责人 |
| 任务 | 纳入 | 子任务单独建表映射 | 研发负责人 |
| 缺陷 | 纳入 | 含复现步骤与关联用例 | 测试负责人 |
| 附件 | 部分纳入 | 仅迁移近一年文件，历史文件保留只读 | IT 负责人 |
| 历史归档迭代 | 暂不纳入 | 只读保留，不参与映射 | 项目经理 |
映射表需要哪些输入与前置依赖
映射表的每一行都要有依据，依据来自四类材料：源系统数据字典、目标系统对象模型、枚举值对照口径、用户与组织账号对应关系。缺少任何一类，映射表都会出现凭经验填写的情况，后续验证时难以判断对错。
源系统字段清单与数据字典应尽量导出为结构化文件，包含字段名、显示名、数据类型、长度、是否必填、取值范围和示例值。目标系统的对象模型与字段约束同样需要整理，重点记录必填字段、唯一性约束、长度上限和枚举可选值。两份材料放在一起，才能判断哪些字段可以直接对应、哪些需要转换。
状态、优先级、类型等枚举值的对照口径需要业务方确认。源系统的“已解决”在目标系统中可能对应“已完成”或“已关闭”，这类对应关系不能由技术人员单方面决定。用户与组织账号的对应关系也要提前梳理，包括离职人员账号、同名账号、跨部门调岗等情形。建议建立一份输入材料清单与缺口登记表，逐项标注已取得、待补充、存在争议三种状态，缺口未关闭前不进入正式映射填写。
- 源系统数据字典导出文件及导出时间
- 目标系统对象模型、字段约束与枚举值清单
- 状态、优先级、类型等枚举值对照表（业务方签字确认）
- 用户账号与组织架构对应关系表
- 业务方对关键字段含义的书面确认记录
映射表怎么设计：字段结构与填写规则
映射表建议以“对象—字段”为最小行单位，一行只描述一个源字段到一个目标落点的关系。必备列包括：对象、源字段、目标字段、数据类型、转换规则、空值处理、默认值、唯一性、责任人、状态。对象列用于分组筛选，状态列用于跟踪每行映射的完成度，例如待确认、已确认、已验证、挂起。
| 列名 | 填写方法 | 示例 |
|---|---|---|
| 对象 | 填写迁移对象类型 | 缺陷 |
| 源字段 | 源系统字段名与显示名 | bug_status / 缺陷状态 |
| 目标字段 | 目标系统字段名与显示名 | status / 状态 |
| 数据类型 | 源类型→目标类型，注明长度 | 枚举→枚举，目标限 8 个值 |
| 转换规则 | 规则类型与具体对照 | 枚举转换，见对照表第 3 行 |
| 空值处理 | 源为空时的处理方式 | 置为“待处理” |
| 默认值 | 目标必填但源无值时的取值 | 优先级默认“中” |
| 唯一性 | 是否参与唯一性约束及冲突处理 | 缺陷编号全局唯一，冲突挂起 |
| 责任人 | 该行映射的确认人 | 测试负责人 |
| 状态 | 待确认/已确认/已验证/挂起 | 已验证 |
转换规则建议归为五类，便于分工和验证。直接映射适用于字段含义、类型、取值都一致的情况；枚举转换适用于状态、优先级、类型等有限取值集合，需要逐值给出对照；拼接拆分适用于一个源字段拆成多个目标字段，或多个源字段合并为一个目标字段；计算派生适用于由多个字段计算得出的目标值，例如由创建时间和解决时间计算处理时长；无对应挂起适用于目标系统没有承接字段或语义无法对齐的情况，这类行必须写明挂起原因和后续处置人。
同名不同义的字段是映射表中最容易出错的部分。处理方式是在映射表中增加“语义说明”列，分别写清源字段和目标字段的业务含义，并在转换规则中注明是否需要附加条件。例如源系统的“优先级”按 P0–P3 分级，目标系统按“紧急、高、中、低”分级，两者名称相同但取值体系不同，必须走枚举转换并附对照表，不能按同名直接映射。对于一对多和多对一关系，建议在映射表中用“关系组”编号标记，同一组内的行一起评审、一起验证，避免只改其中一行造成关系断裂。
映射表本身需要版本管理。每次修订记录版本号、修订人、修订日期、变更行号和变更原因，已进入验证阶段的版本冻结，后续修改走变更登记。这样在抽样验证发现差异时，能够定位到具体版本和具体行。
用样例数据验证映射是否成立
映射表填写完成后，不能直接进入全量迁移，应先用抽样数据回放转换过程。抽样范围应覆盖每类对象、每种转换规则和每类边界情况，样本量按对象类型分配，关键对象可适当增加。样本要包含正常值、空值、超长值、特殊字符和枚举边界值，确保验证的是规则而不是个别幸运数据。
回放时按映射表逐行执行转换，把源数据、转换结果和目标系统预期值三者并列比对。重点校验四类问题：枚举转换是否有遗漏值或错配；空值和默认值是否按规则填充；字符串长度是否被截断以及截断后是否仍可识别；唯一性约束是否出现冲突。发现差异后，记录差异行号、源值、实际结果、预期结果和初步原因，并回写到映射表对应行的状态列，标记为待修正。
- 抽样覆盖每类对象和每种转换规则
- 样本包含空值、超长值、特殊字符和枚举边界
- 差异记录到行级，附源值、实际值、预期值
- 修正后重新回放同一批样本，确认差异关闭
- 验证通过由责任人在映射表状态列签字确认
验证通过的标准应事先约定，例如抽样行全部转换成功、枚举对照无遗漏、唯一性冲突为零或已全部挂起处理。达到标准后，映射表状态更新为已验证，作为后续迁移执行的依据。验证记录与差异回写清单应单独存档，便于迁移后核对。
映射失败时的挂起、回退与停止条件
映射过程中出现无法对应的情况是正常的，关键是提前定义处理路径。目标系统没有承接字段、源字段语义与目标字段冲突、枚举值无法归类时，相关行应标记为挂起，写明挂起原因、影响的对象范围和后续处置责任人。挂起不等于放弃，挂起数据要在迁移前给出明确结论：补充目标字段、调整业务口径、保留在源系统只读，或经业务方确认后丢弃并留痕。
需要停止推进的条件也应写清楚。例如关键字段映射错误率超过约定阈值，或唯一性冲突集中出现在同一对象类型，说明映射规则存在系统性问题，此时应暂停迁移，回退到映射表修订环节，而不是逐条修补后继续。回退的触发条件、审批人和重新验证要求应写入映射表附页，避免执行阶段临时决策。
迁移完成后的结果核验应作为独立环节，由未参与映射填写的人员或独立验证角色执行，核对对象数量、关键字段抽样一致性和挂起数据处置结果。映射表、验证记录和挂起清单共同构成迁移证据链。在映射表填写和验证记录需要多人协作维护时，可以把映射表作为文档放入 ONES 项目，按对象拆分工作项跟踪每行映射的确认与验证状态，让责任人、状态和差异记录在同一处流转，减少表格版本分散带来的核对成本。
常见问题
映射表里同名但含义不同的字段，除了加语义说明还需要做什么？
语义说明只解决“写清楚”的问题，还需要在转换规则列写明具体处理方式。若两侧取值体系不同，应走枚举转换并附逐值对照表；若一侧字段承载了额外业务含义，需注明附加条件或拆分规则。这类行建议单独标记，在评审和抽样验证时重点检查，避免按同名直接映射造成批量错配。
源系统字段在目标系统没有对应落点时，映射表应该怎么记录？
将相关行标记为挂起，写明挂起原因、影响的对象范围和后续处置责任人。挂起数据在迁移前要给出明确结论：补充目标字段、调整业务口径、保留在源系统只读，或经业务方确认后丢弃并留痕。挂起行同样保留在映射表中，不删除，便于后续追溯和统计。
抽样验证要抽多少数据才算够？
样本量按对象类型和转换规则分配，目标是覆盖每类对象、每种规则和每类边界情况，而非追求固定比例。关键对象可适当增加样本。样本中应包含正常值、空值、超长值、特殊字符和枚举边界值。验证通过标准事先约定，例如抽样行全部转换成功、枚举对照无遗漏、唯一性冲突为零或已全部挂起处理。
映射表在迁移执行阶段还会改动吗？
会，但需要走变更登记。已进入验证阶段的版本应冻结，后续修改记录版本号、修订人、修订日期、变更行号和变更原因。抽样验证发现差异时，先定位到具体版本和具体行，修正后重新回放同一批样本确认差异关闭，再更新状态。这样能避免执行阶段出现多份口径不一致的映射表。
映射表、验证记录和挂起清单如何协同管理？
三者共同构成迁移证据链，建议放在同一协作空间中维护。映射表按对象拆分跟踪每行映射的确认与验证状态，验证记录与差异回写清单单独存档，挂起清单记录处置结论和责任人。将映射表作为文档放入 ONES 项目、按对象拆分工作项跟踪状态，可以让责任人、状态和差异记录在同一处流转，减少表格版本分散带来的核对成本。
