Question

从禅道开源版16.4版本开始，支持导入Jira数据。

出于安全原因，该功能只有超级管理员可用。

在导入数据之前请务必备份好禅道和Jira的数据库和附件。
导入前需要设置Jira和禅道的对应关系，请根据实际使用按照提示设置好对应关系。
目前不支持导入Jira里的工作流。

因为低PHP处理导入数据的性能较低，目前低于PHP5.6的版本，不支持导入Jira数据。

导入的过程中需要一些时间，请耐心等待。

一、导入Jira数据的操作步骤

1.如果Jira使用MySQL数据库，导出Jira数据库；如果Jira使用非MySQL数据库，导出Jira的XML格式文件；导出Jira的附件。
2.备份禅道的数据库，发布提示准备进行Jira数据导入，请大家暂时不要使用禅道。

3.超级管理员到禅道后台--系统--导入Jira数据，选择导入的方式：从数据库导入、从文件导入。
4.按照提示把Jira数据、附件、文件放到指定目录，并确保目录有权限。

5.按照提示设置Jira和禅道的对应关系：对象、对象关联关系、解决方案、状态、用户的密码和权限分组。
6.设置成功后，点击导入数据。

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

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

• 从数据库导入（仅支持使用MySQL数据库的Jira用户）
• 从Jira备份文件导入（支持所有Jira用户）

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

来到预导入页面。请按照提示操作，把文件和附件放置到指定位置。

点击。

从文件导入数据，点击“后台”-“数据导入”-“从文件导入”。

需要到禅道的 tmp 目录下创建 jirafile 文件夹，并确保 jirafile 文件夹有目录读写权限。

二、设置Jira和禅道数据对应关系

因为导入数据是高风险操作，所以在导入之前，我们需要做好数据库备份。

为了应对Jira数据量较大的情况，我们把导入程序做成了多次执行，一次执行少量数据的形式，导入过程中会消耗较大的内存。

所以请尽量保证在执行导入的操作过程中，没有其他用户在使用禅道。

除了导入Jira数据之外，我们还需要导入Jira的附件，所以请把Jira的附件放到服务器上的指定位置。

接下来我们导入Jira的数据库到禅道使用的MySQL中，然后在页面上输入导入到MySQL中的Jira数据库名，进行下一步操作。

如果上述一切操作正常，点击下一步会来到设置Jira和禅道数据对应关系的页面。
请按照提示设置好对应关系，如果没有设置对应关系，Jira该类型下的数据在导入时将不会被识别，也就不会被导入到禅道系统中。
1.设置Jira与禅道的对象
主要是设置Jira Issues 对应的禅道对象，禅道对象主要是用户需求、软件需求、任务、Bug。
设置完成后，点击下一步即可。

2.设置Jira与禅道的对象关联关系

主要设置对象的关联关系，禅道关联关系主要有：父-子任务、父-子需求、重复对象、相互关联。

3.设置Jira与禅道的解决方案

主要是设置Jira的解决方案中对应禅道Bug解决方案和禅道需求关闭原因。

4.设置Jira与禅道的状态

主要设置Jira Issues 状态对应禅道需求状态、需求阶段、任务状态、Bug状态。

因为Jira的对象类型、关联关系、解决方案、对象状态等都是自定义的，所以把它导入到禅道里我们需要设置一个关系的映射，如果不选则该类型不会导入到禅道中。

设置对应关系的页面大同小异，根据自己的实际情况选择即可，当所有对应关系设置好之后，我们点击下一步会来到设置用户页面：

5.设置Jira用户

主要是设置修改Jira用户登录禅道密码和权限分组。
因为禅道对用户密码的加密算法和Jira中的不一致，所以在导入Jira用户的时候，我们需要设置导入过来的用户的默认密码和权限分组，Jira的用户导入过来之后，密码统一为该页面设置的密码。

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

6.开始导入Jira数据

点击下一步后，再点击开始导入即可。导入数据需要一段时间，请耐心等待。

点击开始导入按钮，执行正式的导入数据程序：

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

第二种导入方式【从文件导入】和第一种方式类似，按照页面提示操作即可，这里不再赘述。

祝导入数据顺利，欢迎来到禅道的世界！