Jira 字段映射表把源系统中的每个字段逐项对应到目标系统，并记录类型、必填条件、转换规则和校验方式，是迁移准备阶段最容易被多人同时填写、也最容易出现口径分歧的一份表。本文提供一张可直接复制的空白表，按“源字段—目标字段—字段类型—必填—转换规则—校验方式”六列展开，并附取值映射、默认值、负责人、备注四个补充列；随后逐列说明填写口径、区分必填与选填、给出一条完整示例，并说明迁移前后如何维护。若目标系统是 ONES，字段映射结果会直接用于工作项配置与迁移后的抽样核对，填写时按同一口径记录即可。
要点总览（TL;DR）
- 空白表按“源字段—目标字段—字段类型—必填—转换规则—校验方式”六列展开，另设取值映射、默认值、负责人、备注四个补充列，可直接复制使用。
- 源字段、目标字段、字段类型、转换规则为必填列；取值映射在单选、多选、状态类字段上条件必填；校验方式与负责人建议在验收阶段补齐。
- 转换规则按直接映射、值映射、拼接、截断、默认值五类书写，每类写明输入与输出，避免只写“正常转换”。
- 校验方式写抽样比对、条数核对、空值检查中的一项或多项并注明样本量，迁移前后各执行一次。
- 映射表保留版本与变更记录，新增字段先登记再实施，废弃字段标注而非删除，迁移验收后归档并指定维护人。
可复制空白字段映射表
先复制下表，按一行一个字段的方式填写。主表六列是每条映射都必须具备的信息，附列用于记录值对应关系、兜底处理和责任人。字段较多时，建议按“项目—问题类型—字段”分组排列，同一字段在不同问题类型下取值不同时分行记录。
| 序号 | 源字段（键名/显示名） | 目标字段（键名/显示名） | 字段类型 | 必填 | 转换规则 | 校验方式 | 取值映射 | 默认值 | 负责人 | 备注 |
|---|---|---|---|---|---|---|---|---|---|---|
| 1 | ||||||||||
| 2 | ||||||||||
| 3 | ||||||||||
| 4 | ||||||||||
| 5 | ||||||||||
| 6 | ||||||||||
| 7 | ||||||||||
| 8 | ||||||||||
| 9 | ||||||||||
| 10 |
填写顺序建议固定为三步：先完成字段盘点，把源系统中实际存在、实际被使用的字段列全；再补转换规则和取值映射；最后用抽样数据验证一遍。边填边改容易造成同一字段在不同行出现不同口径，后续核对成本会明显上升。
每列字段说明与填写口径
这张表的价值在于多人填写后仍能对齐理解，因此每列都要有明确的写法约定。下表给出各列的含义、填写格式和常见错误。
| 列名 | 含义 | 填写口径 | 常见问题 |
|---|---|---|---|
| 源字段 | Jira 中待迁移的字段 | 同时写键名与显示名，格式如 customfield_10010 / 客户等级；系统字段写标准键名，如 summary / 摘要 |
只写中文显示名，脚本核对时无法定位 |
| 目标字段 | 目标系统中承接该数据的字段 | 同样写键名与显示名；目标系统暂无对应字段时写“待新建”并注明计划字段类型 | 直接写“同源字段”，未确认目标侧是否存在 |
| 字段类型 | 数据的结构形态 | 按文本、单选、多选、日期、用户、数值六类填写；源与目标类型不一致时在转换规则中说明 | 把“下拉框”这类界面形态当作类型 |
| 必填 | 该字段在目标系统中是否必须赋值 | 填“是/否”，并注明依据：源系统必填、目标系统必填、业务要求必填 | 只写“是”，未说明是源侧要求还是目标侧要求 |
| 转换规则 | 数据从源到目标的处理方式 | 按直接映射、值映射、拼接、截断、默认值五类书写，写明输入与输出 | 写“正常转换”，无法据此实现或复核 |
| 校验方式 | 迁移后如何确认该字段正确 | 写抽样比对、条数核对、空值检查中的一项或多项，并注明样本量 | 只写“人工检查”，没有范围和判定标准 |
| 取值映射 | 枚举值的对应关系 | 逐条列出源值与目标值，未覆盖的值写明处理方式 | 只写“状态按常规对应”，遗漏历史状态 |
| 默认值 | 源数据为空或无法转换时填入的值 | 写具体值；无默认值时写“留空” | 默认值写成“无”，与留空含义混淆 |
| 负责人 | 该字段映射的确认人 | 写姓名或角色，负责确认规则与验收结果 | 写整个团队，实际无人确认 |
| 备注 | 补充说明 | 记录例外情况、待确认事项、关联插件或定制逻辑 | 把待办事项散落在聊天记录中 |
字段类型对照需要源与目标两侧同时确认。文本类字段通常可直接承接，但要注意长度上限；单选与多选字段的重点在取值集合是否一致，多选转单选时必须先定义取舍规则；日期字段要统一时区与格式；用户字段要确认账号体系能否对应，无法对应的账号需要指定归属人；数值字段要确认精度和小数位。类型不一致本身不是问题，问题是没有在表中写清处理方式。
转换规则的写法要能被人照着执行、被脚本照着实现。直接映射写成“源字段值原样写入目标字段”；值映射写成“源值 A→目标值 B，源值 C→目标值 D，其余值→默认值”；拼接写成“字段 A + ‘-’ + 字段 B 写入目标字段”；截断写成“保留前 255 个字符，超出部分记入备注”；默认值写成“源值为空时写入‘未分级’”。每类规则都带上输入与输出示例，复核时不必再回头询问填写人。
校验方式要可执行、可判定。抽样比对指从源系统抽取一定数量的工作项，逐字段与目标系统比对并记录差异；条数核对指统计源与目标两侧的记录总数及分组数量是否一致；空值检查指统计目标侧关键字段的空值比例，与源侧对比。三项检查建议在迁移前后各执行一次，迁移前的检查用于确认基线，迁移后的检查用于确认结果。
哪些列必填、哪些列选填
全部列都填会显著增加工作量，全部从简又会丢失关键信息。按下表区分优先级，可以在保证可执行的前提下控制填写负担。
| 列名 | 属性 | 说明 |
|---|---|---|
| 源字段 | 必填 | 没有源字段，映射无从谈起 |
| 目标字段 | 必填 | 暂未确定时写“待新建”，不能留空 |
| 字段类型 | 必填 | 决定转换规则能否成立 |
| 转换规则 | 必填 | 即使是直接映射也要写明，不能默认省略 |
| 必填（是否必填） | 建议必填 | 影响空值检查的判定标准，建议随表填写 |
| 校验方式 | 建议必填 | 可在迁移方案确定后统一补齐 |
| 取值映射 | 条件必填 | 单选、多选、状态类字段必须填写明细 |
| 默认值 | 选填 | 存在空值或无法转换的情况时填写 |
| 负责人 | 选填 | 字段数量多、涉及多个业务方时建议填写 |
| 备注 | 选填 | 用于记录例外与待确认事项 |
必填程度还可以按迁移阶段调整。字段盘点阶段，源字段、目标字段、字段类型三列必须齐全，否则无法判断工作量；规则设计阶段，转换规则与取值映射成为重点；验收阶段，校验方式与负责人必须补齐，否则差异无人跟进。按阶段分批补齐，比要求一次填满更符合实际推进节奏。
填写示例：一条完整映射记录
以下是一条已填好的记录，展示各列如何配合。场景为演示用途：某团队把 Jira 中的“客户等级”自定义字段迁移到目标系统，源字段为单选类型，目标字段同为单选但取值集合不同。
| 列名 | 填写内容 |
|---|---|
| 源字段 | customfield_10010 / 客户等级 |
| 目标字段 | customer_level / 客户等级 |
| 字段类型 | 单选 → 单选 |
| 必填 | 是（目标系统必填，源系统非必填） |
| 转换规则 | 值映射：源值“战略客户”→目标值“A 级”；“重点客户”→“B 级”；“普通客户”→“C 级”；源值为空或为其他历史值→默认值“C 级” |
| 校验方式 | 抽样比对 30 条工作项逐条核对取值；条数核对按等级分组统计两侧数量；空值检查确认目标侧无空值 |
| 取值映射 | 战略客户→A 级；重点客户→B 级；普通客户→C 级；未分级→C 级；其余历史值→C 级并在备注中登记原值 |
| 默认值 | C 级 |
| 负责人 | 客户成功组 张某某 |
| 备注 | 源系统存在“未分级”历史值，迁移后统一归入 C 级，原值保留在迁移日志中备查 |
这条记录在抽样校验中的结果可以这样写：“抽取 30 条，其中战略客户 8 条、重点客户 12 条、普通客户 7 条、未分级 3 条；目标侧对应为 A 级 8 条、B 级 12 条、C 级 10 条，与预期一致；空值 0 条；分组条数与源侧一致。”校验结果写成可核对的数字，比写“校验通过”更有追溯价值。若发现差异，在同一行备注中记录差异条数、原因和处理结论，不要另开表格分散记录。
映射表的调整与维护方法
映射表在迁移准备期会频繁变化，迁移完成后仍需作为配置依据保留。维护规则建议包含以下几条：
- 增加版本列与变更记录。每次发布一版映射表时记录版本号、日期、修改人和修改内容摘要，历史版本保留可查，避免口头确认替代书面记录。
- 新增字段先登记再实施。迁移过程中发现遗漏字段时，先在表中新增一行并标注“新增”和生效时间，确认目标字段后再进入配置，避免系统已改而表格未更新。
- 废弃字段标注而非删除。源系统中不再使用的字段，在表中标注“废弃”和废弃原因，保留原行以便追溯；直接删除会让后续核对失去参照。
- 目标侧配置变更同步回表。目标系统中字段类型、必填条件、取值集合发生调整时，同步更新对应行，并在变更记录中登记，保持表格与系统实际配置一致。
- 迁移后执行一次全表复核。按校验方式列逐项确认结果，重点检查条件必填的取值映射字段和设置了默认值的字段，复核结论写入备注。
- 归档并指定维护人。迁移验收完成后，将最终版本连同校验记录归档，指定一名维护人负责后续字段调整时的表格更新。
若迁移目标为 ONES，映射表可以直接作为工作项字段配置的输入：项目、问题类型、工作流、字段配置与权限配置属于可迁移的系统配置范围，问题数据中的属性与属性值、附件、评论也在迁移范围内，字段映射阶段逐项核对的对应关系正是这些配置与数据的落地依据。依赖插件或定制逻辑的字段，迁移前需要逐项评估，不能假设所有定制字段都能一一对应，这类字段应在备注中单独标注并安排确认。字段类型级别的支持明细与目标侧字段类型清单，建议在实施时以产品实际配置核对后再定稿。
常见问题
Jira 自定义字段很多，映射表需要每个字段都列一行吗？
按实际被使用的字段逐项列行，而不是按 Jira 中存在的字段数量机械展开。字段盘点阶段先确认哪些字段在项目、问题类型中真正被填写和查询，长期空置的字段可以在备注中标注“未使用”，不必为它设计转换规则。同一字段在不同问题类型下取值集合不同时，分行记录，避免一行内混写多套规则。
源字段和目标字段的键名从哪里获取？
源侧键名可从 Jira 的字段管理页面或导出数据中确认，系统字段使用标准键名，自定义字段通常形如 customfield_10010。目标侧键名以目标系统实际配置为准，字段尚未创建时先写“待新建”并注明计划类型，等配置完成后再回填。键名与显示名同时记录，脚本核对用键名，业务确认用显示名。
转换规则里遇到源值与目标值无法一一对应的情况怎么处理？
在取值映射列逐条列出已确认的对应关系，对未覆盖的历史值单独写明处理方式，常见做法是归入一个默认值并在备注中登记原值，保留迁移日志备查。若某个值涉及业务判断而非技术转换，把该行负责人填上，由业务方确认后再定稿，不要由实施人员自行决定归属。
映射表填完后，怎么确认填写结果和系统实际配置一致？
按校验方式列逐项执行：抽样比对抽取一定数量工作项逐字段核对，条数核对按分组统计两侧数量，空值检查对比关键字段的空值比例。发现差异时在同一行备注中记录差异条数、原因和处理结论。目标系统字段类型、必填条件或取值集合发生调整时，同步更新对应行并登记变更，保持表格与配置一致。
迁移完成后映射表还需要保留吗？
需要。验收完成后将最终版本连同校验记录归档，并指定一名维护人。后续目标系统新增字段、调整必填条件或修改取值集合时，以归档版本为参照更新，避免历史口径丢失。若迁移目标为 ONES，映射表可作为工作项字段配置的输入，项目、问题类型、工作流、字段配置与权限配置属于可迁移的系统配置范围，问题数据中的属性与属性值、附件、评论也在迁移范围内；依赖插件或定制逻辑的字段需在迁移前逐项评估。
