迁移字段映射可以按五步推进：先界定源系统、目标系统和字段范围，再盘点源字段并建立映射表，随后按枚举、人员、日期、附件等类型定义转换规则，用小批量样本试迁移逐字段核对，最后明确停止与回退条件后执行正式迁移。整个过程以映射表为核心交付物，试迁移结果要回写到表中，映射规则确认后再进入正式迁移。
要点总览（TL;DR）
- 字段映射以映射表为核心：先界定源系统、目标系统与实体字段范围，再逐字段登记源字段、目标字段、转换规则和责任人。
- 盘点时要导出字段清单并统计取值分布，重点识别同名字段含义不同的情况，避免按名称直接对应。
- 枚举、人员、日期、附件要分别制定转换规则：枚举用对照表，人员用账号或邮箱匹配，日期统一时区，附件确认目标系统限制。
- 映射表定稿前用小批量代表性样本试迁移，逐字段比对并把差异回写到映射表，再确定历史数据与增量数据的迁移顺序。
- 提前设定停止与回退条件，关键字段无法可靠映射时暂停修正，正式迁移前确认试迁移数据已清理、映射表已定版。
先明确迁移方向与字段范围
字段映射的第一步是把边界定清楚。需要写明数据从哪个源系统迁到哪个目标系统，包括两边的产品名称与版本，以及本次迁移覆盖哪些业务对象。研发数据常见的对象包括需求、任务、缺陷、用例、迭代、版本等，每一类对象都要单独列出纳入范围，避免用“全部数据”这类模糊表述启动工作。
范围清单建议包含三项内容：源系统与目标系统的版本和对象范围；纳入映射的实体及其字段清单；明确排除的内容。排除项通常包括流程状态流转规则、插件或自动化行为、权限模型、通知配置等，这些属于流程与配置迁移的范畴，与字段内容映射分开处理。结果核验与切换管理同样不在本阶段展开，但需要在范围清单中标注为后续阶段，防止映射阶段被无限扩大。
字段清单要细到字段级，而不是只写实体名称。例如“缺陷”对象下要列出标题、描述、状态、优先级、严重程度、指派给、创建时间、附件等具体字段。对于源系统中存在但目标系统没有对应位置的字段，也要在清单中标记出来，作为后续决定“丢弃、合并还是放入扩展字段”的输入。范围清单完成后，由业务方和数据迁移负责人共同确认，作为后续盘点和映射的基准。
盘点源字段并建立映射表
盘点阶段的目标是拿到源系统每个字段的真实情况，而不只是字段名称。做法是从源系统导出字段清单，同时统计每个字段的取值分布：枚举字段有哪些实际取值、各占多少条；人员字段涉及多少个账号；日期字段的格式和时区；文本字段的平均长度和是否含富文本；附件字段的数量与大小分布。取值分布能暴露很多隐藏问题，例如某个状态字段在配置里只有五个选项，实际数据中却出现了历史遗留的第七种值。
映射表是这一阶段的核心产物，建议至少包含以下列：源实体、源字段、源字段类型、目标实体、目标字段、目标字段类型、转换规则、是否必填、责任人、备注。填写规则上，一行只对应一个源字段到一个目标字段的映射；一对多或多对一的映射拆成多行并注明关联关系；转换规则列写清“直接复制”“枚举对照”“按规则拼接”“丢弃”等具体动作，避免只写“转换”这类无法执行的描述。
| 列名 | 填写要求 | 示例 |
|---|---|---|
| 源实体 / 源字段 | 使用源系统中的对象名与字段标识 | 缺陷 / priority |
| 源字段类型 | 文本、枚举、人员、日期、附件等 | 枚举 |
| 目标实体 / 目标字段 | 使用目标系统中的对象名与字段标识 | 缺陷 / 优先级 |
| 转换规则 | 可直接执行的动作描述 | 按枚举对照表转换，未匹配值置为“中” |
| 是否必填 | 目标字段是否必填，必填字段需重点验证 | 是 |
| 责任人 | 该字段规则的确认人 | 缺陷模块负责人 |
同名字段含义不同是映射中最容易出错的地方。识别方法有三条：比对两个字段的取值分布，分布差异大往往意味着语义不同；查看字段在源系统中的使用说明和实际填写习惯；抽取若干条记录做人工判读。例如源系统的“优先级”按 P0–P3 划分且由测试人员填写，目标系统的“优先级”按高、中、低划分且由项目经理在排期时确定，两者名称相同但业务含义和填写角色都不同，就不能直接按名称对应，而应重新定义对照关系，必要时把源字段映射到目标系统的另一个字段或备注中。
分类处理枚举、人员、日期与附件映射
不同字段类型的转换方式差别很大，按类型分别制定规则比逐字段临时判断更可靠。枚举字段需要一张显式的对照表，左侧列源系统全部实际取值（包括历史遗留值），右侧列目标系统取值，中间写明无法匹配时的默认处理。状态和优先级是最典型的枚举字段，对照表要由业务方确认，因为状态语义往往与团队流程绑定。
| 源取值 | 目标取值 | 处理说明 |
|---|---|---|
| 新建 | 待处理 | 直接对应 |
| 处理中 | 进行中 | 直接对应 |
| 已解决 | 已完成 | 需确认目标侧“已完成”是否包含验证环节 |
| 挂起（历史值） | 待处理 | 历史遗留值，经业务确认归入待处理 |
人员字段的映射要解决身份识别问题。优先使用账号或邮箱作为匹配键，显示名仅作辅助，因为显示名可能重复或变更。映射前导出源系统涉及的全部用户列表，与目标系统用户列表做匹配，输出三类结果：匹配成功、目标系统不存在该用户、一个源用户对应多个目标用户。对未匹配用户，需要确定兜底方案，例如统一映射到某个占位账号并在迁移后人工补录，或先补建账号再迁移。人员字段还常出现在“指派给”“报告人”“关注者”等多值场景，多值字段要确认目标系统是否支持多选以及数量上限。
日期字段要统一时区和格式。先确认源系统存储的是本地时间还是 UTC，再确认目标系统的存储与展示方式，两者不一致时在转换规则中写明偏移量。日期格式按目标系统要求转换，例如从“2024/03/05 14:30”转为标准时间戳。对于只有日期没有时间的字段，要避免因时区换算导致日期偏移一天。
附件、链接和富文本需要单独设计保留方式。附件要确认目标系统对单文件大小、单条记录附件数量和文件类型的限制，超限文件提前制定拆分或外链方案。富文本中的图片若以链接形式嵌入，要确认链接在迁移后是否仍然可访问；正文中的提及、表情、代码块等格式，按目标系统的支持情况决定保留、降级为纯文本还是丢弃，并在映射表中逐项注明。
用小批量样本试迁移验证映射
映射表填写完成后不能直接全量执行，应先用小批量样本验证。样本要覆盖代表性情况：每种实体各取若干条，覆盖全部枚举取值、包含多值人员字段、包含附件和富文本、包含边界日期，并特意选取几条同名字段含义不同的记录。样本量以能覆盖上述情况为准，通常每类实体几十条即可，不必追求数量。
试迁移后逐字段比对，比对口径是“源值—转换规则—目标值”三者一致。比对方式可以是导出目标数据与源数据做字段级对照，也可以按字段抽样人工核对，关键字段和必填字段建议全量比对。发现差异时，区分是规则错误、数据异常还是目标系统限制，并把结论回写到映射表：规则错误修改转换规则，数据异常登记为个案处理清单，目标系统限制则调整保留方式。试迁移的价值在于让映射表在低成本条件下被修正，而不是证明映射一次就能成功。
增量数据与历史数据的处理顺序也要在试迁移阶段确定。常见做法是先迁移历史存量数据，再在切换窗口内迁移增量数据，两次迁移使用同一份映射表，避免规则漂移。若源系统在迁移期间仍在产生新数据，需要明确增量截取的时间点和重复数据的判定键，防止同一条记录被迁移两次。试迁移结束后，清理测试数据并保留差异记录，作为正式迁移前的检查依据。
在映射执行环节，如果目标系统是 ONES，工作项的类型、状态、优先级、人员等字段可通过导入功能按模板批量写入，导入前需按目标系统的字段定义准备数据文件，试迁移阶段可先导入少量样本核对字段落位是否符合映射表。具体可导入的对象与字段范围以目标系统当前版本的导入说明为准。
映射阶段的停止与回退条件
映射阶段需要预设停止条件，避免在规则未确认的情况下推进全量迁移。触发停止的典型情形包括：关键字段（如状态、指派给、创建时间）无法建立可靠映射；试迁移中某类字段的丢失或错位比例明显超出可接受范围；人员字段大量无法匹配且兜底方案未获确认；附件或富文本的保留方式与业务预期存在重大分歧。出现上述情形时暂停迁移，回到映射表修正规则，而不是带着已知问题继续执行。
回退方式要在试迁移阶段就验证。试迁移产生的数据应可识别、可清理，例如通过批次标识区分测试数据，确认清理后目标系统恢复到迁移前状态。正式迁移前保留源系统数据的完整备份和映射表版本记录，一旦正式迁移出现严重问题，可以依据备份和映射表重新执行。回退检查清单建议包含：试迁移数据是否已清理、映射表是否已定版、关键字段规则是否经业务确认、人员兜底方案是否确定、源数据备份是否可用。
正式迁移前的确认点是把上述检查项逐条核对并留痕，由数据迁移负责人和业务方共同签字确认映射表版本。确认通过后再进入正式迁移执行，映射阶段的交付物——范围清单、字段映射表、类型转换规则、试迁移差异记录和回退检查清单——一并归档，作为后续核验与切换阶段的输入。
常见问题
源系统里有些字段在目标系统中找不到对应字段，应该怎么处理？
先在范围清单中把这些字段标记出来，再按业务价值分三种方式处理：能合并到目标系统相近字段的，在映射表中写明合并规则；需要保留但无对应位置的，放入目标系统的扩展字段或备注；确认无保留价值的，标记为丢弃并记录原因。处理方式要由业务方确认，避免迁移后才发现关键信息缺失。
人员字段用显示名匹配可以吗？
显示名只适合作为辅助核对，不建议作为匹配键。显示名可能重复、变更或包含空格与特殊字符，容易造成错配。优先使用账号或邮箱做匹配，输出匹配成功、目标系统无此用户、一个源用户对应多个目标用户三类结果，再对未匹配用户确定兜底方案，例如统一映射到占位账号并在迁移后人工补录。
试迁移要取多少样本才算够？
样本量以覆盖情况为准，不以数量为准。每类实体取几十条，确保覆盖全部枚举取值、多值人员字段、附件与富文本、边界日期，并特意包含几条同名字段含义不同的记录。关键字段和必填字段建议全量比对，其余字段可抽样核对。样本能暴露规则问题即可，不必追求大规模。
迁移过程中源系统还在产生新数据，映射规则怎么保持一致？
历史存量与增量数据使用同一份映射表，避免两套规则造成数据口径不一致。先迁移历史数据，再在切换窗口内迁移增量数据，并明确增量截取的时间点和重复数据的判定键，防止同一条记录被迁移两次。映射表每次修改都要记录版本，增量迁移使用定版后的规则。
正式迁移前需要确认哪些事项？
逐条核对回退检查清单：试迁移数据是否已清理、映射表是否已定版、关键字段规则是否经业务确认、人员兜底方案是否确定、源数据备份是否可用。核对结果留痕，由数据迁移负责人和业务方共同确认映射表版本后再执行正式迁移，范围清单、映射表、转换规则和差异记录一并归档。
