钉钉通讯录插件

1. 简介

1.1 功能简介

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

1.2 使用场景

适用于钉钉集成模式的简道云，需要在简道云中直接对通讯录人员、部门进行增删改等操作的场景中。

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. 智能助手Pro设置

表单设计完成后，可通过「智能助手Pro」监听表单的操作来触发插件。用户可选择 在一张表单或多张表单中触发插件。

建议智能助手使用不太熟练的用户先使用「分开多表单记录」的触发方式。

5.1 新建智能助手Pro

表单制作完成后，切换至「扩展功能」页面，新建智能助手Pro，如下图所示：

5.2 设置触发动作

智能助手比较灵活，可根据自己具体使用的场景来设置，模板表单中的智能助手设置如下所示：

5.3 设置执行动作

执行动作选择插件节点，选择插件「钉钉通讯录操作」，根据不同的表单或者操作选择不同的插件函数，字段值根据表单的内容对应起来即可。以新增客户为例，如下图所示：

6. 问题排查

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

7. 联系方式

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