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