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:ip:port,比如 http:127.0.0.1:8088
3. 示例编辑
3.1 设计报表
新建一个报表wookbook
选择模板数据集,点击“+”后选择钉钉审批单数据集
填写钉钉应用的token或者appKey和AppSecret,点击“获取审批单类型”按钮查询最近企业应用中的审批单
点击确定后,数据集中变会出现一个指定名称的数据集,展开数据集可以看到相关的字段
像使用一般数据集那样,将字段拖拽的报表中即可进行设计和展示了
3.2 效果预览
4. 模板下载编辑
5. 注意事项编辑
1)使用插件前,必须先去钉钉应用开发管理后台创建应用并配置好授权(ip白名单、审批接口权限等)
2)该插件当前只能获取最近120天的审批单数据,而且不支持远程设计