迁移字段映射表用来把源系统里的每个字段，逐条对应到目标系统的字段，并写清转换规则、责任人和处理状态。模板以“一条源字段对应一条目标字段”为基本行，核心列包括映射编号、源系统与源对象、源字段名与类型、目标系统与目标对象、目标字段名与类型、转换规则、必填与默认值、取值示例、负责人、状态与备注。下面给出一张可直接复制到表格工具的空白模板，并说明每列怎么填、哪些必填、如何维护复用。
要点总览（TL;DR）
- 迁移字段映射表以“一条源字段对应一条目标字段”为基本行，核心列覆盖映射编号、源端与目标端字段信息、转换规则、必填与默认值、取值示例、负责人、状态和备注。
- 映射编号、源端与目标端定位字段、转换规则、负责人、状态为必填列；字段类型、是否必填与默认值建议必填；取值示例和备注按需填写。
- 转换规则写成可判定的条件式描述，并与取值示例成对检查；规则与示例对不上时优先细化规则或更换代表性示例。
- 模板按“标识与范围—源端—目标端—转换规则—责任与状态”分组排列，可按迁移对象裁剪或扩展列，并保留版本号与变更记录。
- 复用模板前确认源系统版本与字段、目标系统字段、对照表与默认值三项是否仍适用，交接时说明未关闭的风险记录。
可复制空白字段映射表模板
将下表复制到 Excel、在线表格或需求管理工具中，第一行作为列头，从第二行开始每条记录填写一个字段的映射关系。列的顺序按“标识与范围—源端—目标端—转换规则—责任与状态”五组排列，便于按组阅读和裁剪。
| 映射编号 | 源系统 | 源对象 | 源字段名 | 源字段类型 | 目标系统 | 目标对象 | 目标字段名 | 目标字段类型 | 转换规则 | 是否必填 | 默认值 | 取值示例 | 负责人 | 状态 | 备注 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
如果项目涉及枚举值对照、多来源合并或历史数据清洗，可在“转换规则”右侧插入“对照表引用”“清洗条件”等扩展列；如果迁移对象包含附件、评论等非结构化内容，可另建一张同结构的附表，保持列头一致，便于统一评审。
每一列的含义与填写规则
列的含义需要在团队内形成统一口径，否则不同人填出的表无法合并核对。下表逐列说明用途和写法，填写时以“读表人能独立判断这条映射是否可执行”为标准。
| 列名 | 用途 | 填写规则 |
|---|---|---|
| 映射编号 | 唯一标识一条映射记录 | 建议用“对象缩写-序号”格式，如 ISSUE-001；同一张表内不重复，删除记录后编号不复用 |
| 源系统 | 标明数据来源系统 | 写系统名称与版本，如“Jira 9.x”；同一项目涉及多个来源时逐条写清 |
| 源对象 | 标明字段所属的业务对象 | 写对象名称，如“问题”“项目”“页面”；避免只写“主表”这类含糊说法 |
| 源字段名 | 定位源端具体字段 | 使用源系统中的字段标识或显示名，两者不一致时以标识为准，显示名放备注 |
| 源字段类型 | 判断转换难度和校验方式 | 写文本、数值、日期、枚举、用户、附件等；枚举类型需注明取值集合来源 |
| 目标系统 | 标明数据写入系统 | 写系统名称与版本或环境，如“ONES Project 测试环境” |
| 目标对象 | 标明字段所属的目标对象 | 与源对象对应写清，如“工作项”“项目”“Wiki 页面” |
| 目标字段名 | 定位目标端具体字段 | 使用目标系统的字段标识；新建字段需注明创建人和创建时间 |
| 目标字段类型 | 判断类型是否兼容 | 写目标系统支持的类型；与源类型不一致时，转换规则列必须给出处理方式 |
| 转换规则 | 描述从源值到目标值的处理逻辑 | 写成可判定的条件式描述，如“为空时取默认值”“按枚举对照表转换”“截断至 255 字符”；避免只写“按需处理” |
| 是否必填 | 标明目标字段的必填约束 | 填“是/否”；填“是”时，源值为空必须有默认值或明确的阻断处理 |
| 默认值 | 记录源值为空时的填充值 | 写具体值或取值来源；无默认值时写“无”，并确认目标字段允许为空 |
| 取值示例 | 用真实样例验证规则 | 给一条源值到目标值的对照，如“进行中 → 处理中”；示例应与转换规则一致 |
| 负责人 | 明确这条映射的确认与执行责任 | 写具体人名或角色，避免只写团队名；跨系统映射建议源端、目标端各一名确认人 |
| 状态 | 跟踪映射处理进度 | 使用统一状态值，如“待确认、已确认、已执行、已验证、有风险”；状态变更时在备注写原因 |
| 备注 | 记录例外、依赖和待决问题 | 写影响执行的补充信息，如“依赖枚举对照表 V2”“目标字段待新建” |
转换规则和取值示例要成对检查：规则描述的是处理逻辑，示例是这条逻辑作用在一个真实值上的结果。两者对不上，通常说明规则写得不够具体，或者示例选得不具代表性。
哪些列必填、哪些列按需填写
必填列的作用是保证任何一条映射都能被独立理解和核对。以下划分以“准备阶段即可完整填写”为基准，项目可按迁移对象调整，但调整应在模板说明中写明。
| 列名 | 填写要求 | 理由与适用场景 |
|---|---|---|
| 映射编号 | 必填 | 评审、问题跟踪和执行记录都依赖唯一编号 |
| 源系统、源对象、源字段名 | 必填 | 缺少任一项都无法定位源数据 |
| 目标系统、目标对象、目标字段名 | 必填 | 缺少任一项都无法确认写入位置 |
| 转换规则 | 必填 | 即使是一对一直接映射，也写“直接映射”，避免默认理解不一致 |
| 负责人 | 必填 | 映射确认和异常处理需要明确责任人 |
| 状态 | 必填 | 用于阶段推进和交接，空状态无法判断进度 |
| 源字段类型、目标字段类型 | 建议必填 | 类型不一致是转换问题的主要来源；仅在字段类型已由系统自动识别时可暂缺 |
| 是否必填、默认值 | 建议必填 | 目标字段有必填约束时必须填写；无约束字段可写“否/无” |
| 取值示例 | 按需 | 枚举转换、格式转换、清洗规则必须给示例；简单文本直映可省略 |
| 备注 | 按需 | 存在例外、依赖或待决问题时填写 |
不同阶段对完整度的要求不同。准备阶段要求源端与目标端字段信息齐全，能支撑范围确认；执行阶段要求转换规则、默认值和负责人明确，能直接交给执行人操作；核验阶段要求状态和备注可追溯，每条记录都能说明处理结果和遗留问题。团队可以在模板中增加“阶段”列，或按阶段筛选状态值来管理。
完整填写示例：一条字段映射记录
以下示例为演示情景：将 Jira 中“问题”的状态字段迁移到 ONES 工作项的状态字段。示例用于说明各列如何配合，实际取值以项目评估结果为准。
| 列名 | 示例取值 | 取值来源说明 |
|---|---|---|
| 映射编号 | ISSUE-012 | 按“对象缩写-序号”编制，是该问题对象下的第 12 条映射 |
| 源系统 | Jira 9.x | 取自项目使用的源系统版本 |
| 源对象 | 问题 | 状态字段挂在问题对象上 |
| 源字段名 | status | 使用源系统字段标识 |
| 源字段类型 | 枚举 | 状态为有限取值集合 |
| 目标系统 | ONES Project 测试环境 | 先在测试环境验证，再切换生产 |
| 目标对象 | 工作项 | 与源端问题对象对应 |
| 目标字段名 | status | 使用目标系统字段标识 |
| 目标字段类型 | 枚举 | 目标端状态同样为有限取值集合 |
| 转换规则 | 按状态对照表转换：待办→未开始，进行中→处理中，已完成→已完成；未匹配值写入“待确认”并记录原值 | 规则写成可判定条件，并给出未匹配值的处理方式 |
| 是否必填 | 是 | 目标状态字段为必填 |
| 默认值 | 未开始 | 源值为空时使用默认状态 |
| 取值示例 | 进行中 → 处理中 | 取自源系统一条真实记录，验证对照表规则 |
| 负责人 | 源端：迁移执行人；目标端：项目管理员 | 两端各一名确认人，便于核对 |
| 状态 | 已确认 | 对照表已评审，等待执行 |
| 备注 | 依赖状态对照表 V2；自定义状态“阻塞”需单独确认 | 记录依赖和例外，避免执行时遗漏 |
这条记录中，转换规则说明了映射方向和未匹配值的处理，取值示例给出了一个具体对照，默认值覆盖了源值为空的情况，备注则把对照表版本和自定义状态这两个依赖显式写出来。执行人拿到这一行，就能判断能否直接迁移，遇到“阻塞”状态时也知道需要先确认。
在映射评审和执行跟踪环节，可以把这张表作为工作项批量导入 ONES，用工作项状态对应“待确认、已确认、已执行、已验证”，用评论记录例外处理；映射规则和对照表说明则可放在 ONES Wiki 文档中，与工作项互相引用，方便交接时追溯。
模板的调整、复用与维护方法
模板的价值在于跨项目复用，前提是每次复用前确认列结构和填写口径仍然适用。以下操作清单可作为模板维护的日常做法。
- 按迁移对象裁剪列。迁移对象只涉及结构化字段时，保留核心列即可；涉及附件、评论、页面正文时，增加“内容处理方式”“大小限制”等列，并另建附表，不与字段映射混在同一行。
- 按转换复杂度扩展列。枚举值较多时增加“对照表引用”列，指向独立的对照表；需要清洗历史数据时增加“清洗条件”列，写清去重、截断、格式统一的具体规则。
- 维护版本号与变更记录。在表格首个工作表或文档头部记录模板版本、修改日期、修改人和变更内容；列头发生增删改时升级版本号，并在变更记录中说明影响的映射记录范围。
- 复用前做三项检查。确认源系统版本与字段是否变化，确认目标系统字段是否新建或调整，确认对照表和默认值是否仍适用；三项检查结果写入备注或单独的检查记录。
- 约定交接方式。映射表随迁移方案一起归档，状态为“已验证”的记录作为验收依据；交接时说明未关闭的“有风险”记录和待确认事项，避免后续维护人员重复排查。
当同一组织连续开展多次迁移时，可以把稳定不变的列和填写说明固化为模板基线，把项目特有的对照表和扩展列作为项目附件管理。这样既保持各项目映射表结构一致，也允许具体迁移按实际情况调整。
常见问题
源字段和目标字段的命名不一致时，映射表里以哪个为准？
以系统内的字段标识为准，显示名放在备注列。字段标识在系统升级或界面调整后相对稳定，显示名可能随语言或配置变化。如果源系统只提供显示名，就在备注中写明获取方式，例如从哪个配置页面或导出文件中取得，方便后续核对。
一条映射记录能不能同时对应多个目标字段？
建议拆成多条记录，每条记录只描述一个源字段到一个目标字段的对应关系。一个源字段拆到多个目标字段时，各目标字段的转换规则、必填约束和负责人可能不同，合并在一行会让执行和核验难以判断。拆分后用映射编号区分，并在备注中注明彼此关联。
枚举值对照表应该放在映射表里还是单独维护？
对照表单独维护，映射表的转换规则列写“按状态对照表 V2 转换”这类引用，并在备注中记录版本。对照表条目多、变更频繁，放在单元格里会难以评审和复用。对照表本身也应有版本号和变更记录，映射表引用具体版本，避免执行时取到旧值。
迁移执行到一半发现目标字段需要新建，映射表怎么处理？
把该条记录的状态改为“有风险”或“待确认”，在备注中写明待新建字段的名称、类型和创建人，转换规则列暂按预期填写并标注“待字段创建后确认”。字段创建完成后再更新目标字段名与类型，状态回到“已确认”。这样处理可以保留原有映射关系，也便于交接时看到未决事项。
同一组织多次迁移时，模板基线应该固定哪些内容？
把稳定不变的列头、列顺序、填写说明和状态取值固化为基线，项目特有的对照表、扩展列和默认值作为项目附件管理。每次复用前核对基线版本，项目附件单独记录版本。这样各项目映射表结构一致，横向汇总和交接时不需要重新理解列含义。
