研发数据迁移映射表把源系统中的对象、字段和值逐项对应到目标系统，让迁移范围、转换规则和校验责任都有据可查。本文提供一套可直接复制的主映射表，以及用户身份、附件与链接两张附表，并逐列说明填写口径、必填判断和一条完整示例，聚焦迁移数据内容本身。
要点总览（TL;DR）
- 模板由主映射表、用户身份映射附表、附件与链接映射附表三张表组成，主表十二列覆盖源对象、目标对象、字段对应、转换规则、负责人与校验状态。
- 映射编号、源与目标对象字段、数据类型、转换规则、必填判断、负责人属于首轮盘点必填列；校验状态可在校验启动后逐行更新。
- 转换规则统一写成“条件—动作”，例如枚举值按对照表转换、用户字段按身份映射附表替换账号，便于逐条校验。
- 示例用一条需求数据演示三张表联动：REQ-003 指向身份映射，REQ-004 指向附件与链接映射，校验时按引用逐项核对。
- 迁移范围变化时以追加行方式维护映射表，保留变更记录，每周复核未通过与待校验行，切换前完成全表复核。
可复制空白映射表模板
模板由三张表组成：主映射表负责对象与字段级对应，用户身份映射附表负责账号对应，附件与链接映射附表负责文件与页面引用的去向。将下面三张表依次复制到表格软件中，第一行作为表头冻结，即可开始填写。
主映射表
| 映射编号 | 源系统 | 源对象 | 源字段 | 目标系统 | 目标对象 | 目标字段 | 数据类型 | 转换规则 | 必填判断 | 负责人 | 校验状态 |
|---|---|---|---|---|---|---|---|---|---|---|---|
用户身份映射附表
| 映射编号 | 源系统账号 | 源显示名 | 源用户组 | 目标系统账号 | 目标用户组 | 匹配依据 | 处理方式 | 负责人 | 校验状态 |
|---|---|---|---|---|---|---|---|---|---|
附件与链接映射附表
| 映射编号 | 所属源对象 | 资源类型 | 源位置或地址 | 目标位置或地址 | 处理方式 | 关联主表映射编号 | 负责人 | 校验状态 |
|---|---|---|---|---|---|---|---|---|
复制后的使用方式：三张表放在同一工作簿的不同工作表，映射编号统一采用“对象缩写-序号”格式，例如 REQ-001，附表通过“关联主表映射编号”指回主表。表头行冻结，校验状态列设置下拉选项（待校验、通过、不通过、不适用），便于筛选未完成项。
映射表字段说明
字段说明的作用是让不同填写人对同一列给出同一种口径。下表逐列给出含义与取值来源，填写时以源系统导出数据和目标系统字段配置为准。
主表字段字典
| 字段 | 含义 | 取值来源 | 填写口径 |
|---|---|---|---|
| 映射编号 | 本行映射的唯一标识 | 按对象缩写加序号编制 | 全表唯一，附表引用同一编号 |
| 源系统 | 数据迁出的系统 | 迁移项目登记 | 写系统名称，同一项目内保持一致 |
| 源对象 | 源系统中的数据实体 | 源系统数据模型或导出清单 | 如需求、缺陷、任务、页面 |
| 源字段 | 源对象中的具体字段 | 源系统字段配置 | 写字段名称，必要时附字段标识 |
| 目标系统 | 数据迁入的系统 | 迁移项目登记 | 与源系统成对出现 |
| 目标对象 | 目标系统中的数据实体 | 目标系统配置 | 与源对象对应，允许一对多拆分 |
| 目标字段 | 目标对象中的承接字段 | 目标系统字段配置 | 无对应字段时写“新增”或“不迁移” |
| 数据类型 | 字段的值类型 | 源字段类型 | 文本、数值、日期、枚举、用户、附件等 |
| 转换规则 | 源值到目标值的处理方式 | 业务确认结果 | 按“条件—动作”写法，见下文 |
| 必填判断 | 该字段是否必须迁移 | 业务与迁移范围确认 | 填“必填”或“选填” |
| 负责人 | 该行映射的确认人 | 迁移分工表 | 写具体人名，不写部门代称 |
| 校验状态 | 该行是否已验证 | 校验记录 | 待校验、通过、不通过、不适用 |
两张附表的列定义
用户身份映射附表记录账号层面的对应关系。源系统账号、源显示名、源用户组取自源系统用户清单；目标系统账号、目标用户组取自目标系统已建账号；匹配依据写工号、邮箱或人工确认；处理方式写直接对应、新建账号、合并或停用。附件与链接映射附表记录非结构化资源的去向：资源类型区分附件、图片、页面链接、外部链接；源位置或地址写原路径或原地址；目标位置或地址写迁移后的落点；处理方式写随对象迁移、单独上传、重写链接或标记失效。
转换规则的常见写法
转换规则列建议统一为“条件—动作”结构，便于后续逐条校验。常见写法包括：源字段为空时置默认值；枚举值按对照表转换，如“处理中→进行中”；多选值拆分为多个标签；日期统一为同一时区与格式；用户字段按身份映射附表替换账号；长文本超长时截断并记录原文位置。一条规则只描述一种处理，涉及多个条件时分多行填写。
当迁移在 ONES 中推进时，映射表的确认、校验和遗留问题可以落到具体工作项与文档上：每条待确认映射建一个工作项，负责人和处理状态随工作项流转，映射表本身作为项目文档持续更新，评审记录与变更说明留在文档中，便于交接时追溯。ONES 的 Jira 迁移方案覆盖项目、工作项、状态、字段、流程、附件和历史记录，Confluence 迁移覆盖空间、页面、附件和权限结构，这些范围可以作为划分映射对象时的参照。
必填与选填的划分
划分依据是缺失后的后果：缺了就无法定位数据或无法建立关联的列，首轮盘点必须填；只影响说明完整性的列，可以在校验阶段补齐。
| 列 | 划分 | 理由 | 后补时点 |
|---|---|---|---|
| 映射编号 | 必填 | 全表定位与附表引用的基础 | — |
| 源系统、源对象、源字段 | 必填 | 缺少则无法确定迁移来源 | — |
| 目标系统、目标对象、目标字段 | 必填 | 缺少则无法落地，也无法判断是否新增字段 | — |
| 数据类型 | 必填 | 决定转换规则与校验方式 | — |
| 转换规则 | 必填 | 直接决定迁移结果是否正确 | — |
| 必填判断 | 必填 | 决定迁移范围与验收口径 | — |
| 负责人 | 必填 | 无责任人则校验无法推进 | — |
| 校验状态 | 选填 | 首轮盘点时尚未开始校验 | 校验启动后逐行更新 |
缺失必填项时，该行标记为“待补充”，不进入迁移执行清单；由负责人在约定时间内补齐，补齐后再参与范围评审。若某列确实不适用，例如目标字段为“不迁移”，在转换规则中写明原因，避免留空造成歧义。
填写示例：一条需求数据从源到目标
下面用一条需求数据演示三张表的联动。示例为演示情景，系统名称与字段按常见配置编写，实际填写以项目真实数据为准。
示例主表行
| 映射编号 | 源系统 | 源对象 | 源字段 | 目标系统 | 目标对象 | 目标字段 | 数据类型 | 转换规则 | 必填判断 | 负责人 | 校验状态 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| REQ-001 | 源研发平台 | 需求 | 需求标题 | 目标研发平台 | 需求 | 标题 | 文本 | 原值写入，去除首尾空格 | 必填 | 张明 | 通过 |
| REQ-002 | 源研发平台 | 需求 | 需求状态 | 目标研发平台 | 需求 | 状态 | 枚举 | 按对照表转换：待评审→待评估，开发中→进行中，已上线→已完成 | 必填 | 张明 | 通过 |
| REQ-003 | 源研发平台 | 需求 | 提出人 | 目标研发平台 | 需求 | 提出人 | 用户 | 按用户身份映射附表替换账号 | 必填 | 李华 | 待校验 |
| REQ-004 | 源研发平台 | 需求 | 需求描述 | 目标研发平台 | 需求 | 描述 | 长文本 | 保留正文，内嵌图片按附件映射处理 | 选填 | 张明 | 待校验 |
示例用户身份映射行
| 映射编号 | 源系统账号 | 源显示名 | 源用户组 | 目标系统账号 | 目标用户组 | 匹配依据 | 处理方式 | 负责人 | 校验状态 |
|---|---|---|---|---|---|---|---|---|---|
| USR-001 | zhangming | 张明 | 产品组 | zhangming | 产品组 | 工号一致 | 直接对应 | 李华 | 通过 |
| USR-002 | lihua01 | 李华 | 研发组 | lihua | 研发组 | 邮箱一致 | 直接对应 | 李华 | 通过 |
示例附件与链接映射行
| 映射编号 | 所属源对象 | 资源类型 | 源位置或地址 | 目标位置或地址 | 处理方式 | 关联主表映射编号 | 负责人 | 校验状态 |
|---|---|---|---|---|---|---|---|---|
| ATT-001 | 需求 REQ-1001 | 附件 | 需求附件区/原型说明.pdf | 需求 REQ-1001 附件区 | 随对象迁移 | REQ-004 | 王芳 | 待校验 |
| LNK-001 | 需求 REQ-1001 | 页面链接 | 源知识库/需求规范页 | 目标知识库/需求规范页 | 重写链接 | REQ-004 | 王芳 | 待校验 |
示例中，REQ-003 的转换规则指向 USR-001、USR-002 所在的身份映射表，校验时先确认账号对应，再核对需求上的提出人是否正确；REQ-004 的描述正文涉及图片，转换规则指向 ATT-001 与 LNK-001，校验时同时检查附件是否到位、链接是否可打开。转换规则与校验方式一一对应，是这张表能够支撑验收的关键。
模板的调整与维护方法
映射表在迁移周期内会持续变化，调整规则应提前约定，避免不同版本并行造成误填。
- 按对象类型拆分或合并表：对象类型少于五类、字段总量不大时，用一张主表加对象列区分即可；对象类型多、负责人不同、校验节奏不一致时，按对象拆分为多个工作表，映射编号前缀区分，附表保持共用。
- 版本与变更记录：工作簿保留一个变更记录工作表，记录版本号、修改日期、修改人、修改内容与影响行；每次范围评审后升一个版本，旧版本另存归档，不覆盖历史。
- 增量同步阶段追加行：新增映射以追加方式写入，不修改已校验通过的行；确需修改时先在校验状态标为“待复核”，修改后重新校验，并在变更记录中登记。
- 定期复核责任：由迁移负责人每周复核一次未通过和待校验行，按负责人分派；切换前完成全表复核，遗留项形成清单随迁移报告归档。
维护阶段同样可以把复核动作放进 ONES 的工作项与文档中：未通过行对应到具体工作项，复核结论写入文档版本说明，切换前的全表复核结果作为项目文档留存。ONES 的 Jira 数据迁移包含用户、用户组、系统配置以及问题数据中的属性、属性值和附件、评论等信息，Confluence 数据迁移包含用户、用户组、空间权限与页面权限，并支持页面正文、附件、图片、常用宏及批注的迁移，这些范围可作为复核清单的参照。工作流与插件行为的迁移配置、迁移结果的核验与切换管理属于另外的工作，本文的映射表只覆盖数据内容层面的对应关系。
常见问题
源系统里存在大量重复或废弃数据，映射表应该先清理再填，还是边填边清理？
建议先完成源数据盘点清理，再逐列填写映射表。重复记录和废弃记录如果先进入映射表，后续清理时映射编号、附表引用和校验状态都要跟着改，返工成本高。实际操作中可以先导出一份源数据清单，标记保留、合并、丢弃三类，只把保留和合并后的记录写入主表；合并记录在转换规则中写明合并依据，便于校验时追溯。
用户身份映射中，源账号和目标账号同名但实际不是同一个人，怎么处理？
不能只凭账号名判断对应关系，应以工号、邮箱或人工确认为匹配依据，并在“匹配依据”列写明。同名不同人时，处理方式填“新建账号”或“合并”，并在转换规则中注明原账号数据的归属。若涉及历史工作项的责任人字段，需在身份映射确认后再回填主表，避免先迁移后改人造成责任记录错位。
附件和页面链接在迁移后地址会变化，映射表里怎么记录才能支撑校验？
在附件与链接映射附表中分别记录源位置或地址、目标位置或地址，处理方式区分随对象迁移、单独上传、重写链接、标记失效。校验时按“关联主表映射编号”回到主表对应行，逐条打开目标地址确认可访问。对于指向外部系统的链接，若迁移后无法保留，标记失效并在处理方式中写明原因，避免校验阶段反复排查。
增量同步期间，已经校验通过的行需要修改，直接改还是新加一行？
已校验通过的行不直接覆盖。确需修改时，先把校验状态改为“待复核”，修改后在变更记录中登记修改人、修改内容和影响行，再重新校验。新增映射以追加方式写入，映射编号顺延，不复用已归档编号。这样切换前可以按校验状态筛选出全部待复核项，逐项确认后再冻结版本。
映射表需要和迁移工具或平台的配置保持一致吗？
映射表是业务确认和校验的依据，工具配置是执行手段，两者应保持同一口径。字段对应、枚举转换、用户匹配规则在映射表确认后再落到迁移配置中；配置调整时同步更新映射表并登记变更。若使用 ONES 推进迁移，Jira 数据迁移覆盖用户、用户组、系统配置以及问题数据中的属性、属性值和附件、评论等信息，Confluence 数据迁移覆盖用户、用户组、空间权限与页面权限，并支持页面正文、附件、图片、常用宏及批注的迁移，可据此核对映射表覆盖范围是否完整。
