从Jira迁移到ONES前，盘点项目字段和工作流的目标，是把Jira里的现状整理成一份可对照、可核验的清单：哪些项目、问题类型和历史数据要迁，每个字段的类型与规则是什么，每条工作流的节点和流转条件如何设置。盘点结果要能直接支撑字段映射表、工作流映射表和试迁移用例，而不是停留在截图和口头描述。本文按“圈范围、备材料、登字段、拆工作流、核验成映射、设定暂停条件”的顺序展开，适用于以ONES Project为迁移目标的迁移准备阶段。
要点总览（TL;DR）
- 盘点先圈定四个维度：来源与目标系统、Jira版本与迁移窗口、纳入迁移的项目清单、纳入迁移的数据类别，形成范围清单后再逐项登记。
- 字段盘点按字段ID去重登记类型、必填、默认值、选项值与使用频率，同名不同义字段单独标注，处置建议分为保留、合并、废弃。
- 工作流盘点要拆到状态、流转、条件、权限、校验器和后处理动作，并记录方案与项目、问题类型的绑定关系。
- 盘点结果经抽样核对与评审后，转化为字段映射表、工作流映射表初稿和试迁移验证用例。
- 字段含义无法确认、关键插件无对应承载、历史数据完整性无法保证时，先暂停或收缩对应范围，不带着未确认假设进入试迁移。
盘点范围：先圈定哪些项目和字段要迁
盘点的第一步是划定边界。范围不清，后续字段登记和工作流梳理会无限扩张，映射表也无法收敛。建议在盘点启动时先固定四个维度：来源系统与目标系统、Jira当前版本与迁移窗口、纳入迁移的项目清单、纳入迁移的数据类别。
来源与目标要写清楚：来源是Jira（需注明云版或数据中心版及版本号），目标是ONES Project。版本信息影响配置导出方式和可用字段类型，迁移窗口则决定盘点需要多快完成、试迁移安排在什么时间。这些信息应作为范围清单的表头固定下来，避免后续口径漂移。
项目清单需要区分三类：活跃项目、归档项目、与其他项目共享配置的项目。活跃项目通常全部纳入；归档项目按查询需求和合规要求决定是否迁移；共享配置项目要特别标注，因为一个字段配置或工作流方案可能被多个项目引用，单独迁移某个项目会牵动共享配置的拆分。
问题类型与字段范围按以下口径登记：
| 维度 | 登记内容 | 是否纳入的判断依据 |
|---|---|---|
| 项目 | 项目键、名称、负责人、活跃/归档、是否共享配置 | 业务是否仍在使用、历史数据是否需查询 |
| 问题类型 | 类型名称、所属项目、使用数量 | 是否有实际工单、是否参与流程流转 |
| 系统字段 | 摘要、描述、状态、经办人、报告人等 | 默认纳入，重点确认状态与人员的映射 |
| 自定义字段 | 字段名、类型、选项、使用项目 | 按使用频率和业务必要性逐项判断 |
| 插件字段 | 来源插件、字段用途、依赖关系 | 需评估目标侧是否有对应承载 |
| 历史数据 | 附件、评论、变更历史、工时、关联关系 | 按查询与审计需求逐类确认 |
历史数据范围容易被低估。附件和评论通常随问题数据一并考虑，变更历史、工时记录、问题链接关系是否纳入，需要在盘点时就明确，并写入范围清单的“是否纳入”列。ONES的Jira迁移方案覆盖项目、工作项、状态、字段、流程、附件和历史记录，具体数据类别的迁移口径仍应以实际项目评估为准。
盘点输入与依赖：需要谁提供什么材料
盘点不是工具管理员一个人的工作。字段的业务含义、必填规则的由来、某个状态为何存在，往往只有业务方说得清。启动前应把输入材料、权限和角色分工列成清单，明确谁在什么时间提供什么。
权限方面，需要Jira管理员账号或具备系统配置查看权限的账号，用于导出字段配置、工作流方案、权限方案和项目关联关系。取证方式有两种：能导出的配置优先导出为结构化文件；无法导出的部分（如工作流图形、条件配置界面）用截图加文字说明记录，截图需标注项目、方案名称和截取时间。
角色分工建议按以下方式划分：
- Jira管理员：负责配置导出、方案与项目的绑定关系梳理、插件清单整理。
- ONES侧管理员：负责确认目标侧字段类型、工作流能力的对应关系，标记需要重新设计的部分。
- 业务方代表：按项目或领域指定，负责解释字段含义、必填规则、状态存在的业务原因。
- 迁移负责人：汇总清单、组织评审、维护风险与暂停条件记录。
盘点结果要与后续阶段衔接：字段盘点表直接转化为字段映射表的输入，工作流要素清单转化为工作流映射表的输入，抽样核对记录转化为试迁移验证用例。因此在盘点阶段就要按映射表的列结构登记，避免二次返工。ONES侧可用工作项和文档承载盘点清单，让业务方在同一处评审和确认，减少表格多版本流转。
字段盘点：按类型、规则与使用情况逐项登记
字段盘点的核心是回答三个问题：这个字段是什么、它怎么被使用、迁移后如何处理。登记表建议至少包含以下列：字段标识（Jira中的字段ID）、字段名称、字段类型、所在上下文（哪些项目、哪些问题类型可见）、是否必填、默认值、选项值或级联规则、使用频率、业务必要性说明、处置建议。
类型与规则要记录到可复现的程度。下拉选择要列出全部选项值及顺序；级联选择要记录层级关系；多选字段要注明是否允许多值；带联动规则的字段（如选择某类型后另一字段变为必填）要把触发条件写清楚。这些细节决定映射时能否找到对应类型，也决定试迁移时能否验证选项值是否完整保留。
同名不同义是字段盘点中最需要警惕的情况。不同项目里都叫“优先级”的字段，可能一个是全局选项、一个是项目私有选项，取值含义也不同。识别方法是按字段ID而非字段名称去重，凡名称相同但ID不同、或选项集不同的，单独标注并附业务方解释。处置时通常有两种选择：合并为一个统一字段并做值映射，或保留为独立字段。合并会简化目标侧配置，但需要业务方确认取值可以对齐。
使用频率与业务必要性的判断，可以借助Jira的字段使用统计或抽样查询：统计近一段时间内有值的工单占比，占比极低的字段列入“废弃候选”，由业务方确认后不纳入迁移；含义重叠的字段列入“合并候选”；仍在流程中承担关键判断的字段列入“保留”。处置建议列应写明理由和确认人，便于评审时追溯。
工作流盘点：节点、流转条件与后处理动作
工作流不能只记录状态名称，要拆成可映射的组成要素。建议对每条工作流方案登记：状态清单、初始状态与终态、每条流转的起点与终点、流转条件、权限限制、校验器、后处理动作，以及该方案绑定了哪些项目和问题类型。
状态与节点清单要区分“状态”和“流转”：状态是工单所处的阶段，流转是允许从一个状态到另一个状态的动作。初始状态通常由创建动作决定，终态是流程结束的状态，这两类要单独标注，因为映射时它们影响新建工单的默认状态和完成判定。
流转条件与权限限制是盘点中最容易遗漏的部分。条件可能基于字段值（如仅当“审批结果”为通过时才允许流转）、基于用户角色（仅项目负责人可操作）、基于子任务状态。校验器则在流转前强制检查，例如要求填写解决结果。这些规则要逐条记录触发条件和作用对象，并标注目标侧是否有对应承载方式；没有直接对应时，标记为“需重新设计”，在映射阶段与业务方确认替代方案。
后处理动作包括流转后自动赋值字段、发送通知、触发其他系统（如代码提交关联、外部审批回调）。这类动作往往依赖插件或脚本，盘点时要记录动作类型、触发时机和依赖的系统。ONES的Jira迁移方案覆盖工作流配置的迁移，对于校验器、后处理动作和插件依赖的场景，建议逐项评估对应方式，不默认所有规则都能一一对应。
最后记录工作流方案与项目、问题类型的绑定关系。一个方案可能被多个项目共用，迁移时若只迁部分项目，需要决定是拆分方案还是整体迁移。绑定关系表是工作流映射表的基础结构。
盘点结果如何核验并形成映射与试迁移输入
清单写完不等于盘点完成，需要经过抽样核对和评审确认，才能作为映射和试迁移的输入。核验的目标是发现遗漏和错误，而不是证明清单完美。
抽样核对建议选取代表性项目：一个配置最复杂的活跃项目、一个使用共享配置的项目、一个含历史数据的归档项目。在每个项目中抽取若干工单，覆盖不同问题类型和不同状态，逐项比对清单记录与实际配置是否一致，重点检查字段选项值、必填规则、流转条件和后处理动作。核对结果记入核验记录，发现偏差回填到盘点表。
核验通过后，将盘点表转化为两张映射表初稿：
| 映射表 | 主要列 | 来源 |
|---|---|---|
| 字段映射表 | Jira字段标识、名称、类型、选项值、目标字段、映射方式、值转换规则、处置结论 | 字段盘点登记表 |
| 工作流映射表 | Jira工作流方案、状态、流转、条件、校验器、后处理动作、目标工作流、对应方式、待确认项 | 工作流要素清单 |
试迁移验证用例从核验记录中选取：优先覆盖字段类型最复杂、流转条件最多、历史数据最典型的工单，每个用例写明预期结果（字段值是否正确、状态是否正确、附件评论是否完整）。用例数量不必多，但要能暴露映射表中的高风险项。
盘点结论需经业务方代表和工具管理员共同评审，确认范围清单、字段处置建议、工作流待确认项和暂停条件后签字，才进入正式迁移准备。ONES的迁移实践建议在正式迁移前确认数据范围、功能匹配和系统适配，盘点评审正是这一确认动作的落点。
盘点的回退与停止条件：哪些情况先不迁
盘点阶段发现的问题，越早处理成本越低。以下情况应暂停对应范围的迁移，待确认后再推进：
- 字段含义无法确认，或业务方代表缺位、无法对必填规则和选项含义作出解释。此时该字段标记为待定，不进入映射表定稿。
- 关键功能依赖Jira插件或外部系统，且目标侧暂无对应承载方式。应先梳理插件实际使用范围，评估通过ONES Project、Wiki、TestCase、流程自动化和开放能力进行功能匹配的可行性，逐项确认后再决定迁移或替代方案。
- 历史数据完整性无法保证，例如附件缺失、变更历史不完整、工时数据口径不明。此时应收缩迁移范围，明确哪些数据类别暂不迁移，并在范围清单中记录。
- 工作流中的校验器或后处理动作涉及复杂脚本，目标侧对应方式未确认。该工作流标记为需重新设计，不按原样映射。
这些条件应写入风险与暂停条件清单，每条注明触发条件、影响范围、责任人和解除条件。盘点结论未通过评审前，不进入正式迁移；已暂停的范围在条件解除后重新纳入盘点核验，而不是直接跳过。把停止条件前置写清楚，可以让迁移团队在遇到问题时有一致的处置依据，避免带着未确认的假设进入试迁移。
常见问题
Jira里字段很多，盘点时如何判断哪些字段可以合并或废弃？
判断依据是使用情况和业务含义，而不是字段数量。可以先统计近一段时间内有值的工单占比，占比极低的字段列为废弃候选；名称不同但选项含义重叠的字段列为合并候选。两类候选都需要业务方代表确认，确认后在字段盘点表的处置建议列写明理由和确认人。仍在流程中承担关键判断的字段，例如决定流转条件或审批结果的字段，应保留并优先进入映射表。
共享配置的项目在盘点时要注意什么？
共享配置意味着一个字段配置或工作流方案被多个项目引用。盘点时要记录方案名称、被哪些项目引用、每个项目是否纳入迁移。如果只迁部分项目，需要决定是拆分方案还是整体迁移；拆分会让目标侧配置更贴合实际使用，整体迁移则减少盘点与映射工作量。这个决定应在盘点阶段与业务方确认，并写入范围清单，避免试迁移时才发现方案绑定关系没有理清。
工作流里的校验器和后处理动作在ONES侧没有直接对应，盘点阶段怎么记录？
逐条记录触发条件、作用对象和依赖的系统或脚本，在处置建议中标记为“需重新设计”，并注明待确认项。ONES的Jira迁移方案覆盖工作流配置的迁移，校验器、后处理动作和插件依赖的场景需要逐项评估对应方式。盘点阶段的目标是把这些规则完整暴露出来，供映射阶段与业务方确认替代方案，而不是在盘点时就给出结论。
盘点结论需要谁确认，确认后还能修改吗？
盘点结论通常由业务方代表和工具管理员共同评审，确认范围清单、字段处置建议、工作流待确认项和暂停条件。评审通过后进入映射与试迁移准备。如果试迁移或映射阶段发现新问题，应回填到盘点表并重新核验对应条目，而不是在映射表中直接改口径。保留盘点表的版本记录，可以让后续变更可追溯。
历史数据中的变更历史、工时记录是否一定要纳入迁移？
取决于查询和审计需求，需要在盘点时逐类确认并写入范围清单。ONES的Jira迁移方案覆盖项目、工作项、状态、字段、流程、附件和历史记录，具体数据类别的迁移口径仍应以实际项目评估为准。如果某类数据完整性无法保证，可以收缩范围、明确暂不迁移，并在风险清单中记录影响范围和责任人。
