Confluence数据类型	是否支持导入	导入效果
空间	是	导入为禅道文档库
页面	是	导入为禅道文档
文件夹	是	导入为禅道章节，保留原本结构和标题
附件	是	保留页面中上传的附件
宏	是	详见2.2
博文	是	导入为禅道文档
用户	是	导入所有用户，保留用户的昵称&邮箱
权限	是	保留空间权限配置保留文件夹权限配置保留页面权限配置保留博客权限配置保留权限配置中的用户相关数据

2.2支持迁移的宏/插件

Confluence宏/插件名称	导入效果	备注
附件宏	附件数据保留，支持下载，处理为禅道附件样式	跨页面附件引用需手动更新链接
链接类的宏	保留为普通超链接或附件链接	内部链接可追溯外部链接需检查有效性
分栏宏	保留分栏结构及内容
Jira-issue宏	转为超链接展示单个issue，链接可追溯	暂不支持实时状态同步
子页面展示宏	转为静态超链接列表，链接可追溯
引用宏	保留文本及部分功能	部分样式可能丢失
附件列表宏	转为静态附件列表，支持下载
代码宏	代码片段保留，语法高亮需手动配置，仅支持基础代码块展示
HTML宏	HTML代码转为纯文本或移除	安全策略限制脚本执行，可能丢失样式
Markdown宏	Markdown文本，保留普通文本	复杂排版需在禅道编辑器中调整
展开宏	保留文本内容，交互式折叠功能
信息面板宏	保留文本内容，颜色/图标等视觉标识
博客宏	转为禅道文档
Draw.io插件	保留图片，原始文件以附件形式存储，支持下载	需手动编辑并重新上传更新后的图表
@提及成员宏	@提及成员转为普通文本

3.迁移前准备

3.1 导入方式

Confluence数据导入，通过调用 API 接口，将 Confluence 中的页面，附件及页面结构导入到禅道系统文档模块中。

3.2 导入限制

无数据量限制：禅道对导入的 Confluence 数据量没有限制。
导入时间：由于数据解析和处理需要时间，导入时间会随着数据量的增加而延长。建议在数据量较大时，选择非高峰时段进行导入，以避免影响系统性能。

3.3 导入内容

空间：导入的内容包括 Confluence 中的所有空间和针对用户的访问权限。
页面：导入的内容包括 Confluence 空间中的页面内容以及页面树结构，页面对用户的访问权限。
附件：导入的内容为所有附件。
用户：导入所有 Confluence 用户，暂不支持导入 Confluence 中的用户群及用户的权限。

注意事项：

确认 Confluence 版本、部署方式与禅道版本、部署方式匹配，确保可正常进行数据导入。
确认 Confluence 数据格式，确保 Confluence 数据符合禅道接口导入的格式要求。
如果规划统一迁移，建议登录具备权限的迁移专用账号。
获取接口权限，确保使用的账号具备调用禅道接口的权限。
在导入前，建议对禅道现有数据进行备份，以防止数据丢失或冲突。
如果 Confluence 仍在运行，建议在导出数据前将其切换为维护模式，以避免在导出过程中产生新数据。
导入时间：由于接口导入涉及数据传输和解析，导入时间会随着数据量的增加而延长。建议在数据量较大时，选择非高峰时段进行导入。
网络稳定性：接口导入依赖网络传输，建议在稳定的网络环境下进行操作，以避免数据传输中断。

4.开始迁移

登录禅道管理员账号，在后台-数据导入中，选择导入Confluence。

点击导入 Confluence ，进入 Confluence 信息确认步骤页面。（使用REST API 接口导入数据，请保证与Confluence服务器的网络连接畅通）

4.1 连接Confluence

4.1.1 填写Confluence信息（Confluence Cloud 云版本）

Confluence域名：指访问 Confluence Cloud 服务时在浏览器地址栏中输入的地址域名
Confluence管理员账号：具备超级管理员权限的账号

Confluence密码/Token：API 令牌用于调用 Confluence 内部接口，可访问 Confluence API 令牌管理页面进行创建。获取 Token 后粘贴到输入框中。操作方法详见：如何创建 Confluence API Token

4.1.2 填写Confluence信息（ Server / Data Center 本地版本）

Confluence域名：

本地部署的 Confluence 域名通常由服务器 IP、主机名或自定义域名（如 http://confluence.yourcompany.com:8090）构成，具体取决于部署时的网络配置。
默认安装地址，安装后默认通过服务器IP或主机名访问，例如：http://服务器IP:端口（如http://192.168.1.100:8090）。
自定义域名配置：若已绑定域名，需向部署人员或IT部门确认配置的域名信息，检查服务器的反向代理配置（如Nginx/Apache）或DNS记录。

Confluence管理员账号：

管理员账号通常由安装时设置，或在后续管理中创建。在首次安装 Confluence 时，系统会提示创建第一个管理员账号（默认用户名为 admin）。

也可以在「Confluence-人员-全部用户」中查看管理员账号或者联系部署 Confluence 的负责人或团队，获取管理员账号信息。

Confluence密码/Token：

管理员密码由安装时设定，若遗忘需通过数据库重置或使用恢复模式强制修改。

点击「下一步」完成环境连接，进入导入Confluence用户页面。

4.2 导入Confluence用户

将 Confluence 中的用户导入到禅道系统中，在「后台—人员管理—用户」里查看和管理人员。

导入 Confluence 用户时选择的权限分组，可以设置用户导入到禅道后默认的权限分组，在「后台—人员管理—权限」里查看和维护权限。

点击「上一步」，可以重新修改链接 Confluence 的信息，点击「下一步」进入导入数据页面。

注：如系统中有邀请用户，推荐选择使用Confluence邮箱导入。无法获取到邮箱的用户，导入后禅道系统默认生成用户名“Confluence1、Confluence2...”，可通过用户名完成登录。

4.3 导入 Confluence 数据

进入导入数据页面，点击「开始导入」，数据将自动导入到禅道系统中。

执行正式的导入数据程序时，请不要离开该页面，此导入过程需耗费较长时间，请耐心等待。

所有类型数据导入成功之后，程序会提示“导入成功”，此刻，Confluence 数据导入完成！

5.导入映射关系表

5.1 Confluence 与禅道文档中对应关系映射表：

Confluence	————	禅道文档
空间	映射为	文档库
文件夹	映射为	章节
页面	映射为	文档
数据库	映射为	文档（暂保留原始结构和层级关系，内容数据暂无法导入）
智能链接	映射为	文档（文档中为链接）
博文	映射为	文档

说明：

Confluence 中创建的个人空间（权限设为仅对我可见），默认会将数据导入到禅道文档「我的空间—Confluence空间—同空间名称的库」中。
Confluence 中创建的除个人空间外的其他空间，默认会将数据导入到禅道文档「团队空间—Confluence空间—同空间名称的库」中。
已归档的数据，空间和页面支持导入，已归档的文件夹暂不支持导入。

5.2 Confluence 与禅道文档中权限映射表：

Confluence中的权限配置	————	禅道文档中的访问控制权限
空间权限	匹配	库访问控制权限
文件夹权限	匹配	章节访问控制权限
页面权限	匹配	文档访问控制权限
博文权限	匹配	文档访问控制权限
数据库权限	匹配	文档访问控制权限
智能链接（无单独权限）	匹配	文档访问权限—默认公开说明：