如何将 Zendesk 的 Help Center 迁移到 Baklib?

如果你希望通过Baklib提供统一的数字内容管理，则将Zendesk 的知识库迁移到Baklib也是非常容易的事情。

前面介绍了：Baklib VS Zendesk Guide 使用体验对比

迁移数据的方式有两种：1）通过 API 接口对接；2）通过第三方数据采集。

本文介绍的是第二种方法，前提是您已获得用户的许可。

准备工作

在迁移之前，需要了解两者的数据结构和映射关系。如下图所示，Zendesk的知识库结构有三个层级关系，分别是：Category 分类 > Sections 部分 > Articles 文章。而 Baklib 知识库中的文档都统称为 Page，并通过 parent_id 确定其父子关系。

映射关系如下：

在了解了两者的数据结构关系以后，我们就可以开始做迁移准备了，具体操作有如下几个步骤：

采集 Zendesk Help Center 上的数据，保存为Excel格式。

手动整理 Excel 数据，设置好字段映射关系。

导入 Excel 到 Baklib 知识库中。

创建一个 Wiki 站点，重现Help Center。

1. 采集 Zendesk Help Center

首先，保证在用户许可的情况下，我们通过第三方数据采集程序来完成对 Zendesk Help Center的数据采集。市面上有许多数据采集工具，这里推荐使用 APIFY（https://console.apify.com/store-search?search=zendesk）。

在 APIFY 的store中搜索 Zendesk 找到以下 Actor，输入您 Zendesk Help Center的二级域名，填写并运行，系统就跑起来了。

APIFY 上运行采集任务

根据数据量大小，一般程序会运行几分钟或更长。一旦程序运行完成，你可以在采集任务中查看结果。点击下方的“Export”，选择Excel格式，点击“Download”下载到本地。

下载数据

2. 手动整理Excel数据

打开原始数据表，查看数据结构如下：

原始数据

现在我们需要将数据列修改为 Baklib 知识库接受的字段（查看知识库导入）。如下图所示：

修改列名称

其中，绿色行为Baklib导入模板要求的列名称。最终的映射关系如下表：

通过以上操作就算人工整理好 Excel 数据了，你可以现在就直接导入到 Baklib知识库，但是会丢失掉 Zendesk的文章层级关系。所以我们还可以完成下一步进阶操作。

转换 Section

因为 Zendesk是通过 Section 来做文章分类的，而 Baklib 通过 parent_id 来建立父子级关系，所以我们还需要进一步操作：把 Section 转换为 parent_id。

1. 找到所有的 Section

Zendesk 的 Section列数据是重复的，所以我们通过以下操作找得唯一的 Section记录：选择“数据”--“删除重复性”；在弹窗中只选择“section”列，点确定，得到筛选后的结果（如下图 9 条结果），复制这 9 条section记录以备后用。然后通过Ctrl+Z回撤到最初的数据。

筛选 Section

2.添加 Section 记录

在文档顶部标题下方插入 9 行空行，在 id 中粘贴上一步获得的9 条数据，即将 section id 转换为了 parent_id。然后在 content_type 列填充值 html（值只能是 html 或 markdown），通过下方的 url 链接打开原始网页，找得 Section 名称，填写到 title 列中。

添加 Section

删除黄色的表头，保留绿色的表头。通过以上操作，完整的 Zendesk Help Center Excel 格式数据就准备好了。如下图所示：

完整的 Excel 数据表结构

3. 导入到 Baklib 知识库

首先在 Baklib 工作台的知识库中，创建一个空的知识库空间。如下图“Bike Zendesk”。

创建知识库

打开知识库，进入到知识库设置中，选择“导入记录”--“导入(.csv\.xlsx\.xls)格式文档”--“上传文件”--勾选“是否转存资源”--“开始导入”。

导入知识库

通过以上操作，一个完整的Zendesk Help Content 文档就成功的导入到 Baklib的知识库当中了，预览效果：

Zendesk知识库预览

4. 创建 wiki 站点

文档导入到 Baklib 知识库以后，如果希望呈现出类似 Zendesk Help Center的帮助中心站点，只需要给知识库绑定一个 wiki 应用即可。

在“模板市场”中找到 wiki 模板，点击“安装”--“数据源”--选择“Bike Zendesk”知识库--“下一步”--站点创建成功。

展示效果