钉钉通讯录插件

1. 简介

1.1 功能简介

钉钉通讯录插件，可以方便在钉钉集成模式下的简道云中管理钉钉的通讯录人员及部门信息，并管理入职、离职、职位变动等信息。

1.2 使用场景

适用于钉钉集成模式的简道云，把 HR 管理系统或其它系统把人员以及部门的增、删、 修改等操作放到简道云中的场景，在简道云中管理入职、离职、职位变动、以及部门新增与修改的情况。

1.3 预期效果

以使用「创建用户」函数，在简道云创建钉钉通讯录人员为例，效果如下所示：

1.4 使用说明

1）该插件适用于简道云企业版且为钉钉集成模式的简道云，需要具有 API 权限才能使用，并确保具有简道云对应表单的操作权限。

2）该插件包含 6 种事件，如下所示：

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

2. 钉钉平台配置

2.1 创建钉钉应用

1）管理员需要 PC 端登录 钉钉开放平台，选择「应用开发 >> 钉钉应用」，点击「创建应用」。如下图所示：

2）在创建应用详情页中，填写应用名称和应用描述，并上传应用图标后，点击「保存」按钮。如下图所示：

2.2 权限申请

在应用开发详情页中，进入「权限管理 >> 通讯录管理」处，勾选「维护通讯录的接口访问权限」并点击「申请权限」按钮。如下图所示：

2.3 记录Appkey和AppSecret

在「凭证与基础信息」处，记录下创建的应用的 Appkey 和 AppSecret ，插件配置时需要填写。如下图所示：

3. 插件安装及配置

3.1 安装插件

1）直接安装

2）插件市场处安装

在简道云「插件市场」处，安装「钉钉考勤请假同步」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。

3.2 配置插件

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

3.3 启用插件

在插件管理中，打开钉钉通讯录操作插件的右侧开关，启用插件。

4. 表单搭建

1）插件的功能及配置需要使用 6 张表单，分别是：

2）表单设计完成后，在「扩展功能＞>数据推送」处，点击「设置字段别名」，来配置每个表单字段的字段别名。

5. 智能助手配置

5.1 创建钉钉用户

5.1.1 新建智能助手

进入「创建用户」表单，在「扩展功能 >> 智能助手」处，点击「新建智能助手」，修改智能助手的名称为「钉钉新增用户」，选择触发方式为「表单触发」并选择「创建用户」表单。

5.1.2 设置触发动作

表单触发参考设置：

触发条件可根据具体场景设置。

5.1.3 添加并设置插件节点

添加插件节点，插件节点设置如下：

5.2 用户信息修改

5.2.1 新建智能助手

进入「用户信息修改」表单，在「扩展功能 >> 智能助手」处，点击「新建智能助手」，修改智能助手的名称为「钉钉用户信息修改」，选择触发方式为「表单触发」并选择「用户信息修改」表单。

5.2.2 设置表单触发动作

表单触发参考设置：

触发条件可根据具体场景设置。

5.2.3 添加并设置插件节点

添加插件节点，插件节点设置如下：

5.3 用户删除

5.3.1 新建智能助手

进入「用户删除」表单，在「扩展功能 >> 智能助手」处，点击「新建智能助手」，修改智能助手的名称为「钉钉用户删除」，选择触发方式为「表单触发」并选择「用户删除」表单。

5.3.2 设置表单触发动作

表单触发参考设置：

触发条件可根据具体场景设置。

5.3.3 添加并设置插件节点

添加插件节点，插件节点设置如下：

6. 注意事项

6.1 部门管理

钉钉部门管理下「部门创建」、「部门信息修改」、「部门删除」表单配置流程与用户管理相同，可以参考钉钉用户的创建、信息修改、删除，详见本文【5. 智能助手配置】。

6.2 思路拓展

6.3 问题排查

插件在每个操作中都会往表单中返回执行状态以及钉钉返回值的原始内容，可在每个表单中设置以下两个字段来排查问题。

7. 联系方式

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