研发数据迁移映射表是一张逐字段登记“来源对象—来源字段—目标对象—目标字段—转换规则—校验方式”的对照表，回答的是“每个字段怎么搬”。它和迁移数据清单分工不同：清单确定搬哪些数据、有多少条，映射表确定每条数据里的每个字段落到哪里、如何转换。下面给出一张可直接复制填写的空白模板，并说明字段含义、必填要求、填写示例与维护方法。
要点总览（TL;DR）
- 研发数据迁移映射表是一张逐字段登记来源与目标对应关系的对照表，核心字段覆盖映射编号、来源与目标对象字段、类型转换与取值转换规则、必填与默认值处理、关联关系、负责人、状态与校验结果。
- 映射编号、来源与目标字段、转换规则、必填与默认值处理、负责人和状态属于必填项；迁移批次、字段类型、关联关系、校验结果按迁移规模与阶段补充。
- 迁移数据清单确定搬哪些数据、有多少条，映射表确定每个字段怎么搬；先圈定范围再逐字段编制映射，两张表共用对象名称与批次编号。
- 模板可按对象类型拆分工作表，新增字段先登记为待确认，已校验行修改后回退重验，迁移完成后连同对照表与校验结果一并归档复用。
可复制空白映射表模板
下表为空白模板，列名与后文字段说明、填写示例保持一致。复制到电子表格后，建议冻结首行、为“状态”列设置下拉选项，并按对象类型分工作表存放。
| 映射编号 | 迁移批次 | 来源系统 | 来源对象 | 来源字段 | 来源字段类型 | 目标系统 | 目标对象 | 目标字段 | 目标字段类型 | 字段类型转换规则 | 取值转换规则 | 必填与默认值处理 | 关联关系映射 | 负责人 | 状态 | 校验方式 | 校验结果 | 备注 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
一行只登记一个字段的映射关系。同一来源字段拆到多个目标字段时，拆成多行并共用同一组来源信息；多个来源字段合并到一个目标字段时，同样分行登记并在“取值转换规则”中写明合并逻辑。
核心字段逐项说明
模板的列按“定位—来源—目标—转换—关系—责任—验证”的顺序排列，填写时从左往右推进，前一列确认后再填后一列，可以减少返工。
定位类字段：映射编号与迁移批次
映射编号是每行的唯一标识，建议采用“批次号-对象缩写-序号”的格式，例如“M01-REQ-007”，便于在问题讨论和校验记录中直接引用。迁移批次标识这行映射属于哪一次迁移执行，当迁移分多批进行或需要回滚重跑时，批次号能把字段映射与具体执行记录对应起来。批次号一旦启用，后续新增行必须沿用同一编码规则。
来源侧字段：系统、对象、字段与类型
来源系统写清数据来自哪个工具或数据库，来源对象写清业务实体，例如需求、缺陷、任务、测试用例、页面文档。来源字段填写原始字段名，尽量保留系统内的技术名或英文标识，避免只写中文显示名造成歧义。来源字段类型记录文本、单选、多选、日期、数值、用户、附件等类型，它是判断是否需要类型转换的依据。
目标侧字段：系统、对象、字段与类型
目标侧与来源侧一一对应填写。目标字段要写到具体字段，不能只写“标题字段”这类笼统描述；目标字段类型以目标系统的实际配置为准。来源与目标对象名称不同时，在备注中说明对应依据，例如“来源需求对应目标工作项类型‘需求’”。
转换规则：字段类型与取值
字段类型转换规则处理格式层面的变化，例如日期格式从“YYYY/MM/DD”改为时间戳、多选字段拆成多个标签、富文本转为纯文本并保留换行。取值转换规则处理业务含义层面的变化，例如来源状态“待处理”映射为目标状态“未开始”，来源优先级“P0”映射为目标优先级“最高”。取值转换建议单独维护一张枚举对照表，映射表中引用对照表编号，避免同一规则在多行重复描述且口径不一。
必填、默认值与空值处理
这一列记录目标字段的填写约束及来源数据缺失时的处理方式。常见写法包括“目标必填，来源为空时填‘未分类’”“来源为空则留空”“来源为空时取创建人”。空值处理必须逐字段明确，否则迁移执行时容易出现大批量校验失败或产生无意义的默认值。
关联关系与父子层级映射
用于登记对象之间的引用关系，例如缺陷关联的需求、子任务与父任务、页面与父页面、评论与所属工作项。填写时写明关联的目标对象和匹配键，例如“按来源需求编号匹配目标需求的工作项编号”。层级关系要说明层级深度是否保留、跨层级引用如何处理。
负责人、状态与校验结果
负责人是该行映射的确认人，通常由熟悉来源系统和目标系统配置的成员共同确认。状态建议使用“待确认、已确认、执行中、已校验、有差异”几个固定值，便于筛选。校验方式写明核对手段，例如抽样比对、总数比对、枚举值全覆盖检查；校验结果记录实际结论和差异数量。迁移批次较多时，可以把映射行登记为工作项，用状态字段推进确认与校验，并在同一处关联差异记录；ONES 的工作项与字段配置可用于承载这类跟踪，具体承载方式以项目实际配置为准。
必填与选填字段的划分
必填的判断标准是：缺少该信息，迁移执行人员无法确定数据去向或无法判断转换是否正确。以下划分适用于常规规模的项目，可按迁移规模调整。
| 字段 | 要求 | 缺失后果或适用场景 |
|---|---|---|
| 映射编号 | 必填 | 无法唯一引用该行，校验差异难以定位 |
| 来源系统、来源对象、来源字段 | 必填 | 无法定位原始数据，映射无法执行 |
| 目标系统、目标对象、目标字段 | 必填 | 无法确定落库位置 |
| 字段类型转换规则 | 必填（同类型可写“无需转换”） | 类型不一致时导致导入失败或数据截断 |
| 取值转换规则 | 必填（无枚举可写“原值保留”） | 状态、优先级等枚举错位，业务含义失真 |
| 必填与默认值处理 | 必填 | 空值导致批量校验失败或产生错误默认值 |
| 负责人 | 必填 | 映射无人确认，问题无法闭环 |
| 状态 | 必填 | 无法区分已确认与待确认行 |
| 迁移批次 | 选填，多批次迁移时必填 | 单批次一次性迁移可省略 |
| 来源字段类型、目标字段类型 | 选填，存在类型差异时必填 | 用于判断转换工作量 |
| 关联关系映射 | 选填，存在引用或层级时必填 | 遗漏会导致关联丢失 |
| 校验方式、校验结果 | 选填，进入校验阶段后必填 | 用于记录验证结论 |
| 备注 | 选填 | 记录对象对应依据、例外说明 |
迁移规模较小时，可以合并“来源字段类型”和“目标字段类型”为一列说明；字段数量多、涉及多系统对接时，建议把枚举对照表、关联关系单独拆表，映射表只保留引用编号，降低单表维护成本。
完整填写示例
示例背景：某团队将旧研发管理系统中的“需求”数据迁移到新系统的工作项“需求”类型。以下为演示数据，字段名与模板保持一致。
| 映射编号 | 迁移批次 | 来源系统 | 来源对象 | 来源字段 | 来源字段类型 | 目标系统 | 目标对象 | 目标字段 | 目标字段类型 | 字段类型转换规则 | 取值转换规则 | 必填与默认值处理 | 关联关系映射 | 负责人 | 状态 | 校验方式 | 校验结果 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| M01-REQ-001 | M01 | 旧研发系统 | 需求 | req_title | 文本 | 新系统 | 需求 | 标题 | 文本 | 无需转换 | 原值保留，超长截断至200字符 | 目标必填，来源为空时填“未命名需求” | 无 | 张三 | 已校验 | 抽样50条比对 | 一致 |
| M01-REQ-002 | M01 | 旧研发系统 | 需求 | req_desc | 富文本 | 新系统 | 需求 | 描述 | 富文本 | 保留段落与列表，去除内嵌脚本 | 原值保留 | 允许为空 | 无 | 张三 | 已校验 | 抽查图片与列表 | 一致 |
| M01-REQ-003 | M01 | 旧研发系统 | 需求 | req_status | 单选 | 新系统 | 需求 | 状态 | 单选 | 无需转换 | 按枚举对照表E01：待处理→未开始，进行中→进行中，已完成→已完成，已关闭→已关闭 | 目标必填，来源为空时填“未开始” | 无 | 李四 | 已校验 | 枚举值全覆盖检查 | 一致 |
| M01-REQ-004 | M01 | 旧研发系统 | 需求 | req_owner | 用户 | 新系统 | 需求 | 负责人 | 用户 | 按账号对照表匹配用户ID | 原值保留 | 目标必填，匹配失败时填项目管理员 | 无 | 李四 | 已校验 | 账号匹配率统计 | 匹配率98%，2条转管理员 |
| M01-REQ-005 | M01 | 旧研发系统 | 需求 | req_priority | 单选 | 新系统 | 需求 | 优先级 | 单选 | 无需转换 | 按枚举对照表E02：P0→最高，P1→高，P2→中，P3→低 | 目标必填，来源为空时填“中” | 无 | 王五 | 已校验 | 枚举值全覆盖检查 | 一致 |
| M01-REQ-006 | M01 | 旧研发系统 | 需求 | req_parent_id | 文本 | 新系统 | 需求 | 父需求 | 关联工作项 | 文本ID转为工作项引用 | 原值保留 | 允许为空 | 按来源需求编号匹配目标需求的工作项编号，保留两级父子层级 | 王五 | 已校验 | 层级抽样核对 | 一致 |
示例中，状态与优先级两行展示了取值转换规则的写法，父需求一行展示了关联关系映射的写法。实际填写时，枚举对照表和账号对照表应作为独立附表维护，映射表只引用编号。
映射表与迁移数据清单的区别
两张表回答不同问题，不能互相替代。迁移数据清单回答“搬哪些数据、有多少条”，通常按对象类型列出数据范围、筛选条件、记录数量、附件与评论是否包含、排除项；映射表回答“每个字段怎么搬”，逐字段登记来源与目标的对应关系和转换规则。
| 对比项 | 迁移数据清单 | 迁移映射表 |
|---|---|---|
| 回答的问题 | 搬哪些数据、有多少条 | 每个字段怎么搬、如何转换 |
| 粒度 | 对象与数据集 | 字段 |
| 主要用途 | 确定范围、估算工作量、安排批次 | 指导转换执行、支撑校验 |
| 典型内容 | 对象类型、筛选条件、记录数、附件范围 | 来源与目标字段、转换规则、关联关系 |
在流程上，先由数据清单圈定范围与数量，再针对范围内的对象逐字段编制映射表，最后按映射表执行转换并校验。只做清单不做映射，执行时字段对应关系靠口头约定，容易出现枚举错位、必填字段为空、关联丢失；只做映射不做清单，无法确认数据总量和排除项，校验时缺少比对基数，也难以估算迁移批次和工期。两张表应使用同一套对象名称和批次编号，便于交叉核对。
模板的调整与维护方法
迁移范围在实施过程中常会变化，映射表需要随之更新，同时保留可追溯的记录。
按对象类型拆分工作表
需求、缺陷、任务、测试用例、页面文档的字段差异较大，建议每类对象一个工作表，表头保持一致，另加一张汇总表统计各表行数与状态分布。对象数量少时也可以单表存放，通过“来源对象”列筛选。
新增字段的登记与复核
发现清单范围内存在未登记字段时，先补登映射行，状态置为“待确认”，由来源侧与目标侧负责人共同确认转换规则后再改为“已确认”。新增字段若涉及新的枚举值，同步更新枚举对照表，避免只改映射表造成口径不一致。
版本与变更记录
每次调整保留版本号与变更说明，记录变更行、变更原因、确认人和日期。已校验的行被修改后，状态应回退为“待确认”，重新校验后才能恢复。批次执行期间冻结已确认行，变更走单独记录。
归档与复用
迁移完成后，将映射表、枚举对照表、账号对照表和校验结果一并归档，标注适用的来源系统版本与目标系统配置。后续同类系统迁移可复用字段对应关系和转换规则，但需重新核对目标系统字段配置是否变化，不能直接套用旧结论。
常见问题
迁移范围临时扩大，映射表应该怎么补登才不影响已确认的部分？
先按新增对象或新增字段补登映射行，状态统一置为“待确认”，由来源侧与目标侧负责人共同确认转换规则后再改为“已确认”。已校验的行保持原状态，不因新增行而整体回退；如果新增字段引入了新的枚举值，同步更新枚举对照表并记录变更行、原因、确认人和日期。批次执行期间冻结已确认行，新增内容走单独变更记录，避免执行口径中途变化。
来源字段和目标字段类型一致时，转换规则列可以空着吗？
建议写明“无需转换”，不要留空。留空会让执行人员难以区分“已确认无需转换”和“漏填未确认”两种情况，校验时也无法判断该行是否经过评估。取值转换规则同理，没有枚举变化时写“原值保留”。这类显式标注成本很低，却能减少执行阶段的反复确认。
多个来源字段合并成一个目标字段，或者一个字段拆到多个目标字段，映射表怎么登记？
一行只登记一个字段的映射关系。多个来源字段合并到一个目标字段时，分行登记并在“取值转换规则”中写明合并逻辑，例如拼接顺序与分隔符；一个来源字段拆到多个目标字段时，拆成多行并共用同一组来源信息。这样每行的转换规则都能独立确认和校验，出现差异时也能定位到具体字段。
映射表里的状态和校验结果，用电子表格管理还是放进研发管理工具跟踪更好？
取决于迁移规模和参与人数。单批次、参与人少的迁移，电子表格加固定状态值即可满足筛选和统计。多批次、跨团队确认时，把映射行登记为工作项、用状态字段推进确认与校验，并在同一处关联差异记录，能减少表格版本分散的问题。ONES 的工作项与字段配置可用于承载这类跟踪，具体承载方式以项目实际配置为准。
迁移完成后映射表还有复用价值吗？
有。归档时应把映射表、枚举对照表、账号对照表和校验结果放在一起，并标注适用的来源系统版本与目标系统配置。后续同类系统迁移可以复用字段对应关系和转换规则，减少重新梳理的工作量；但目标系统的字段配置可能已经变化，复用前需重新核对字段是否存在、类型是否一致、枚举值是否增减，不能直接套用旧结论。
