魔学院数据同步插件

1. 简介

1.1 插件简介

魔学院数据同步插件，能够将魔学院平台的通讯录信息、课程信息、部门信息，同步至简道云对应表单中，可根据所需同步字段，自由编辑简道云所需数据。

1.2 应用场景

常用于打通简道云与魔学院平台通讯录、部门及课程信息同步，实现两个平台的数据互联。

1.3 预期效果

开启魔学院数据同步插件，在对应表单中设置智能助手定时任务后，在指定时间自动同步数据到表单。效果如下所示：

1.4 使用说明

1）该插件需要具有 API 权限才能使用，适用于简道云企业版及以上版本。

2）该插件为付费插件，请联系我们增购。插件购买流程如下所示：

2. 魔学院平台配置

2.1 登录管理后台

进入 魔学院官网，注册魔学院账号，注册成功后，以管理员身份进入管理后台。

2.2 创建应用

在「系统设置 >> 系统集成 >> 开放平台」处，填写应用名称、申请说明后，点击「确定」，创建一个新的应用。

2.3 获取相关参数

在提示页面中，查看应用的 CorpId、CorpSecert、Token、Key 等信息，也可以点击「复制所有」，将参数信息复制并保存下来。

2.4 获取简道云API Key

管理员登录简道云，在「开放平台 >> 密钥管理 >> API Key」处，点击「创建 API Key」，创建完成后，复制对应的 API Key。

3. 插件安装及配置

3.1 安装插件

1）直接安装

2）插件市场处安装

在简道云「插件市场」处，安装「魔学院数据同步」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。

3.2 配置插件

安装后，在插件管理中，点击插件右侧「设置」按钮，插件配置如下所示：

全部设置完成后，点击「确定」按钮。

3.3 启用插件

在插件管理中，打开魔学院数据同步插件右侧开关，启用插件。

4. 表单搭建

4.1 创建表单

插件使用需要 4 张表单，分别是：

4.2 设置字段别名

1）魔学院通讯录同步表，字段别名设置如下图所示：

2）魔学院部门同步表，字段别名设置如下图所示：

3）魔学院课程同步表，字段别名设置如下图所示：

5. 智能助手配置

5.1 通讯录同步设置

5.1.1 定时触发设置

1）进入「魔学院定时同步辅助表单」中，在「扩展功能 >> 智能助手」处新建智能助手「通讯录同步」，设置触发方式为「定时触发」。

2）设置定时触发动作如下：

5.1.2 计算节点设置

点击节点连接线上的加号按钮，添加计算节点，且计算节点设置如下：

5.1.3 修改数据节点设置

点击节点连接线上的加号按钮，添加修改数据节点，且修改数据节点设置如下：

5.1.4 插件节点设置

点击节点连接线上的加号按钮，添加插件节点，且插件节点设置如下：

5.2 部门同步

5.2.1 定时触发设置

1）进入「魔学院定时同步辅助表单」中，在「扩展功能 >> 智能助手」处新建智能助手「部门同步」，设置触发方式为「定时触发」。

2）设置定时触发动作如下：

5.2.2 计算节点设置

点击节点连接线上的加号按钮，添加计算节点，且计算节点设置如下：

5.2.3 修改数据节点设置

点击节点连接线上的加号按钮，添加修改数据节点，且修改数据节点设置如下：

5.2.4 插件节点设置

点击节点连接线上的加号按钮，添加插件节点，且插件节点设置如下：

5.3 课程同步

5.3.1 定时触发设置

1）进入「魔学院定时同步辅助表单」中，在「扩展功能 >> 智能助手」处新建智能助手「课程同步」，设置触发方式为「定时触发」。

2）设置定时触发动作如下：

5.3.2 计算节点设置

点击节点连接线上的加号按钮，添加计算节点，且计算节点设置如下：

5.3.3 修改数据节点设置

点击节点连接线上的加号按钮，添加修改数据节点，且修改数据节点设置如下：

5.3.4 插件节点设置

点击节点连接线上的加号按钮，添加插件节点，且插件节点设置如下：

5.4 效果演示

效果参见本文【1.3 预期效果】。

6. 注意事项

1）在表单「魔学院定时同步辅助表单」添加数据时，设置的下次同步时间一定要大于当前时间，否则智能助手将不会触发执行。

2）由于魔学院平台获取验证码信息限制，插件执行间隔时间尽量大于 1 小时，否则会因为插件执行频率过高导致 Token 获取封锁。

7. 联系方式

该插件为官方合作的服务商开发，若您在使用过程中有任何疑问，可通过以下方式咨询：