迁移字段映射可以按“定范围—备输入—建映射表—定转换规则—试迁移比对—核验留档”的顺序推进，每个字段都要在映射表中写明目标字段、转换规则和默认值。本文聚焦需求、任务、缺陷、用例、迭代等对象的数据内容字段，流程状态、插件行为和整体切换不在本篇展开。
要点总览（TL;DR）
- 字段映射按“定范围—备输入—建映射表—定转换规则—试迁移比对—核验留档”推进，每个字段写明目标字段、转换规则和默认值。
- 同名字段含义不同时以业务定义为准重新命名或拆分，不能按字段名直接对齐；一对多、多对一和无对应字段都要写明判断依据。
- 转换规则要覆盖类型转换、长度截断、特殊字符，并区分空值、空字符串和从未设置三种状态。
- 试迁移抽样覆盖各对象、各枚举取值、边界长度和空值，差异按映射错误、规则缺失、目标限制、源数据质量归类后修订并二次试迁移。
- 关键字段无归属、枚举无法对应且影响统计口径、源数据大面积异常时应暂停，恢复映射表上一版本并重新确认口径。
先定来源、目标与映射范围
字段映射开始前，先把迁移方向固定下来：从哪个源系统迁到哪个目标系统，两边各自是什么版本。版本信息决定了字段清单的获取方式，也影响后续试迁移时目标系统对字段长度、类型和必填约束的判断。方向一旦写错，后面整张映射表都会作废，因此这一步需要形成书面记录并由项目负责人确认。
接着列出纳入映射的对象清单。研发数据迁移通常涉及需求、任务、缺陷、用例、迭代等对象，每个对象都要单独建一张映射表，不能把不同对象的字段混在一张表里。对象清单要写清对象名称、源系统中的数量级、是否全量迁移，以及是否存在只迁部分数据的过滤条件。
本阶段只处理数据内容字段，也就是字段里存的值本身。流程状态与流转规则、插件与扩展行为需要另列一份清单，交给对应的工作流迁移或扩展评估环节处理。把这两类内容混进字段映射表，会让映射表变得难以评审，也容易在试迁移时把流程配置问题误判成字段映射问题。
最后写明不纳入本次映射的字段及原因。常见排除项包括系统自动生成的审计字段、源系统中已废弃但仍有历史值的字段、目标系统中没有业务用途的临时字段。排除项要写清字段名和排除理由，避免批量迁移后被追问“为什么这个字段没迁”。这一步的交付物是一页迁移范围说明，包含方向、系统版本、对象清单和排除项。
映射前要准备哪些输入
字段映射的质量取决于输入材料是否齐全。开工前至少要拿到五类材料，缺项时要标注责任人和补齐方式，不能靠猜测填表。
| 输入材料 | 关键内容 | 缺项时的处理 |
|---|---|---|
| 源系统字段清单 | 字段名称、字段类型、是否必填、枚举取值列表、字段用途说明 | 由源系统管理员导出，缺失用途说明的字段标记为待确认 |
| 目标系统字段清单 | 可写字段、字段类型、长度限制、必填约束、枚举字典 | 以目标系统实际配置为准，不能只参考文档 |
| 业务口径确认人 | 关键字段含义的解释权归属，如“优先级”“严重程度”的业务定义 | 按对象指定确认人，无法确认的字段进入待定清单 |
| 样例数据 | 覆盖各对象、各枚举取值、边界长度和空值的导出数据 | 导出前完成脱敏，敏感字段用占位值替换 |
| 映射表模板 | 统一的列结构和版本记录方式 | 由迁移负责人提供模板，各对象映射表沿用同一结构 |
样例数据导出要提前约定脱敏要求。涉及客户信息、个人信息或商业敏感内容的字段，在导出阶段就替换为占位值，试迁移比对时只核对结构和规则是否正确，不核对真实内容。映射表模板要带版本号，每次修订记录修改人、修改时间和修改原因，后续试迁移发现的问题才能追溯到具体版本的哪一行。
这一步的交付物是输入清单与责任人对照表，逐项标注已具备、缺失和补齐方式。缺失项中影响关键字段判断的，要在建表前补齐；只影响边缘字段的，可以带着待定状态进入映射表，在试迁移阶段再确认。
字段映射表怎么建：逐字段确定对应关系
映射表按对象分别建立，每一行对应一个源字段，列结构建议包含：源对象、源字段、源类型、目标对象、目标字段、目标类型、转换规则、默认值、是否必填、负责人。转换规则列写具体动作，例如“直接复制”“枚举值对照”“截断至200字符”“拼接至描述字段”，不写“按需处理”这类无法执行的描述。
同名字段含义不同是最容易出错的情形。两个系统都有“优先级”字段，源系统的取值可能是“紧急、高、中、低”，目标系统的取值可能是“P0、P1、P2、P3”，含义边界未必一致。这时要以业务定义为准，重新命名或拆分字段，并在映射表中写明判断依据，不能因为字段名相同就直接对齐。如果源系统的“优先级”同时承载了紧急程度和影响范围两层含义，就需要拆成两个目标字段分别映射。
枚举值与状态字典要单独做一张取值对照表，逐值写明源取值、目标取值和转换说明。无法一一对应的取值，要写明归并规则或标记为待确认，不能默认取第一个值。
一对多和多对一的判断依据要写进映射表。一对多通常出现在一个源字段承载了多个业务含义，需要拆分到多个目标字段；多对一通常出现在多个源字段在目标系统中合并为一个字段，例如多个备注类字段合并进描述。判断依据是业务使用场景：拆分后每个目标字段是否都有独立的查询、统计或流转用途，合并后是否会丢失需要单独检索的信息。
目标系统没有对应字段时，有三种处理方式：落入目标系统的扩展字段、并入描述类字段、暂不迁移。选择哪种方式取决于该字段是否参与后续的查询统计和流程判断。落入扩展字段适合仍有结构化使用需求的字段；并入描述适合只作参考信息的字段；暂不迁移适合已废弃或无人使用的字段。三种方式都要在映射表中注明，并写清业务确认人。
转换规则与默认值怎么定
字段对应关系确定后，还要为每个字段写明取值怎么转换。类型转换是最常见的一类：文本与数值之间转换时，要确认源字段中是否存在非数字字符，存在时是清洗还是整字段转文本；日期字段要确认源系统与目标系统的时区口径，跨时区迁移时统一转换为同一时区再写入；富文本转纯文本会丢失格式，需要确认目标字段是否支持富文本，不支持时写明保留哪些内容、丢弃哪些格式。
长度截断要有明确规则。目标字段长度小于源字段时，写明截断位置和是否保留截断标记，避免截断后内容语义不完整却无人察觉。特殊字符处理同样要写清，例如换行符、制表符、表情符号在目标字段中的处理方式。
空值处理需要区分三种状态：字段为空值、字段为空字符串、字段从未设置。三者在业务上可能含义不同，映射时要分别写明转换结果。默认值只适用于源字段确实没有值、且业务上可以接受统一填充的情形，默认值的取值和填写人要写进映射表，不能由执行人临时决定。
规则变更要留版本记录。试迁移阶段发现某条转换规则不适用时，修改映射表并记录变更原因，保留上一版本以便回退。这一步的交付物是转换规则说明与默认值取值表，作为映射表的配套文档。
用小批量数据试迁移验证映射
映射表初稿完成后，用少量真实数据做试迁移。抽样要覆盖各对象、各枚举取值、边界长度和空值情形，每个对象至少抽取能覆盖全部枚举值的样本量。抽样清单要提前列出，避免只挑“看起来正常”的数据，导致试迁移通过而批量迁移出问题。
试迁移的执行步骤是：导出并脱敏样例数据，按映射表执行转换，写入目标系统的测试环境，逐字段比对源值与目标值。执行人和比对人要分开，比对结果记录在比对表中，每个差异写明源记录标识、字段名、源值、目标值、差异类型。
差异按四类归因：映射错误，即映射表写错了对应关系；规则缺失，即某类取值没有定义转换规则；目标限制，即目标字段的长度、类型或枚举不支持；源数据质量问题，即源数据本身存在空值、重复或格式混乱。归因不同，修订动作也不同：映射错误改映射表，规则缺失补转换规则，目标限制调整落库方式，源数据质量问题反馈给源系统负责人确认清洗口径。
修订完成后进行二次试迁移，重点验证修订过的字段和受影响的关联字段。二次试迁移仍要保留比对记录，与第一次记录放在一起，形成完整的修订链条。
核验证据与通过标准
字段映射阶段完成时，需要留存可核验的证据，判定通过的条件也要提前写清，避免凭感觉宣布“映射做完了”。
- 记录条数核对：源对象记录数与试迁移写入记录数一致，差异要有说明。
- 关键字段非空率核对：必填字段和关键业务字段的非空率与源系统对比，明显下降的要查明原因。
- 枚举值分布对比：各枚举取值的数量分布与源系统对比，分布形态明显偏离说明转换规则可能有问题。
- 抽样逐字段一致性检查结果：比对表中无未解释差异，或差异均已归因并有处理结论。
- 映射表最终版本与审批记录：版本号、审批人、审批时间齐全。
- 未解决差异清单及处理结论：每条差异写明是接受、延后处理还是阻断迁移。
通过标准建议写成可判定的条件，例如关键字段无未解释差异、枚举分布偏差在约定范围内、未解决差异均有明确结论。核验报告与最终版映射表一起归档，作为批量迁移的执行依据。
映射表、转换规则和核验记录需要在团队内评审和留痕。在 ONES 中，可以把映射表作为文档承载，按对象分节维护版本；试迁移发现的差异转为工作项跟踪，指定负责人和处理状态；核验报告与审批记录留在同一项目空间，便于批量迁移执行时对照查阅。ONES 的 Jira 迁移方案覆盖项目、工作项、状态、字段、流程、附件和历史记录，其中字段与属性值属于可迁移范围，具体字段的对应关系和转换细节仍需按实际迁移工具与项目评估确认。
什么情况下暂停或回退
映射阶段出现以下情形时，应暂停推进，带着未确认差异进入批量迁移会把问题放大到全量数据。
- 关键字段在目标系统中无对应字段，且业务侧无法确认归属。关键字段指参与流程判断、统计报表或对外交付的字段，这类字段悬空会让迁移后的数据无法支撑原有业务。
- 枚举取值无法一一对应，且归并后会影响统计口径。例如两个源取值合并为一个目标取值后，按原口径统计的报表无法还原。
- 源数据质量导致大面积空值或重复，试迁移结果无法反映真实映射效果。
- 试迁移差异率超出事先约定的可接受范围，且差异集中在关键字段。
回退动作包括：恢复映射表上一版本，清理试迁移写入的测试数据，重新召集业务确认人核对字段口径。回退不是失败，而是把口径问题解决在批量迁移之前。每次暂停和回退都要记录触发条件、处理动作和恢复时间，形成暂停与回退判定清单，作为迁移过程记录的一部分。
常见问题
映射表已经评审通过，试迁移时又发现字段含义理解错了，应该改映射表还是先迁完再修？
应在试迁移阶段改映射表，不要带着已知错误进入批量迁移。具体做法是：把该字段在映射表中的对应关系或转换规则改掉，记录修改人、修改时间和修改原因，保留上一版本；然后针对这个字段和受影响的关联字段做二次试迁移，比对通过后再更新映射表版本。
如果该字段参与流程判断或统计报表，还要同步通知使用该字段的业务方，确认修改后的口径符合他们的使用习惯。批量迁移后再修，意味着全量数据要重新清洗和回写，成本和风险都更高。
源系统里一个字段同时存了两种信息，目标系统只有单个字段，必须拆开吗？
是否拆分取决于拆分后每个目标字段是否有独立的查询、统计或流转用途。如果两种信息在目标系统中会分别用于筛选、报表或流程判断，就应拆成两个目标字段分别映射；如果只是参考信息、后续不会单独检索，可以并入描述类字段，并在映射表中注明合并规则。
拆分时要在映射表中写清拆分依据和取值规则，例如按分隔符切分、按固定前缀识别，并说明切分失败时的处理方式。拆分规则确定后，用覆盖各类组合的样例数据做试迁移，确认拆分结果符合预期。
目标系统没有对应字段，落入扩展字段和并入描述该怎么选？
判断标准是该字段迁移后是否还需要结构化使用。仍有查询、统计或报表需求的字段，优先落入目标系统的扩展字段，保留其结构化属性；只作参考信息、后续靠人工阅读的字段，可以并入描述类字段；已废弃或无人使用的字段，可以暂不迁移。
三种方式都要在映射表中注明，并写清业务确认人。选择扩展字段时，还要确认目标系统扩展字段的类型和长度能满足源字段的取值，避免试迁移时才发现存不下。选择并入描述时，要写明拼接格式和字段标识，方便迁移后追溯来源。
试迁移的差异率控制在多少算通过？
差异率的可接受范围没有统一标准，需要按对象和字段重要性分别约定。建议在试迁移前就写清通过条件：关键字段（参与流程判断、统计报表或对外交付的字段）不允许存在未解释差异；非关键字段的差异率控制在一个团队可逐条复核的范围内，并且每条差异都要有归因和处理结论。
差异率超出约定范围且集中在关键字段时，应暂停批量迁移，回到映射表修订和二次试迁移。把通过条件提前写进核验报告模板，可以避免试迁移结束后各方对“是否通过”产生分歧。
用 ONES 承接迁移时，字段映射表和核验记录放在哪里比较合适？
可以把映射表作为文档按对象分节维护，保留版本记录；试迁移发现的差异转为工作项跟踪，指定负责人和处理状态；核验报告与审批记录放在同一项目空间，便于批量迁移执行时对照查阅。ONES 的 Jira 迁移方案覆盖项目、工作项、状态、字段、流程、附件和历史记录，字段与属性值属于可迁移范围，具体字段的对应关系和转换细节仍需按实际迁移工具与项目评估确认。
