研发数据迁移映射表把源系统中的对象、字段和取值规则逐项对应到目标系统，并记录转换规则、责任人和校验状态。本文提供三张可直接复制的空白表：对象清单表、字段映射表和取值对照表，并配套字段说明、必填判断、完整填写示例与维护规则，适合在迁移启动前建立基线、在迁移推进中持续更新。
要点总览（TL;DR）
- 模板由三张表组成：对象清单表确定迁移范围，字段映射表定义字段对应与转换规则，取值对照表处理枚举值替换。
- 字段映射表的必填列包括映射编号、对象编号、源字段、目标字段、数据类型、转换规则、必填判断、校验方法和状态；记录量级、迁移批次、备注可按阶段补填。
- 填写顺序是先对象后字段再枚举值，编号采用OBJ-三位序号与MAP-对象序号-字段序号，保证三张表能互相引用。
- 映射表在迁移期间按版本和变更记录维护，废弃字段保留行并标记已豁免，验收后连同校验结果归档复用。
可复制空白映射表模板
三张表分工明确：对象清单表管“迁什么”，字段映射表管“怎么对应”，取值对照表管“枚举值怎么换”。建议先填对象清单，再按对象逐行展开字段映射，最后补充枚举值对照。表格中的列名可直接复制到电子表格中使用。
表一：对象清单表
| 对象编号 | 对象名称 | 源系统 | 目标系统 | 记录量级 | 负责人 | 迁移批次 |
|---|---|---|---|---|---|---|
| OBJ-001 | ||||||
| OBJ-002 | ||||||
| OBJ-003 |
表二：字段映射表
| 映射编号 | 对象编号 | 源字段 | 目标字段 | 数据类型 | 转换规则 | 必填 | 校验方法 | 状态 |
|---|---|---|---|---|---|---|---|---|
| MAP-001-01 | OBJ-001 | |||||||
| MAP-001-02 | OBJ-001 | |||||||
| MAP-002-01 | OBJ-002 |
表三：取值对照表（枚举值映射）
| 对照编号 | 对象编号 | 字段名 | 源取值 | 目标取值 | 处理方式 | 备注 |
|---|---|---|---|---|---|---|
| VAL-001-01 | OBJ-001 | |||||
| VAL-001-02 | OBJ-001 | |||||
| VAL-002-01 | OBJ-002 |
字段说明：每一列填什么、为什么要有
字段说明与上面的模板逐列对应，填写时按同一口径执行，避免模板、说明和示例出现三种写法。
| 列名 | 填写口径 | 存在理由 |
|---|---|---|
| 对象编号 | 采用“OBJ-三位序号”，如OBJ-001；编号一经分配不再复用 | 让字段映射和取值对照都能引用同一对象，避免同名对象混淆 |
| 映射编号 | 采用“MAP-对象序号-字段序号”，如MAP-001-03 | 每条映射可被单独引用、评审和追踪状态 |
| 对象名称 | 写业务通用名称，如“需求”“缺陷”“测试用例” | 便于非技术人员阅读和确认范围 |
| 源系统 / 目标系统 | 写系统全称或团队通用简称，全文统一 | 明确迁移方向，避免多系统并行时张冠李戴 |
| 记录量级 | 写数量级或区间，如“约5万条”“10万级以上” | 用于评估迁移窗口和校验抽样比例 |
| 负责人 | 写具体人名，不写部门名 | 对象级问题有人可找 |
| 迁移批次 | 写批次编号或日期，如“B1”“2025-06” | 支持分批迁移和分批验收 |
| 源字段 | 写源系统中的字段标识，可附中文名，如“req_status（需求状态）” | 保证开发人员能直接定位字段 |
| 目标字段 | 写目标系统中的字段标识，命名风格与源字段保持一致 | 两侧写法统一，便于比对 |
| 数据类型 | 写迁移后的目标类型，如字符串、整数、日期、布尔、枚举 | 提前暴露类型不兼容问题 |
| 转换规则 | 用固定动词开头描述，常见写法见下 | 把口头约定固化为可执行规则 |
| 必填 | 填“是”或“否”，指目标字段是否允许为空 | 决定空值是否需要默认值或阻断迁移 |
| 校验方法 | 写“抽样比对”或“全量比对”，可附比对口径 | 明确验收方式，避免迁移后无据可查 |
| 状态 | 按约定取值填写，见第三节 | 反映每条映射的推进程度 |
转换规则的常见写法建议控制在以下五类，超出时在规则后补充说明：
- 直传：源字段值原样写入目标字段，如“直传”。
- 拼接：多个源字段合并，如“拼接：项目名称 + ‘-‘ + 需求标题”。
- 枚举转换：按取值对照表替换，如“枚举转换，见VAL-001”。
- 截断：目标长度不足时截取，如“截断至100字符”。
- 默认值：源值为空时填充，如“空值填‘未分类’”。
校验方法的选择依据数据量和风险：记录量级大、字段非关键的可用抽样比对，并写明抽样比例；涉及状态、金额、权限等关键字段的，建议全量比对。
必填与选填：哪些列不能空
必填列留空会直接阻断该条映射进入开发和校验，选填列留空则需要在备注或评审记录中说明原因。
| 列名 | 必填/选填 | 留空后果或适用场景 |
|---|---|---|
| 对象编号 | 必填 | 留空则字段映射无法关联对象，整行失效 |
| 对象名称 | 必填 | 留空导致范围无法确认 |
| 源系统、目标系统 | 必填 | 留空无法判断迁移方向 |
| 负责人 | 必填 | 留空则问题无人承接 |
| 记录量级 | 选填 | 迁移初期尚不掌握数量时可暂空，进入开发前补齐 |
| 迁移批次 | 选填 | 一次性迁移或批次未定时可空 |
| 映射编号 | 必填 | 留空则该条映射无法被引用和追踪 |
| 源字段、目标字段 | 必填 | 任一留空即无法执行映射 |
| 数据类型 | 必填 | 留空易在迁移时出现类型错误 |
| 转换规则 | 必填 | 直传也需写明“直传”，留空视为未定义 |
| 必填（目标字段是否允许为空） | 必填 | 留空无法判断空值处理方式 |
| 校验方法 | 必填 | 留空则该字段无验收依据 |
| 状态 | 必填 | 留空无法统计迁移进度 |
| 备注 | 选填 | 用于记录特殊约定、历史遗留问题 |
状态列建议统一使用以下取值，避免同一含义出现多种写法：
- 待确认：字段对应关系尚未与源系统负责人核对。
- 已确认：映射关系和转换规则已评审通过。
- 开发中：转换逻辑正在实现。
- 已校验：抽样或全量比对通过。
- 已上线：该字段随批次完成迁移并验收。
- 已豁免：经确认不迁移，需在备注写明原因。
填写示例：一条需求数据从源到目标
下面以“需求”对象为例，演示三张表如何联动。示例中的系统名称和字段为演示情景，实际填写时替换为真实字段。
对象清单表填写一行：
| 对象编号 | 对象名称 | 源系统 | 目标系统 | 记录量级 | 负责人 | 迁移批次 |
|---|---|---|---|---|---|---|
| OBJ-001 | 需求 | 旧研发管理平台 | 新研发管理平台 | 约5万条 | 张明 | B1 |
字段映射表围绕OBJ-001展开三行：
| 映射编号 | 对象编号 | 源字段 | 目标字段 | 数据类型 | 转换规则 | 必填 | 校验方法 | 状态 |
|---|---|---|---|---|---|---|---|---|
| MAP-001-01 | OBJ-001 | req_title（需求标题） | requirement_title | 字符串 | 直传 | 是 | 全量比对 | 已确认 |
| MAP-001-02 | OBJ-001 | req_status（需求状态） | requirement_status | 枚举 | 枚举转换，见VAL-001 | 是 | 全量比对 | 开发中 |
| MAP-001-03 | OBJ-001 | req_desc（需求描述） | requirement_desc | 字符串 | 截断至2000字符，空值填“无描述” | 否 | 抽样比对，抽10% | 待确认 |
取值对照表补充状态枚举的转换关系：
| 对照编号 | 对象编号 | 字段名 | 源取值 | 目标取值 | 处理方式 | 备注 |
|---|---|---|---|---|---|---|
| VAL-001-01 | OBJ-001 | req_status | 新建 | 待处理 | 直接映射 | |
| VAL-001-02 | OBJ-001 | req_status | 处理中 | 进行中 | 直接映射 | |
| VAL-001-03 | OBJ-001 | req_status | 已关闭 | 已完成 | 直接映射 | 与“已拒绝”合并前需业务确认 |
| VAL-001-04 | OBJ-001 | req_status | 已拒绝 | 已完成 | 合并映射 | 目标系统无独立拒绝状态 |
三张表的对应关系是：对象清单给出OBJ-001，字段映射用MAP-001-02引用该对象并指向VAL-001，取值对照再逐条列出枚举替换。任何一张表改动，都要同步检查另外两张表是否仍然一致。
调整与维护：映射表怎么随迁移推进更新
映射表在迁移期间是活文档，需要固定版本、固定变更入口，并在迁移结束后归档，才能被后续项目复用。
- 版本管理：表名或文件头标注版本号和日期，如“v1.2 / 2025-06-10”；每次评审通过后升版，旧版本保留只读。
- 变更记录：单独维护一张变更记录表，记录变更编号、日期、变更人、涉及映射编号、变更内容和审批人，做到每条改动可追溯。
- 新增对象：分配新的OBJ编号，追加到对象清单末尾，不插入已有编号之间；同步在字段映射表新增对应MAP行。
- 新增字段：在所属对象的最大字段序号后追加，如MAP-001-04；若字段涉及枚举，同步在取值对照表补充VAL行。
- 字段废弃：不删除行，将状态改为“已豁免”并在备注写明原因，保留历史记录。
- 评审节奏：每个迁移批次开始前和校验完成后各评审一次，重点核对状态列与校验方法是否匹配。
- 归档复用：迁移验收后，将最终版本连同变更记录、校验结果一并归档；后续同类迁移可复用对象清单和转换规则，字段对应关系需重新核对。
当映射表行数增多、多人并行填写时，可以把对象清单和字段映射表作为工作项导入协作工具中跟踪。以ONES为例，可将每个对象或每条映射建为工作项，用状态字段对应“待确认、已确认、开发中、已校验、已上线”，负责人和迁移批次作为字段维护，校验结果以附件或关联文档留存，评审记录随工作项流转，减少表格多版本并存带来的口径不一致。
常见问题
迁移过程中发现源系统字段含义与最初理解不一致，映射表应该怎么改？
先不要直接改字段映射行，而是在变更记录中登记问题，注明涉及的映射编号和原理解偏差。确认新口径后，更新该行的转换规则或校验方法，同时检查取值对照表是否需要补充枚举值。若该字段已进入开发或校验，状态回退到“待确认”，重新评审后再推进。这样能保留修改痕迹，避免已迁移数据与表格口径脱节。
目标系统没有与源字段对应的字段，映射表里怎么记录？
在字段映射表中保留该源字段所在行，目标字段列填写目标系统中承担相近含义的字段，转换规则写明合并、截断或丢弃的具体处理方式；确实不迁移的，将状态标为“已豁免”，并在备注写明原因和业务确认人。不要直接删除行，否则后续核对源数据范围时缺少依据。
映射表行数很多、多人同时填写时，怎样避免版本混乱？
可以按对象拆分填写责任，每个负责人只维护自己对象的字段映射行，由一人统一汇总和升版。表头固定版本号与日期，变更记录单独维护。若团队已在协作工具中管理迁移任务，可把对象或映射行建为工作项，用状态字段对应映射状态，负责人和批次作为字段维护，校验结果以附件留存，减少多份表格并存。
一次性迁移和分批迁移，映射表的填写重点有什么不同？
一次性迁移可以暂空迁移批次列，把重点放在字段对应关系和校验方法上；分批迁移需要为每个对象明确批次，并在每批开始前评审该批涉及的映射行，校验完成后及时更新状态。分批迁移时，取值对照表也要按批次核对，避免同一枚举值在不同批次出现不同处理方式。
迁移完成后映射表还有复用价值吗？
有。验收后的最终版本连同变更记录和校验结果一起归档，可作为数据来源与目标系统对应关系的历史依据。后续同类迁移可以复用对象清单结构和转换规则写法，但字段对应关系需要按新系统重新核对，不能直接照搬。
