1.1 版本

1.2 应用场景

此处说明下插件在什么场景下使用，能够解决什么问题，且要在下面附上一张插件效果图

用户安装插件后，通过界面设置进行钉钉审批单内容的查询，获取某个审批单类型下的所有审批实例详情数据。

1.3 功能描述

1、可以通过手动填写token获取数据，也可以通过填写appkey和appsecret，以便自动获取token

2、根据钉钉接口查询所有审批类型，生成审批类型列表

3、用户选择某个审批类型后，后台自动根据相应的审批类型process_code执行查询，获取所有审批实例详情，预览窗口实时显示最多10条预览数据

4、该插件当前只能获取最近120天的审批单数据，而且不支持远程设计。

2.1 插件安装

点击下载插件：钉钉审批单数据集插件

设计器插件安装方法请参见：设计器插件管理

服务器安装插件方法请参见：服务器插件管理

2.2 操作方法

用户安装插件后，通过“模板数据集”界面或者“服务器数据集”界面选择该插件，设置token信息，进行钉钉审批单内容的查询，获取某个审批单类型下的所有审批实例详情数据。插件的主要工作流程如下：

在该插件中，如果是新创建数据集插件，第一步需要手动获取token，获取token的步骤如下（参考文档：https://ding-doc.dingtalk.com/doc#/serverapi2/eev437  ）：

1、首先需要创建企业后台应用，参考文档：https://ding-doc.dingtalk.com/doc#/bgb96b/gt5d6a ，如果需要指定访问ip白名单【注：指定ip后，只有满足条件的ip才可以访问数据，否则不能获取数据】，请在该步骤配置，同时，还需要在接口权限中，添加审批单权限，创建完成后，可以拿到AppKey和AppSecret，用于获取token，如图：

【更新说明】：token输入框可以填appkey和appsecret，以便自动获取token，具体格式如下：

    appkey=AppKey&appsecret=AppSecret

其中，AppKey和AppSecret请修改为上面应用中的具体值。

2、请求地址：https://oapi.dingtalk.com/gettoken?appkey=AppKey&appsecret=AppSecret 即可拿到token，url中红色部分即为前面步骤获取的具体值，需替换为自己的

输入token后点击查询，根据钉钉接口查询所有审批类型，生成审批类型列表，填充到下拉框中（钉钉创建审批单模板，参考文档：https://ding-doc.dingtalk.com/doc#/serverapi2/tvu5f4）。

用户选择某个审批类型后，后台自动根据相应的审批类型process_code执行查询，获取所有审批实例详情，预览窗口实时显示最多10条预览数据。

   如果保存后再次打开数据集界面，或者是点击数据集预览窗口，则会根据插件配置的token和审批单类型code自动执行插件并预览数据，如果token失效，需要重新获取并填写。

注：如果第一步设置的是AppKey和AppSecret，则无需手动请求token，插件会自动请求token，建议使用、填写AppKey和AppSecret的模式。

3.1 设计报表

• 新建一个报表wookbook

• 选择模板数据集，点击“+”后选择钉钉审批单数据集

• 填写钉钉应用的token或者appKey和AppSecret，点击“获取审批单类型”按钮查询最近企业应用中的审批单

• 点击确定后，数据集中变会出现一个指定名称的数据集，展开数据集可以看到相关的字段

• 像使用一般数据集那样，将字段拖拽的报表中即可进行设计和展示了

3.2 效果预览

dingding.cpt

使用插件前，必须先去钉钉应用开发管理后台创建应用并配置好授权（ip白名单、审批接口权限等）

该插件当前只能获取最近120天的审批单数据，而且不支持远程设计