反馈已提交

网络繁忙

当前为10.0版本文档,只有最新版本的文档支持在线编辑修改,如果想创建/编辑文档,请移步至 最新版帮助文档

钉钉审批单数据集插件

  • 文档创建者:小张好像不在线
  • 历史版本:1
  • 1. 概述

    1.1 版本

    报表服务器版本插件版本
    10.0/11.0V1.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才可以访问数据,否则不能获取数据】,请在该步骤配置,同时,还需要在接口权限中,添加审批单权限,创建完成后,可以拿到AppKeyAppSecret,用于获取token,如图:

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

        appkey=AppKey&appsecret=AppSecret

    其中,AppKeyAppSecret请修改为上面应用中的具体值。


    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失效,需要重新获取并填写。

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


    3. 示例

    3.1 设计报表

    • 新建一个报表wookbook

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

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

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

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



    3.2 效果预览


    4. 模板下载

    5. 注意事项

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

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


    附件列表


    主题: 移动端应用
    • 有帮助
    • 没帮助
    • 只是浏览

    售前咨询电话

    400-811-8890转1

    在线技术支持

    请前往「服务平台」,选择「在线支持」

    热线电话:400-811-8890转2

    总裁办24H投诉

    热线电话:173-1278-1526