哪些内容不会迁移¶
Jira 为工作项(Issue)返回的任何数据,都不应悄无声息地消失。工具会在两个地方记录它舍弃了什么:
- 导入包
manifest.json中的not_carried_over:每一类内容一个条目,附带说明和数量。Specivo 会在导入报告中打印这些条目。 - 记录上的
extra:在 Specivo 中没有对应位置的源数据,随所属记录一并保留,例如工作项的 Jira key,或者工作项超出 Specivo 可容纳数量的那些组件。Specivo 不导入extra,但报告会统计带有extra的记录数。
工具运行结束时,会打印清单中列出的数据种类数量。要自行查看,打开 manifest.json,找到 not_carried_over;每个条目都有一个 what(一句话说明舍弃了什么,通常还说明保存在哪里)和一个 count。
计入的内容¶
| 舍弃的内容 | 原因及去处 |
|---|---|
| 指向 Jira 中已不存在工作项的链接 | 计入。保留在工作项的 extra 中(链接类型、方向、对方工作项的 key 和 id)。 |
| Jira 中已不存在的父级,或 Epic Link 指向的 key 在 Jira 中找不到 | 计入。保留在工作项的 extra 中。 |
| 远程链接(网页链接和 Confluence 链接) | 根据变更历史计入。不会读取其内容。 |
| 超出每个工作项一个限额的组件和修复版本 | Specivo 每个工作项只有一个类别和一个目标版本。计入,并全部记入 extra。 |
| 影响版本及其历史 | Specivo 没有对应字段。计入,并记入 extra。 |
| 工作项在当前 Sprint 之前所属的 Sprint | Specivo 每个工作项只有一个冲刺(Sprint)。计入,并记入 extra。 |
| 多个项目共用的 Sprint | 变为每个项目各一个冲刺。计入。 |
| 账户无权读取的面板 | 计入。此时冲刺以工作项中标注的为准。 |
| Jira 自带类型或应用类型的自定义字段 | 连同其值一起计入。见 自定义字段。 |
| 引用应用账户的自定义字段值 | 计入。 |
| 过长、无法作为标签的 Jira 标签 | 计入。保留在 extra 中。 |
| 历史中的标签变更 | Specivo 不保留标签历史。计入。 |
| Jira 不予列出的关注者 | 计入。需要 View voters and watchers(查看投票者和关注者)权限。 |
| 投票 | 不迁移。 |
| 变更历史 中未列出的字段的历史 | 计入。 |
| Jira 未返回的历史 | 计入。 |
| 工作项描述的编辑记录 | 不迁移。 |
| 应用账户 | 其评论和变更归于 Specivo 的导入账户。 |
| 未下载的附件 | 按原因计入:超过 --max-attachment-size、被 Jira 拒绝(403)或已不存在(404)。 |
| 合并的表格单元格、单元格内的表格,以及附件不在导入包中的图片或文件 | 按类型计入。文字予以保留。 |
| 未知的富文本元素 | 按类型计入。文字予以保留。 |
完全不读取的内容¶
工具读取项目及其中的工作项。以下内容不读取:
- Confluence 页面和空间;
- 面板、筛选器和仪表板(读取面板只是为了找到 Sprint);
- 工作流、方案、屏幕和权限;
- 自动化规则;
- 插件和应用存储的数据。
角色和项目成员关系不会复制:导入后,把需要的人添加到各个 Specivo 项目中,或者通过单点登录(SSO)用户组进行映射。
你会注意到的差异¶
- 工作项编号。Specivo 按加载顺序为工作项编号,因此如果 Jira 中有已删除或已移动的工作项,之后的编号可能与 Jira 的 key 不同。见 工作项编号。
- Jira 有多个值,Specivo 只保留一个。每个工作项一个类别、一个目标版本和一个冲刺(见上文)。其余保存在
extra中。 - 预计工时以小时计。Jira 保存的是秒数;Specivo 以小时保存,精确到百分位。