建议在迁移前，于 Jira 系统内删除不再使用的账号。如果同一用户在禅道已有账号，请保证jira账号与禅道账号和邮箱是一致性。
删除 Jira 系统中未使用过的问题类型和属性等数据，可以提高数据迁移配置的效率，并减少迁移所需的时间。
评估项目的状态，建议将已经完成的项目进行归档，不导入禅道的项目放入回收站。项目导入的禅道后，已归档的项目导入后状态将会变为已关闭，回收站中的项目不会导入禅道，其余项目导入后状态为进行中。

2. Jira数据导出

禅道支持jira用数据库导入或者文件导入两种方式迁移数据。

2.1Jira数据库备份

找到jira的数据库管理员，备份导出jira数据库和附件。
注：jira在8.8版本数据库进行了大改动，目前数据库导入仅支持8.8及以上版本，低版本建议升级后再进行数据库备份。

2.2Jira本地文件导出

本地文件导出路径：Jira Setings (设置)>System (系统)>Backup manager(备用管理器)>Creat backup for cloud (创建云备份)>Download cloud backup(下载云备份)

二、禅道准备

1.准备禅道环境：

安装或升级到开源版21.6以上版本的禅道，如果要导入Jira中新增的issue类型、自定义字段和workflow，需要安装升级到企业版11.6及以上版本。

2.备份禅道数据：

如果已经正在使用禅道，请在导入数据之前请务必备份好禅道数据库。
备份禅道数据及导入jira数据过程中，建议停止使用禅道，防止正在使用的数据丢失。

三、导入数据

1.功能入口

点击“后台”-“数据导入”-“从数据库导入”。

2. 导入方式选择

可以看到，导入Jira数据分为两种形式：

从数据库导入（如果您的Jira是本地部署版本,请选择此方式）
从文件导入（如果您的Jira是云版本或不方便获取数据库请选择此方式）

2.1 数据库导入

从数据库导入数据，点击“后台”-“数据导入”-“从数据库导入”。
来到预导入页面。请按照提示操作，把文件和附件放置到指定位置。
输入jira数据库后，可以点击下一步进行数据匹配。

2.2 从文件导入

从文件导入数据，点击“后台”-“数据导入”-“从文件导入”。
需要到禅道的 tmp 目录下创建 jirafile 文件夹，并确保 jirafile 文件夹有目录读写权限。
上述步骤完成后，点击下一步行数据匹配。

注：如果想要导入迭代的信息，需要输入Jira环境的域名、管理员帐号、密码/Token。
域名注意输入要注意不要写过多的URL信息，正确案例如：https://ABC.atlassian.net/或者http://11.1.1.118:8/；错误案：https://ABC.atlassian.net/jira/settings/issues/issue-types。
云版本使用Token，Token的获取方式为：jira管理员管理账户>管理账户>安全性>API令牌>创建API令牌。其他版本使用密码即可。

3.设置Jira与禅道的对象

因为Jira的对象类型、字段、对象状态、解决方案、关联关系等都是允许自定义的，所以把它导入到禅道前我们需要设置一个关系的映射。

第一步是设置Jira Issue 对应的禅道对象，禅道对象主要是用户需求、软件需求、任务、Bug，企业版本增加了反馈、工单、禅道系统里的已发布的工作流对象、新增成工作流。
选择映射关系时，如果选择新增成工作流，导入后将自动在工作流中创建一个新对象，且不需要进行字段、状态和解决方案的映射了，系统将自动处理。
为了方便用户快速导入，我们对数据进行了默认值的处理，您也可以修改默认值，选择您需要的匹配对象，没有默认值的对象，您可以选择禅道已有对象，也可以选择新增成工作流。
同时，系统对没有使用过的lssue类型进行了过滤，不会显示在页面中，您就不需要处理了。

4.设置Issue字段与禅道对象字段的映射关系

接下来用户需要对每个Issue单独进行字段的映射关系设置。
选择映射关系时，若选择新增，导入后将自动创建新字段，未选择的字段则不会导入。
为了方便用户快速导入，我们对内置数据进行了默认处理，内置字段不会显示在页面上，页面字段只会列出有使用过数据的自定义字段，默认值为新增，您也可以修改为禅道的已有字段。

导入禅道系统的内置字段的映射如下图：

5.设置Issue状态与禅道对象状态的映射关系

主要设置Jira Issues 状态对应禅道需求状态、需求阶段、任务状态、Bug状态、反馈状态、工单状态等。
用户需要对每个Issue单独进行状态的映射关系设置。
为了方便用户快速导入，我们对内置状态进行了默认映射，用户也可以手动修改。
如果不选择映射关系，导入数据后，系统会默认匹配一个状态，例如：需求的状态为激活，阶段为未开始；任务的状态为未开始等。

6.设置Issue解决方案与禅道对象状态的映射关系

主要是设置Jira的解决方案中对应禅道Bug解决方案和禅道需求/任务/反馈/工单的关闭原因。
用户需要对每个Issue单独进行状态的映射关系设置。
同样为了方便用户快速导入，我们对内置解决方案进行了默认映射，用户也可以手动修改。
若选择新增，导入后将自动创建新解决方案，未选择的解决方案导入后默认匹配为已完成。

7.设置全局映射关系

主要是设置Jira的事务关联关系类型对应禅道的关联关系。
选择映射关系时，可以选择系统已有关联关系，也可以选择新增；若选择新增，导入后将自动创建关联关系，未选择的关联关系不导入。

建议匹配关联关系如下图，其余关联关系可根据实际情况匹配或新增：

8.设置Jira用户

主要是设置修改Jira用户登录禅道密码和权限分组。

导入用户时，用户名可以选中使用Jira帐号或使用Jira邮箱，推荐使用使用Jira帐号。
导入后的用户名如果与系统已有用户名一致，系统会合并为同一个用户，导入前请检查用户名数据，避免不同用户的重名。
因为禅道对用户密码的加密算法和Jira中的不一致，所以在导入Jira用户的时候，我们需要设置导入过来的用户的默认密码和权限分组，Jira的用户导入过来之后，密码统一为该页面设置的密码。

9.开始导入Jira数据

密码和权限分组设置好之后，点击下一步，来到最终的导入数据页面：

点击开始导入即可。导入数据需要一段时间，请耐心等待。
点击开始导入按钮，执行正式的导入数据程序：

所有对象导入成功之后，程序会提示“导入成功”，此刻，Jira数据导入完成！

四、功能使用对照

功能对照如下，可以点击使用手册链接查看说明，注意使用说明在左上角可以切换禅道版本号。

	jira	禅道	禅道功能使用手册
Jira项目功能	项目（Project ）	项目	https://www.zentao.net/book/zentaopms/1597.html
Jira项目功能	迭代（Sprint）	迭代	https://www.zentao.net/book/zentaopms/890.html
Jira项目功能	版本（Release）	发布	https://www.zentao.net/book/zentaopms/888.html
Jira项目功能	权限配置（Permission Schemes）	项目-设置-权限	https://www.zentao.net/book/zentaopms/482.html
issue类型	Epic	用户需求	https://www.zentao.net/book/zentaopms/886.html
issue类型	Story	软件需求	https://www.zentao.net/book/zentaopms/886.html
issue类型	Task	任务	https://www.zentao.net/book/zentaopms/891.html
issue类型	Bug	bug	https://www.zentao.net/book/zentaopms/897.html
系统功能	用户（Users）	后台-人员管理	https://www.zentao.net/book/zentaopms/1009.html
系统功能	问题类型（Issue Type）	工作流-对象	https://www.zentao.net/book/zentaopms/workflow-1534.html
系统功能	字段（Field）	工作流-字段	https://www.zentao.net/book/zentaopms/workflow-1534.html
系统功能	状态（Statuses）	工作流-状态	https://www.zentao.net/book/zentaopms/workflow-1534.html
系统功能	页面（Screen Scheme）	工作流-页面	https://www.zentao.net/book/zentaopms/workflow-1534.html
系统功能	通知设置（Notification）	后台-通知设置	https://www.zentao.net/book/zentaopms/999.html
系统功能	优先级（Priorities）	后台-功能配置-优先级	https://www.zentao.net/book/zentaopms/1624.html
系统功能	问题链接（Issue Linking）	后台-功能设置-关联关系	https://www.zentao.net/book/zentaopms/browseRelation-1576.html
系统功能	解决方案（Resolution）	关闭原因	https://www.zentao.net/book/zentaopms/1624.html
系统功能	自动化（Automation）	规则引擎	即将发布