设计 Jira 字段映射表，核心是把“源字段—目标字段—转换规则—责任人—校验方式”五列固定下来，再按字段盘点、分类映射、规则定义、样本试迁、逐项校验五步推进。映射表不是迁移前填一次的表单，它要在试迁移中反复修订，确认每条规则都能执行后，才适合进入正式迁移。下文给出可直接建表的列结构、字段盘点方法、四类转换规则写法、角色分工和交付检查清单。
要点总览（TL;DR）
- 映射表先固定五列：源字段、目标字段、转换规则、责任人、校验方式，再补字段类型、是否必填、默认值、使用频率和处理结论。
- 字段盘点从字段配置、屏幕方案和自定义字段列表入手，统计有值率与最近使用情况，把废弃、重复和仅报表使用的字段标出来。
- 转换规则按直接映射、值转换、拆分合并、附件与历史记录四类分别写，枚举对照要覆盖源系统实际出现的全部取值。
- 用覆盖不同问题类型、状态和字段组合的真实 Issue 做一次试迁移，把失败项和规则缺口回填成修订版。
- 交付前逐项核对字段覆盖率、必填字段与默认值、样本校验通过率、规则与责任人及回退处理四项。
字段映射表先定哪几列
映射表的最小可用结构是五列：源字段、目标字段、转换规则、责任人、校验方式。这五列分别回答“从哪来”“到哪去”“怎么转”“谁确认”“怎么验”，缺一列都会在试迁移时暴露为规则缺口。建议在此基础上补充字段类型、是否必填、默认值、使用频率、处理结论五列，形成一张既能指导导入、又能支撑评审的工作表。
| 列名 | 填写内容 | 作用 |
|---|---|---|
| 源字段 | Jira 中的字段名称与字段 ID，注明所属屏幕方案 | 定位字段，避免同名不同义 |
| 目标字段 | 目标系统中的字段名称与字段类型 | 确认落点，识别类型不兼容 |
| 转换规则 | 直接映射、枚举对照、拆分合并或特殊处理的具体写法 | 指导导入执行 |
| 责任人 | 对该字段语义和转换结果负责的人 | 规则争议时的确认人 |
| 校验方式 | 试迁移中如何核对，如逐条比对、抽样检查、值分布统计 | 把验证动作落到字段级 |
| 字段类型 | 文本、单选、多选、日期、用户、级联等 | 判断是否需要值转换 |
| 是否必填 | 源系统与目标系统分别标注 | 识别必填冲突与默认值需求 |
| 默认值 | 源字段为空或未映射时写入的值 | 保证导入不中断 |
| 使用频率 | 有值率或使用该字段的 Issue 数量 | 支撑保留或丢弃决策 |
| 处理结论 | 映射、转换、合并、丢弃、待确认 | 形成可统计的完成度 |
字段清单的来源有三个：Jira 的字段配置页面、各项目使用的屏幕方案、自定义字段列表。从屏幕方案入手能看清字段在哪些问题类型上出现，从字段配置能看清字段类型和选项，两者交叉核对后，再补上自定义字段列表，才能得到完整清单。建议在表中增加“来源屏幕方案”一列，便于回溯某个字段为何出现在清单里。
字段盘点：先分清哪些字段真的在用
字段盘点的目标是把“系统里存在的字段”收敛为“迁移需要处理的字段”。Jira 实例经过多年使用，常见情况是自定义字段数量远超实际使用量，直接全量迁移会把废弃字段、测试字段和重复字段一并带入目标系统，增加后续维护成本。
盘点按以下顺序进行：
- 按项目收集字段。逐个导出项目使用的问题类型与屏幕方案，记录每个屏幕上出现的字段。
- 按问题类型核对。同一字段可能只在一个问题类型上使用，需要标注适用范围，避免迁移后字段出现在不该出现的位置。
- 统计有值率。对每个字段统计非空 Issue 数量占总 Issue 数量的比例，有值率极低的字段重点核查是否为废弃字段。
- 查看最近使用情况。结合 Issue 的更新时间和字段最后被填写的时间，判断字段是否仍在业务流程中使用。
- 标注特殊用途。仅用于报表、仅用于自动化规则、仅作为历史记录保留的字段，单独标注，处理方式与业务字段不同。
盘点完成后，每个字段应有一个处理结论：映射、转换、合并、丢弃或待确认。“待确认”的字段需要业务负责人给出判断，不能由管理员单方面决定。丢弃字段要记录原因和影响范围，例如某个报表依赖该字段，就需要在报表侧同步调整。
在目标系统侧，字段创建与配置需要与盘点结果对应。以 ONES 为例，其 Jira 迁移方案覆盖项目、工作项、状态、字段、流程、附件和历史记录的迁移，迁移内容包含问题类型、工作流、字段配置、权限配置等系统配置，以及属性和属性值、附件、评论等问题数据。盘点清单可以直接作为与迁移实施方核对字段范围的输入。
四类映射规则怎么定义
字段的转换规则按处理方式分为四类，每类在映射表中用不同的写法，便于导入执行和后续校验。
直接映射
源字段与目标字段语义一致、类型一致，仅名称不同。规则列写“直接映射”，并注明目标字段名。例如 Jira 的“经办人”映射到目标系统的“负责人”。直接映射也需要校验，重点确认用户账号能否对应、字段类型是否真的兼容。
值转换
字段语义一致但取值集合不同，需要建立枚举对照。状态、优先级、问题类型是最典型的三类。规则列应写成对照表形式，逐值列出源值与目标值，并标明未匹配值的处理方式。
| 源值（Jira） | 目标值 | 说明 |
|---|---|---|
| To Do | 待处理 | 直接对应 |
| In Progress | 进行中 | 直接对应 |
| In Review | 进行中 | 目标系统无评审状态，合并处理 |
| Done | 已完成 | 直接对应 |
| 其他自定义状态 | 待处理 | 默认值，需业务确认 |
优先级和问题类型的对照同理。对照表要覆盖源系统全部实际出现的值，不能只写常见值，否则试迁移时会遇到未定义的值导致导入失败或数据错位。
拆分合并
多选字段、标签、描述与评论的归属需要单独定义。多选字段在目标系统中可能对应多个单选字段，或对应一个标签字段，规则列要写明拆分逻辑和分隔方式。标签类字段要确认目标系统是否支持标签，以及标签的命名规范是否需要统一。描述与评论的归属要明确：描述映射到目标系统的描述字段，评论按时间顺序导入并保留作者信息，评论中的附件引用需要单独核对。
附件、历史记录与关联关系
附件通常整体迁移，规则列注明附件大小限制和存储位置。历史记录包括状态变更、字段修改和评论，需要确认目标系统保留哪些历史信息，无法保留的部分要记录在案。关联关系包括 Issue 之间的链接、父子关系和依赖关系，规则列要写明链接类型的对照方式，以及关联对象尚未迁移时的处理顺序。
未映射字段必须逐条记录默认值和丢弃原因。默认值的选择要避免污染统计，例如把未知优先级统一设为“中”，需要在迁移后说明这批数据的来源，便于后续分析时区分。
角色分工与交付物
映射表的准确性依赖多方确认，角色不清会出现“管理员按自己的理解定了规则、业务方在试迁移后才发现语义错了”的情况。建议按下表明确分工和交接时点。
| 角色 | 职责 | 交付物 | 交接时点 |
|---|---|---|---|
| 业务负责人 | 确认字段语义、必填要求和枚举值的业务含义 | 字段处理结论确认记录 | 字段盘点完成后、规则定义前 |
| Jira 管理员 | 提供字段配置、屏幕方案和字段使用数据导出 | 字段盘点清单 | 项目启动后第一周 |
| 目标系统管理员 | 创建目标字段、配置选项、执行导入 | 目标字段配置清单、导入记录 | 规则定义完成后 |
| 测试或项目代表 | 执行样本校验，反馈字段值是否正确 | 试迁移校验记录 | 试迁移执行后 |
| 迁移负责人 | 汇总映射表、跟踪缺口、组织评审 | 映射表修订版、交付检查清单 | 每个阶段结束时 |
交接时点要与阶段产出绑定：字段盘点清单交付后，业务负责人才有条件确认语义；规则定义完成后，目标系统管理员才能开始建字段；试迁移校验记录返回后，迁移负责人才能回填映射表。每个交接点建议留下书面确认，避免口头约定在后续环节失真。
用一批真实 Issue 做试迁移
试迁移的目的是验证映射表可执行，而不是验证迁移工具本身。样本选择要覆盖映射表中的主要规则类型，否则试迁移通过也不能说明映射表完整。
样本选择建议满足以下条件：
- 覆盖全部问题类型，每种至少若干条；
- 覆盖全部状态值，包括自定义状态和已归档状态；
- 覆盖有附件、有评论、有关联关系的 Issue；
- 包含字段值缺失的 Issue，验证默认值规则；
- 包含多选字段和标签字段有值的 Issue，验证拆分合并规则。
执行时按映射表逐字段导入，记录三类问题：导入失败项、值不正确项、规则未覆盖项。导入失败通常来自类型不兼容或必填冲突；值不正确通常来自枚举对照遗漏；规则未覆盖通常是盘点时漏掉的字段或特殊取值。三类问题都要回填到映射表，形成修订版，并注明修订原因。
试迁移的样本量不必大，但要能触发规则边界。样本校验由测试或项目代表执行，逐字段核对目标值与源值，校验结果记录在映射表的“校验方式”列对应的记录中。以 ONES 的迁移实践为例，正式迁移前需要确认数据范围、功能匹配和系统适配，试迁移正是完成这三项确认的手段；对于依赖 Jira 插件的定制场景，也应在这一阶段逐项评估，避免假设所有插件功能都能一一对应。
完成检查：映射表可以交付的判定标准
映射表能否进入正式迁移，按以下四项逐项核对，全部满足才可交付。
| 检查项 | 判定标准 | 不通过时的处理 |
|---|---|---|
| 字段覆盖率 | 盘点清单中每个字段都有处理结论，未映射字段有清单和原因 | 补充盘点或提交业务确认 |
| 必填字段与默认值 | 目标系统必填字段全部有来源或默认值，默认值经业务确认 | 调整规则或申请目标字段配置变更 |
| 样本校验通过率 | 试迁移样本逐字段核对，未通过项已修复并复验 | 回填规则后重新试迁 |
| 规则与责任确认 | 每条规则有责任人，回退处理方式已明确 | 组织评审会确认 |
回退处理需要提前写明：某个字段导入后发现值错误时，是重新导入该字段还是整批回滚，由谁决定，在多长时间内处理。这一条在正式迁移时最容易被忽略，却直接决定出问题时能否快速止损。
四项检查通过后，映射表连同字段盘点清单、试迁移记录和校验记录一起归档，作为正式迁移的执行依据和后续审计材料。正式迁移过程中如遇新字段或新取值，仍按同一张表补充规则，保持映射表与迁移结果一致。
常见问题
Jira 里自定义字段很多，盘点时要不要全部纳入映射表？
建议全部进入盘点清单，但不必全部进入迁移范围。盘点阶段先把字段配置、屏幕方案和自定义字段列表交叉核对，得到完整字段清单，再按有值率和最近使用情况标注处理结论。有值率极低、长期无人填写、仅用于测试的字段可以标为丢弃，并记录原因和影响范围。这样映射表覆盖的是“需要处理的字段”，而不是“系统里存在的字段”。
枚举对照表只写常见状态值可以吗？
不建议。试迁移时最容易出问题的就是盘点时漏掉的自定义状态或历史遗留取值。对照表应覆盖源系统实际出现的全部值，包括已归档状态和低频状态，并为未匹配值单独定义默认处理方式。默认值的选择要经业务负责人确认，迁移后在数据说明中标注这批值的来源，避免后续统计时混淆。
试迁移样本要选多少条、怎么选？
样本量不必大，关键是能触发规则边界。选择时覆盖全部问题类型、全部状态值、有附件和评论的 Issue、字段值缺失的 Issue，以及多选和标签字段有值的 Issue。执行后记录导入失败项、值不正确项和规则未覆盖项三类问题，逐条回填映射表。样本校验由测试或项目代表逐字段核对目标值与源值，通过后再进入正式迁移。
字段导入后发现值错了，应该怎么处理？
回退方式要在正式迁移前写进映射表：是重新导入该字段，还是整批回滚，由谁决定，在多长时间内处理。建议按字段影响范围分级，影响统计口径或必填字段的错误优先处理。回退处理与责任人确认是映射表交付检查的一项，提前约定可以减少正式迁移时的决策时间。
依赖 Jira 插件的定制字段，映射表里怎么处理？
这类字段建议在盘点阶段单独标注，并在试迁移前逐项评估。ONES 的 Jira 迁移方案建议先梳理实际使用的 Jira 插件，再通过 ONES Project、Wiki、TestCase、流程自动化和开放能力进行功能匹配；企业已有的定制场景，迁移前仍需逐项评估。评估结论写入映射表的处理结论列，无法直接对应的部分记录替代方案或舍弃原因。
