1. 概述
1.1 版本
| 报表服务器版本 | 插件版本 |
|---|---|
| 10.0/11.0 | V1.0 |
1.2 应用场景
用户安装插件后，通过界面设置进行钉钉审批单内容的查询，获取某个审批单类型下的所有审批实例详情数据。
1.3 功能描述
1、可以通过手动填写token获取数据，也可以通过填写appkey和appsecret，以便自动获取token
2、根据钉钉接口查询所有审批类型，生成审批类型列表
3、用户选择某个审批类型后，后台自动根据相应的审批类型process_code执行查询，获取所有审批实例详情，预览窗口实时显示最多10条预览数据
4、该插件当前只能获取最近120天的审批单数据，而且不支持远程设计。
2. 插件介绍
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、插件支持设置网络代理
当前插件只能在外网环境使用，如果内网不能联网，只能通过代理上外网的话，可以通过配置网络代理来访问数据，目前只支持http代理和http转发方式，具体配置如下
http方式配置： http:ip:port，比如 http:127.0.0.1:8088
http接口转发方式，比如nginx反向代理钉钉接口：http://127.0.0.1:8099
3. 示例
3.1 设计报表
新建一个报表wookbook
选择模板数据集，点击“+”后选择钉钉审批单数据集
填写钉钉应用的token或者appKey和AppSecret，点击“获取审批单类型”按钮查询最近企业应用中的审批单
点击确定后，数据集中变会出现一个指定名称的数据集，展开数据集可以看到相关的字段
像使用一般数据集那样，将字段拖拽的报表中即可进行设计和展示了
3.2 效果预览
4. 模板下载
5. 注意事项
1）使用插件前，必须先去钉钉应用开发管理后台创建应用并配置好授权（ip白名单、审批接口权限等）
2）该插件当前只能获取最近120天的审批单数据，而且不支持远程设计
