Jira 数据迁移建议流程
1 评估你的 Jira 迁移效果
- 对于每次迁移，我们建议你先使用工具内的「评估迁移效果」模式，了解你的 Jira 项目、用户、问题等数据的迁移效果。
- 你只需提供 Jira 备份包的存储路径，即可评估 Jira 数据在迁移至 ONES 环境后的效果。
- 评估完成后，你可以下载迁移评估报告。报告中会展示你的项目、问题类型、属性及用户等在迁移至 ONES 环境后的具体情况。
2 整理 Jira 数据
2.1 修正 Jira 用户数据
- 迁移评估模式能帮助你识别 Jira 系统中是否存在异常的用户邮箱，如无效的邮箱、重复的邮箱等。对于这些异常用户，建议你在迁移前在 Jira 系统内修正这些用户的邮箱信息，修正为唯一且正确的邮箱地址。当然，在 Jira 迁移工具的「迁移 Jira 数据模式」中，你也可以修正相关用户信息。
2.2 删除部分冗余的数
- 删除 Jira 系统中没有使用过的问题类型、属性等数据，能够使你更高效地配置数据的迁移操作以及减少迁移耗费时间。
- 确定项目的活跃度，比如项目是否归档，项目最近修改时间等，能够帮助你划分不同的项目活跃度。如果你需要分批次迁移，或者在测试环境中迁移部分项目，可以迁移已归档或活跃度较低的项目。
- 确认 Jira 系统内的数据量级
- 了解如何清理你的 Jira 数据
3 在 ONES 环境内设置你想要映射的数据
- Jira 迁移工具中，支持你将问题类型、问题属性、项目属性及用户映射为 ONES 环境内已有的数据。因此你可以在迁移前先在 ONES 环境内设置好你想要映射的数据。
3.1 工作项类型
- Jira 迁移工具中支持你将 Jira 问题类型映射为 ONES 中已有工作项类型，我们将支持标准工作项之间的映射以及子工作项之间的映射。你可以在迁移前，在 ONES 环境中建立好需要映射的工作项类型，我们推荐的映射关系为：
| Jira 原生问题 | ONES 工作项 |
|---|---|
| Epic（史诗） | 自定义工作项 |
| Story（故事） | 需求 |
| Bug（缺陷） | 缺陷 |
| Task（任务） | 任务 |
| Subtask（子任务） | 子任务 |
3.2 工作项属性
- 对于部分 Jira 问题属性，你可以在 Jira 迁移工具中将其映射为 ONES 系统中已有的工作项属性。因此你可以在迁移前先在 ONES 环境内设置好你想要映射的数据。
- 注意，仅支持工作项属性间的一对一映射，且只支持相同属性类型间的映射，以下为可以支持映射的 Jira 问题属性：
| Jira 属性名称 | 英文 | Jira 属性类型 | 可映射的 ONES 工作项属性类型 |
|---|---|---|---|
| Jira 系统属性 | |||
| ID | ID | 系统属性 | 单行文本 |
| 影响版本 | Affects Version/s | 系统属性 | 单行文本 |
| 标签 | Labels | 系统属性 | 单行文本 |
| 模块 | Component/s | 系统属性 | 单行文本 |
| 解决结果 | Resolution | 系统属性 | 单选菜单 |
| 环境 | Envrionment | 系统属性 | 多行文本 |
| Jira 自定义属性 | |||
| Epic 状态 | Epic status | 史诗状态 | 单选菜单 |
| Epic 名称 | Epic label | 史诗名称 | 单行文本 |
| - | Labels | 标签 | 单行文本 |
| - | Radio Buttons | 单选按钮 | 单选菜单 |
| - | Checkboxes | 复选框 | 多选菜单 |
| - | Date Time Picker | 日期时间选择器 | 时间 |
| - | Date Picker | 日期选择器 | 日期 |
| - | Number Field | 数值 | 浮点数 |
| - | Text Field (single line) | 单行文本 | 单行文本 |
| - | Text Field (multi-line) | 多行文本 | 多行文本 |
| - | Select List (multiple choices) | 多选列表 | 多选菜单 |
| - | Select List (cascading) | 级联列表 | 单行文本 |
| - | Select List (single choice) | 单选列表 | 单选菜单 |
| - | User Picker (single user) | 单选用户 | 单选用户 |
| - | URL Field | URL 链接 | 单行文本 |
| - | Version Picker (single version) | 版本列表（单个） | 单行文本 |
| - | Version Picker (multiple versions) | 版本列表（多个） | 单行文本 |
| - | Global Rank | 全局评级 | 单行文本 |
| - | Text Field (read only) | 文本域（只读） | 多行文本 |
| - | Project Picker (single project) | 单选项目列表 | 单行文本 |
| - | User Picker (multiple users) | 多选用户 | 多选用户 |
| - | Group Picker (single group) | 选择用户组（单） | 单行文本 |
| - | Group Picker (multiple groups) | 选择用户组（多） | 单行文本 |
3.3 项目属性
- 对于部分 Jira 项目属性，你可以在 Jira 迁移工具中将其映射为 ONES 系统中已有的项目属性。因此你可以在迁移前先在 ONES 环境内设置好你想要映射的数据。
- 注意，仅支持项目属性间的一对一映射，且只支持相同属性类型间的映射，以下为可以支持映射的 Jira 项目属性：
| Jira 属性名称 | 英文 | Jira 属性类型 | 可以映射的 ONES 属性类型 |
|---|---|---|---|
| 项目类型 | Project type | 系统属性 | 单选菜单 |
| 项目类别 | Project catagory | 系统属性 | 单选菜单 |
| URL | URL | 系统属性 | 单行文本 |
| 描述 | Description | 系统属性 | 多行文本 |
3.4 用户
- 支持映射 ONES 环境中已有的用户
- 推荐用法：在 Jira 系统中已经离职的成员，希望将其业务数据交接现有成员负责，可在迁移前先在 ONES 环境内设置好你想要映射的用户。
4 制定迁移计划
4.1 推荐一次性迁移完成
- 在正式环境中进行迁移时，我们建议你一次性将需要迁移的数据全部迁移完毕。如果你选择分批次迁移，在最终迁移完成前，建议不要在 ONES 环境中对已迁移的 Jira 数据进行修改。
- 如果分批次迁移过程中，在 ONES 环境中对已迁移的 Jira 数据进行修改，那么这些数据在后续迁移中可能会以在 Jira 系统中的为准。
- 分批次迁移过程中，建议不要在 Jira 侧做结构上的调整，比如：变更原有属性类型，变更原有菜单选项数量等。
4.2 推荐准备 ONES 测试环境
- 对于每次迁移，我们建议你准备一个测试环境，以确保正式的 ONES 环境不会受到非必要的影响。在此测试环境下完成一次数据迁移测试。验收通过后，在正式环境下进行正式的迁移。
4.3 验收测试环境迁移效果
- 在测试环境下完成一次数据迁移后，我们建议你重点验收以下几点。验收通过后，在你的正式环境下执行迁移。
- 数据数量是否完整？如项目数量、工作项数量、用户属性等
- 权限、工作流等数据配置是否符合你的工作要求，能否正常运行？
- 对于迁移能力上兼容迁移，或不支持自助迁移的数据的迁移效果是否达到预期？