迁移字段映射表以“源对象—源字段—目标对象—目标字段”四列为主干，配套类型、必填、转换规则、默认值、责任人与校验结果等列。填写时逐字段登记，写清转换口径和空值处理；提交前按完整性、类型兼容、唯一标识与引用关系逐项核对。本文给出一张可直接复制的空白表、列级说明、必填划分和一条完整示例，适用于项目、工作项及其字段配置的数据迁移准备。
要点总览（TL;DR）
- 迁移字段映射表以“源对象—源字段—目标对象—目标字段”为主干，配套类型、必填、转换规则、默认值、责任人、状态与校验结果等列，按对象分表组织。
- 必填列包括序号、源对象、源字段、目标对象、目标字段、转换规则、责任人与状态；类型长度、空值处理、校验结果等按迁移风险补充。
- 填写时逐字段登记，转换规则写到可执行口径，枚举对照附完整对应关系，空值处理与目标字段必填属性联动。
- 提交前按完整性、类型兼容、长度、枚举覆盖、唯一标识、引用关系、空值处理与责任状态逐项核对。
- 模板通过追加行、版本号与变更记录保持连续，交接时移交当前版本、变更记录和未关闭事项清单。
可复制空白映射表模板
模板按“一个源对象一张表”的方式组织。每个对象单独建表，表头保持一致，便于分头填写后再合并。下面的表头顺序即为建议列顺序，复制到表格工具后按行追加字段记录即可。
| 序号 | 源对象 | 源字段 | 源类型/长度 | 目标对象 | 目标字段 | 目标类型/长度 | 是否必填 | 转换规则 | 默认值/空值处理 | 责任人 | 状态 | 校验结果 | 备注 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | |||||||||||||
| 2 | |||||||||||||
| 3 |
按对象分表时，建议在每张表上方标注对象名称与表版本，例如“对象：工作项／版本：v1.0”。对象之间存在引用关系时，在备注列写明引用的是哪张表的哪条记录，避免跨表核对时丢失上下文。若迁移范围包含项目配置与问题数据两类内容，可分别建立“项目配置映射表”和“工作项数据映射表”，两表共用同一套表头。
每一列填什么：字段说明
列的含义需要在团队内统一口径，否则不同人填出的表无法合并核对。下表逐列说明填写要求。
| 列名 | 填写内容 | 填写口径 |
|---|---|---|
| 序号 | 行号 | 按表内顺序连续编号，新增行追加在末尾，不复用已删除行的编号 |
| 源对象 | 来源系统中的对象名称 | 使用来源系统的正式名称，如项目、工作项、问题类型 |
| 源字段 | 来源系统中的字段名称 | 填写字段的技术名称或界面名称，同一张表内保持一种写法 |
| 源类型/长度 | 来源字段的数据类型与长度限制 | 如文本、数值、日期、枚举，并注明长度或取值范围 |
| 目标对象 | 目标系统中的对象名称 | 与源对象对应，允许一对多时分行登记 |
| 目标字段 | 目标系统中的字段名称 | 填写目标系统的实际字段名，未确定时留空并在状态列标注 |
| 目标类型/长度 | 目标字段的数据类型与长度限制 | 用于与源类型比对，判断是否需要截断或转换 |
| 是否必填 | 目标字段是否要求有值 | 填“是”或“否”，依据目标系统的字段配置确定 |
| 转换规则 | 源值到目标值的处理方式 | 写明直接映射、枚举对照、拼接、截断、拆分或人工确认，枚举对照需附对照关系 |
| 默认值/空值处理 | 源值为空时的处理方式 | 写明填入固定默认值、保留为空、跳过该条记录或转人工处理 |
| 责任人 | 该行映射的确认人 | 填写具体人员，负责确认转换规则与校验结果 |
| 状态 | 该行映射的推进状态 | 建议取值：待填写、待确认、已确认、有冲突、已关闭 |
| 校验结果 | 检查后的结论 | 填写通过或不通过，不通过时在备注列写明原因 |
| 备注 | 补充说明 | 记录引用关系、待评估事项、定制场景说明等 |
转换规则列是整张表最需要写细的部分。以枚举字段为例，只写“枚举映射”不足以支撑执行，应写出源值与目标值的对应关系，例如“来源状态‘处理中’对应目标状态‘进行中’，来源状态‘已解决’对应目标状态‘已完成’”。存在定制字段或插件依赖时，在该行备注中标注需逐项评估，避免默认所有字段都能一一对应。
必填与选填的划分
必填列决定这张表能否用于执行迁移，选填列用于补充核对信息。划分依据是：缺少该列信息时，迁移执行或结果核对会无法进行。
| 类别 | 列名 | 理由或适用场景 |
|---|---|---|
| 必填 | 序号 | 用于定位与跨表引用 |
| 必填 | 源对象、源字段 | 缺少则无法定位来源数据 |
| 必填 | 目标对象、目标字段 | 缺少则无法确定写入位置；暂未确定时留空并将状态置为“待确认” |
| 必填 | 转换规则 | 直接映射也需写明，避免执行时凭经验处理 |
| 必填 | 责任人、状态 | 保证每行有人负责、有明确推进状态 |
| 选填 | 源类型/长度、目标类型/长度 | 涉及类型转换、截断风险时必填，纯文本直接映射可简化 |
| 选填 | 是否必填 | 目标字段有必填约束时填写，用于空值处理判断 |
| 选填 | 默认值/空值处理 | 源数据存在空值时必填，无空值风险时可注明“无空值” |
| 选填 | 校验结果 | 进入检查阶段后填写，填写阶段可暂空 |
| 选填 | 备注 | 存在引用关系、定制场景或待评估事项时填写 |
空缺处理需要约定统一写法：尚未确定的信息留空并在状态列标注“待确认”，已确认不适用的情况填“不适用”，两种情况不混用。必填列出现空缺的行不进入执行阶段，由责任人补齐后再更新状态。
填写示例：一条完整映射记录
下面以工作项的一个状态字段为例，展示各列如何前后一致。示例为演示情景，字段名称按常见用法编写。
| 列名 | 填写内容 |
|---|---|
| 序号 | 12 |
| 源对象 | 工作项 |
| 源字段 | 状态 |
| 源类型/长度 | 枚举，取值：待处理、处理中、已解决、已关闭 |
| 目标对象 | 工作项 |
| 目标字段 | 状态 |
| 目标类型/长度 | 枚举，取值：未开始、进行中、已完成、已关闭 |
| 是否必填 | 是 |
| 转换规则 | 枚举对照：待处理→未开始，处理中→进行中，已解决→已完成，已关闭→已关闭 |
| 默认值/空值处理 | 源值为空时置为“未开始”，并在备注列记录该条记录标识 |
| 责任人 | 迁移负责人 |
| 状态 | 已确认 |
| 校验结果 | 通过 |
| 备注 | 四个源取值均有对应目标值，无未覆盖枚举 |
这条记录体现了三处一致性：转换规则列写出的四个源取值与源类型列的取值集合完全对应；空值处理与“是否必填为是”相匹配，因此给出默认值而非留空；校验结果为“通过”，依据是备注中说明的枚举覆盖情况。若源系统中存在第五个取值而未在转换规则中列出，该行校验结果应改为“不通过”，状态退回“有冲突”。
填写规则与检查项清单
填写规则约束录入动作，检查项用于提交前逐条核对。两者配合使用，可以减少执行阶段才发现的口径缺失。
填写规则
- 逐字段登记：一个源字段占一行，多个源字段合并成一个目标字段时分行登记，并在转换规则中写明拼接顺序与分隔符。
- 一个目标字段接收多个来源时，同样分行登记，避免一行内出现多组源字段与目标字段。
- 转换规则必须可执行：直接映射、枚举对照、拼接、截断、拆分、人工确认，任选其一并写明具体口径；枚举对照附完整对应关系。
- 类型与长度先比对再填写：源类型与目标类型不一致时，在转换规则中写明转换方式；目标长度小于源长度时，写明截断规则或标记为需人工确认。
- 空值处理与必填属性联动：目标字段必填时，空值必须给出默认值或转人工处理，不允许留空进入执行。
- 状态随填写推进更新：填写完成置为“待确认”，责任人确认后置为“已确认”，发现冲突置为“有冲突”。
提交前检查清单
- 完整性：必填列无空缺；每个源字段都有对应行；目标对象与目标字段均已确定或明确标注待确认。
- 类型兼容：逐行比对源类型与目标类型，数值、日期、枚举类字段的转换方式已写明。
- 长度校验：目标长度不小于源长度的行可直接通过；小于的行已写明截断或拆分规则。
- 枚举覆盖：枚举字段的源取值集合与转换规则中列出的取值一致，无遗漏、无多余。
- 唯一标识：主键类字段确认映射到目标系统的唯一标识字段，且转换后不产生重复值。
- 引用关系：对象之间的关联字段已标注引用目标，跨表引用能在对应表中找到被引用记录。
- 空值处理：存在空值的字段均已给出默认值、保留为空或转人工的明确结论。
- 责任与状态：每行均有责任人，状态取值在约定范围内，无长期停留在“待确认”的行。
- 校验结果：通过的行有依据说明，不通过的行有原因和后续处理人。
映射表确认后进入执行与核对阶段，表格本身仍需保留，作为结果核对的依据。迁移范围涉及项目配置与问题数据时，配置类映射与数据类映射分别核对，避免把字段配置的确认结论直接套用到历史数据上。
映射表在多人协作中需要承载评审与交接。可以在 ONES 中将映射表作为文档维护，按对象拆分章节，责任人与状态对应到具体人员和工作项状态；评审意见留在文档讨论中，确认后的版本作为迁移执行的输入。ONES 的 Jira 迁移方案覆盖项目、工作项、状态、字段、流程、附件和历史记录，迁移项目与系统配置时涉及问题类型、工作流、字段配置、权限配置，迁移问题数据时涉及属性、属性值、附件和评论，映射表的对象划分可以参照这一范围组织。存在定制场景或插件依赖时，迁移前仍需逐项评估，相关行在映射表中单独标注并保留评估结论。
模板的调整与维护方法
模板的价值在于跨批次复用。迁移范围变化时，通过追加行和更新版本保持模板连续，而不是每次重建一张新表。
新增对象或字段时的扩展方式
- 新增对象：复制一张空白表，修改表上方的对象名称，表头保持不变；新对象与其他对象存在引用时，在备注列写明引用关系。
- 新增字段：在对应对象表的末尾追加行，序号顺延，不复用已删除行的编号。
- 字段拆分或合并：保留原行并将状态置为“已关闭”，新增行记录新的映射关系，备注中注明替代关系，便于追溯。
版本与变更记录
每张表标注版本号，版本号随结构性变更递增：新增对象、调整表头、修改必填划分属于结构性变更；单行内容修订可在表尾变更记录中登记日期、修改人、修改行号和原因。变更记录与映射表放在同一文档中，评审时一并查看。
复用与交接约定
- 模板文件保留空白版本与已填写版本两类，空白版本用于新迁移项目起步，已填写版本作为历史参考。
- 交接时移交当前版本、变更记录和未关闭事项清单，未关闭事项逐条注明责任人与预计确认时间。
- 复用旧模板前先核对目标系统的字段配置是否变化，字段配置有调整时同步更新类型、必填与转换规则列。
- 迁移完成后保留最终版本，作为后续数据核对和问题追溯的依据。
常见问题
源系统中多个字段合并成目标系统一个字段时，映射表怎么填？
按源字段分行登记，每个源字段占一行，目标对象与目标字段列填写同一个目标字段。转换规则列写明拼接顺序与分隔符，例如“先取项目名称，再拼接工作项编号，中间用短横线连接”。这样执行时能按行逐条处理，核对时也能看出目标值由哪些来源组成。
目标字段尚未确定时，映射表应该留空还是先写一个暂定值？
建议留空，并把状态列置为“待确认”，在备注列写明待确认的原因和预计确认时间。暂定值容易被后续执行误用，留空加状态标注能明确区分“尚未确定”和“已确认不适用”。必填列出现空缺的行不进入执行阶段，由责任人补齐后再更新状态。
枚举字段的取值在迁移后出现源系统没有的新值，检查时怎么处理？
检查时先比对源取值集合与转换规则中列出的取值是否一致。若目标系统存在源系统没有的取值，属于目标侧新增，不影响映射执行；若源系统存在转换规则未覆盖的取值，该行校验结果应改为“不通过”，状态退回“有冲突”，补充对应关系后再确认。枚举覆盖检查要求无遗漏、无多余，两侧取值集合逐项对照。
映射表确认后，迁移执行阶段还需要继续维护这张表吗？
需要保留。映射表确认后作为执行与结果核对的依据，执行中发现字段口径需要调整时，在原行更新转换规则并登记变更记录，状态相应回退。迁移完成后保留最终版本，用于后续数据核对和问题追溯。涉及项目配置与问题数据的迁移，配置类映射与数据类映射分别核对，避免把字段配置的确认结论直接套用到历史数据上。
复用上一批迁移的映射表模板时，需要先核对什么？
先核对目标系统的字段配置是否发生变化，包括字段类型、长度限制、必填约束和枚举取值。字段配置有调整时，同步更新类型、必填与转换规则列，再进入填写。模板文件保留空白版本与已填写版本两类，空白版本用于新迁移项目起步，已填写版本作为历史参考；交接时一并移交变更记录和未关闭事项清单。
