Jira 迁移工具：迁移 Jira 数据模式
1 迁移前
1.1 全局操作
1.1.1 登录状态
登录 ONES 账号后，将显示：
- 用户登录状态
- 当前 ONES 组织名称
- 用户邮箱
用户可以退出登录，退出登录后当前迁移配置将会保存。
1.1.2 取消迁移
| 页面 | 操作 | 备注 |
|---|---|---|
| 登录 ONES | 点击「取消迁移」，将直接返回至 Jira 迁移工具首页 | |
| 其他页面 | 点击「取消迁移」，将会有二次确认弹窗。取消迁移将会清空所有迁移配置，并且退出登陆，返回 Jira 迁移工具首页。 |  |
| 开始迁移 | 1）点击「取消迁移」，将会有二次确认弹窗。 2）已迁移的数据将无法一键撤回，取消迁移后，相关迁移配置将会清空，且终止迁移。 3）点击「下载迁移日志」可以下载当前迁移日志。 |  |
1.1.3 迁移配置保存，跳转规则
- 迁移配置相关：
- 迁移的配置将会跟随 ONES 团队进行保存，且一个 ONES 团队下仅有一份正在进行的迁移配置。
- ONES 组织下管理员都可以对相同 ONES 团队下的迁移进行协同配置。
- 迁移配置保存机制：
- 数据迁移，一般来说持续时间较长，且需要谨慎决策。 Jira 迁移工具，提供迁移配置保存机制，为你提供流畅，友好的迁移体验。以下为迁移配置保存机制：
- 点击页面中的「上一步」、「下一步」
- 点击左侧菜单栏有效区进行步骤间跳转
- 点击左上角「 Jira 迁移工具」返回工具首页
- 关闭工具页面
1.2 登录 ONES
填写你需要迁移至的 ONES 服务域名/IP，仅 ONES 管理员可以进行迁移。 如果你是 ONES 多团队环境，需要为组织管理员以及当前所有 ONES 团队的超级管理员；如果你是 ONES 单团队环境，需要为超级管理员。
1.3 选择 Jira 备份包
1.3.1 工具内无配置路径页面：根据工具内指引可在 Jira 系统中找到 Jira 备份包的储存路径
1.3.2 工具内已配置路径页面：无需配置路径，直接可以选择需要迁移的 Jira 备份包。
1.4 解析
解析 Jira 备份包基本信息，及需要导入的 ONES 环境
1.4.1 ONES 环境本地储存磁盘需要扩容充足，云磁盘请确认储存容量是否足以支持迁移。
1.4.2 磁盘解析结果
a. ONES 环境为本地磁盘储存，磁盘容量支持全量迁移。
b. ONES 环境为本地磁盘储存，磁盘容量不足全量迁移，建议扩充容量。
c. ONES 环境为云磁盘储存，磁盘容量未知。请及时检查 ONES 服务器云磁盘容量是否支持迁移。
1.5 选择ONES团队
- 建议你选择「未迁移」的 ONES 团队进行 Jira 数据迁移。
- 「已迁移」的 ONES 团队将展示最近一次迁移的：1）Jira 备份包名称 2） Jira 版本 3）Jira 服务器 ID 4）迁移时间；如果选择「已迁移」的 ONES 团队进行迁移，建议你选择相同 Jira 服务器 ID，相同 Jira 版本， 相同 Jira 备份包进行迁移。
2 配置迁移操作
2.1 选择 Jira 项目
- Jira 迁移工具支持项目类型为“business”“software”的项目迁移至 ONES，如果你需要迁移其他项目类型的项目（如 Jira Service Management 下的项目），请联系 ONES 售后团队（联系方式：400-188-1518）。
- 选择需要迁移的 Jira 项目后，Jira 迁移工具将会展示这些项目下的问题类型、属性。
2.2 迁移问题类型
- 如果需要将 Jira 问题类型映射为 ONES 已有工作项类型，请在 ONES 环境下预置好需要映射的工作项类型。注意，工具仅支持标准工作项间，子工作项间的映射。
- 仅支持 Jira 问题类型一对一映射为 ONES 已有的工作项类型。
- 操作说明：
a. 创建：将该 Jira 问题类型以新建自定义 ONES 工作项类型迁移至 ONES 。
b. 映射：将该 Jira 问题类型映射为 ONES 已有的工作项类型，对应业务数据将由该 ONES 工作项类型承接。
c. 取消迁移：对应的 Jira 问题及业务数据将不会迁移至 ONES 。
d. 选择创建、映射的 Jira 问题类型，在开始迁移后，工作流，状态将对应迁移。
- 开始迁移后，已迁移的问题类型将不可更改迁移操作。
- 以下是我们推荐的 Jira 原生问题类型与 ONES 工作项类型的映射关系，请在 Jira 系统内确定 Jira 问题类型 ID 后，进行问题类型的迁移操作。如何确定 Jira 问题类型ID
| Jira 原生问题 | ONES 工作项 |
|---|---|
| Epic（史诗） | 自定义工作项 |
| Story（故事） | 需求 |
| Bug（缺陷） | 缺陷 |
| Task（任务） | 任务 |
| Subtask（子任务） | 子任务 |
2.3 迁移属性
- 支持配置问题属性、项目属性的迁移操作。如果需要将 Jira 属性映射为 ONES 已有属性，请在 ONES 环境下预置好需要映射的属性。
- 操作说明：
a. 创建：该 Jira 属性将创建为 ONES 新的自定义属性。
b. 映射：该 Jira 属性将映射为已有的 ONES 属性。
c. 取消迁移：该 Jira 属性将取消迁移，对应业务数据将不予导入。 - 对应 ONES 系统属性的迁移操作默认为映射，且用户无法更改。以下 Jira 属性将默认映射为 ONES 系统属性： a. 问题属性：
| Jira 属性名称 | Jira 属性类型 | 迁移效果 | 默认操作 | ONES 属性名称 | ONES 属性类型 |
|---|---|---|---|---|---|
| 项目 | 系统属性 | 支持迁移 | 映射 | 所属项目 | 系统属性 |
| 问题类型 | 系统属性 | 支持迁移 | 映射 | 工作项类型 | 系统属性 |
| 概要 | 系统属性 | 支持迁移 | 映射 | 标题 | 系统属性 |
| 状态 | 系统属性 | 支持迁移 | 映射 | 状态 | 系统属性 |
| 优先级 | 系统属性 | 支持迁移 | 映射 | 优先级 | 系统属性 |
| 迭代 | 系统属性 | 支持迁移 | 映射 | 所属迭代 | 系统属性 |
| 描述 | 系统属性 | 支持迁移 | 映射 | 描述 | 系统属性 |
| 修复的版本 | 系统属性 | 支持迁移 | 映射 | 关联发布 | 系统属性 |
| 经办人 | 系统属性 | 支持迁移 | 映射 | 负责人 | 系统属性 |
| 关注者 | 系统属性 | 支持迁移 | 映射 | 关注者 | 系统属性 |
| 创建时间 | 系统属性 | 支持迁移 | 映射 | 创建时间 | 系统属性 |
| 更新时间 | 系统属性 | 支持迁移 | 映射 | 更新时间 | 系统属性 |
| 到期日 | 系统属性 | 支持迁移 | 映射 | 截止日期 | 系统属性 |
- 当 Jira 属性可以映射为 ONES 单选菜单、多选菜单的属性，你还可以配置菜单选项的在 ONES 中的映射关系。
- 取消迁移，则该属性及其对应业务数据将不予迁移。
- 能够映射的属性
a. 部分属性能够映射为 ONES 系统中已有的属性，支持问题（工作项）属性间的一对一映射，项目属性间的一对一映射。以下为能够映射的 Jira 属性以及对应可以映射的 ONES 属性类型:
b. 问题属性：
| 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) | 选择用户组（多） | 单行文本 |
c. 项目属性：
| Jira 属性名称 | 英文 | Jira 属性类型 | 可以映射的 ONES 属性类型 |
|---|---|---|---|
| 项目类型 | Project type | 系统属性 | 单选菜单 |
| 项目类别 | Project catagory | 系统属性 | 单选菜单 |
| URL | URL | 系统属性 | 单行文本 |
| 描述 | Description | 系统属性 | 多行文本 |
2.4 迁移其他数据
其他数据映射中，将按照默认迁移操作进行处理。用户无法自定义对应数据的迁移操作，如果需要迁移不支持自助迁移的数据，请联系 ONES 售后服务团队（联系方式：400-188-1518）。
2.5 迁移用户
2.5.1 异常 Jira 用户
Jira 迁移工具可以帮你识别你的 Jira 系统下是否存在异常用户，包括邮箱地址无效，邮箱地址重复。 邮箱地址无效：指邮箱地址不完整，邮箱地址为空或邮箱地址包含中文字符。
- 对于此类用户，工具的默认迁移操作为「更新」，即你需要修正用户的邮箱为唯一且正确的邮箱地址。
- 你可以选择将邮箱地址无效的 Jira 用户「映射」为 ONES 中已有的用户，选择映射后，该 Jira 用户的所有业务数据将由映射的 ONES 用户承接。
邮箱地址重复：指该 Jira 用户的邮箱地址在 Jira 侧重复。
- 对于此类用户，工具的默认迁移操作为「合并」，将在 Jira 侧具有重复邮箱的用户合并为唯一的用户迁移至 ONES ，对应业务数据也将合并。注意，如果存在 Jira 用户邮箱重复且无效，你需要在合并后将此用户更新成唯一且正确的邮箱地址。
- 你可以选择不合并，在重复的用户组内选择「更新」或「映射」。
2.5.2 用户迁移操作
| 迁移操作 | 含义 |
|---|---|
| 异常用户 | |
| 更新 | 需更新有效的、唯一的用户邮箱地址（如：validemail@ones.cn）。更新用户邮箱后，以创建的形式迁移至 ONES 环境中。 |
| 映射 | 映射为当前迁移的 ONES 环境下已有的 ONES 用户。该 Jira 用户的所有业务数据将由映射的 ONES 用户承接。 |
| 合并 | 重复邮箱用户将合并为唯一的用户，业务数据也对应合并。合并后，以创建的形式迁移至ONES 环境中。 |
| 正常用户 | |
| 创建 | 以创建新用户的形式来迁移至 ONES 环境中。 |
| 映射 | 映射为当前迁移的 ONES 环境下已有的 ONES 用户。该 Jira 用户的所有业务数据将由映射的 ONES 用户承接。 |
2.5.3 Jira 迁移工具默认处理用户逻辑
- Jira 迁移工具将如何处理用户状态？
从 Jira 迁移至 ONES 环境中的用户（除迁移操作为映射）将统一处理为未授权，状态与 Jira 侧同步。
状态同步逻辑：
| Jira 用户状态 | ONES 用户状态 |
|---|---|
| 活跃 | 已激活 |
| 未活跃 | 已禁用 |
- 用户默认处理逻辑：
| 具体数据 | 操作 | 定义 | 状态 |
| Jira 用户邮箱无效 | 更新（默认） | 需更新有效的、唯一的用户邮箱地址（如：validemail@ones.cn）。更新用户邮箱后，以创建的形式迁移至 ONES 环境中。 | 可更改 |
| 映射 | 映射为当前迁移的 ONES 环境下已有的 ONES 用户。该 Jira 用户的所有业务数据将由映射的 ONES 用户承接。 | 不可更改 | |
| Jira 用户邮箱重复 | 更新 | 需更新有效的、唯一的用户邮箱地址（如：validemail@ones.cn）。更新用户邮箱后，以创建的形式迁移至 ONES 环境中。 | 可更改 |
| 合并（默认） | 重复邮箱用户将合并为唯一的用户，业务数据也对应合并。合并后，以创建的形式迁移至 ONES 环境中。 | 可更改 | |
| 映射 | 映射为当前迁移的 ONES 环境下已有的 ONES 用户。该 Jira 用户的所有业务数据将由映射的 ONES 用户承接。 | 不可更改 | |
| 正常用户 | 创建（默认） | 以创建新用户的形式来迁移至 ONES 环境中。 | 可更改 |
| 映射 | 映射为当前迁移的 ONES 环境下已有的 ONES 用户。该 Jira 用户的所有业务数据将由映射的 ONES 用户承接。 | 不可更改 | |
| 正常用户，在 ONES中有相同邮箱 | 映射（默认） | 默认为映射，且不可更改。映射为当前迁移的 ONES 环境下已有的 ONES 用户。该 Jira 用户的所有业务数据将由映射的 ONES 用户承接。 | 不可更改 |
| 已经迁移完成的用户 | 默认之前的迁移操作 | 存在之前迁移任务中已经迁移的用户，或通过 Confluence 已经迁移的用户，迁移操作则不可更改。 | 不可更改 |
- Jira 迁移工具将如何处理用户的授权？
- Jira 用户迁移至 ONES 后，统一是「未授权」的状态，我们建议将用户迁移至 ONES ，验收通过后，通过 ONES 系统内「配置中心-订单管理-授权管理」进行产品授权。
- Jira & Confluence 用户同步的策略
- 如果你需要将 Jira、Confluence 迁移至 ONES 环境中，且你的 Jira 和 Confluence 连接的是相同的用户目录：
- Jira迁移工具将会通过邮箱、 username 识别和 Confluence 相同的用户。
- 注意：请不要在迁移 Jira 、Confluence 间随意改动 Jira 邮箱（异常邮箱的 Jira 、Confluence 用户除外），如果迁移之间邮箱变动，可能会造成无法识别 Jira 、Confluence 间相同的用户，届时同一个用户的 Jira 、Confluence 数据将会在 ONES 环境中以两个账号承接。
3 开始迁移
开始迁移将占用大量 Jira、ONES 服务器资源，建议你在低峰期开始迁移。开始迁移后，迁移至 ONES 环境的数据将无法一键撤回。
3.1 迁移日志
- 迁移日志将动态展示目前迁移进度，向下更新最新迁移的数据。
- 迁移完成后，迁移日志将支持下载。
3.2 如何阅读迁移日志？
关键数据，包括：用户、用户组、项目、工作项的迁移日志将会逐条展示，非关键数据将只展示迁移错误的数据。
4 迁移完成
4.1 完成迁移
迁移完成后，请点击「完成迁移」，则此次迁移任务完成。
4.2 迁移日志
迁移完成后，可点击「下载迁移日志」进行下载。
5 联系我们
如果你需要迁移更多的数据，请联系 ONES 售后服务团队（联系方式：400-188-1518）。