哪些内容不会迁移

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 以小时保存,精确到百分位。