钉钉新版服务端修改流程Task状态（ 同意或拒绝审批流程 ）API调用的大坑

最新推荐文章于 2024-06-07 10:51:53 发布
最新推荐文章于 2024-06-07 10:51:53 发布
阅读量2.5k 收藏 3
点赞数 1
文章标签： 钉钉 java
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_34905631/article/details/128457235
版权

文章目录

1.背景

  由于之前做了一个财务收付款关联管理的项目中接入了钉钉流程，用户会通过手机端提交一些钉钉收付款的流程，通过第三方接入的内部的酷应用实现自动化的控制，当用户提交的流程已经走到财务出纳审批的时候，到这一步会在我们后台中进行收付款的关联，然后会进行调用钉钉的流程接口去自动更改出纳这一步的task任务的状态的操作，这一步骤看似简单只要按照官方给的实列代码调用接口即可，其实不然，里面暗藏这很大的坑，官方也没有给出明确的说明，只有自己亲子踩过之后才知道，遇到这种无法解决的报错就算给官方提几个工单，没有付费官方人员也不晓得是啥问题，随便回复下你，这就是没有付费使用官方的态度，找个技术支持都找不到，这一步骤是这个项目的关键，调试了半个月都没啥进展，最后问题还是在官方的文档上找到的，参看下面第3点接入流程的第5点调用服务端OA相关API里面有相关新版流程和旧版流程的分辨，这一点恰恰是解决该问题的关键。

2.新版服务端的java依赖

       <dependency>
            <groupId>com.aliyun</groupId>
            <artifactId>dingtalk</artifactId>
            <version>1.4.89</version>
        </dependency>

3.接入流程

官方说明
https://open.dingtalk.com/document/orgapp-server/approve-or-reject-the-new-version

3.1 创建企业内部应用

在这里插入图片描述

3.2 获取AppKey和AppSecret

在这里插入图片描述

3.3 添加接口权限

在这里插入图片描述

3.4 获取应用访问凭证accessToken

  注意：服务端API差异详情参见新旧版规范服务端API区别。

  以下接口均使用服务端API接口，SDK下载详情参见新版服务端SDK。

  根据步骤二中的AppKey和AppSecret，获取应用访问凭证获取企业内部应用的accessToken。

 public void getAccessToken() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalkoauth2_1_0.Client client = new com.aliyun.dingtalkoauth2_1_0.Client(config);
        GetAccessTokenRequest accessTokenRequest = new GetAccessTokenRequest()
                .setAppKey("din*********hgn")
                .setAppSecret("9G_O************mBkhgGIO");
        GetAccessTokenResponse accessToken = client.getAccessToken(accessTokenRequest);
        System.out.println(JSON.toJSONString(accessToken.getBody()));
    }

3.5 调用服务端OA相关API

  调用新版服务端API-创建或更新审批表单模板接口，获取模板的唯一编码processCode。

  说明 :若没有保存接口返回的模板编码processCode，钉钉管理后台版本不同，获取processCode的方式不同。登录钉钉管理后台，在首页查看版本。如下图所示，页面展示回到旧版和新版反馈，说明当前是新版。 审批获取processCode

   新版钉钉管理后台：在审批模板编辑页-基础设置-页面底部查看。 OA审批-使用案例-审批附件-新增获取processcode新旧版方式

  旧版钉钉管理后台：在审批模板编辑页的URL中查看。

processCode

4.问题及其解决办法

  问题一：“errcode”:88,“sub_code”:“60011”,“sub_msg”:"没有调用该接口的权限

{"errcode":88,"sub_code":"60011","sub_msg":"没有调用该接口的权限，接口权限申请参考：https://open.dingtalk.com/document/orgapp-server/add-api-permission","errmsg":"ding talk error[subcode=60011,submsg=没有调用该接口的权限，接口权限申请参考：https://open.dingtalk.com/document/orgapp-server/add-api-permission]","request_id":"15rf1m82ty8nz"}

DingTalkClient client = new DefaultDingTalkClient(dingDingOldApiUrlConfig.getTaskUpdateUrl());
        OapiProcessWorkrecordTaskUpdateRequest req = new OapiProcessWorkrecordTaskUpdateRequest();
        OapiProcessWorkrecordTaskUpdateRequest.UpdateTaskRequest obj1 = new OapiProcessWorkrecordTaskUpdateRequest.UpdateTaskRequest();
        obj1.setAgentid(agentId);
        obj1.setProcessInstanceId(processInstanceId);
        List<OapiProcessWorkrecordTaskUpdateRequest.TaskTopVo> list3 = new ArrayList<OapiProcessWorkrecordTaskUpdateRequest.TaskTopVo>();
        OapiProcessWorkrecordTaskUpdateRequest.TaskTopVo obj4 = new OapiProcessWorkrecordTaskUpdateRequest.TaskTopVo();
        obj4.setTaskId(taskId);
        obj4.setStatus(status);
        obj4.setResult(result);
        list3.add(obj4);
        obj1.setTasks(list3);
        req.setRequest(obj1);
        OapiProcessWorkrecordTaskUpdateResponse rsp = null;
        try {
            rsp = client.execute(req, this.getOldAccessToken());
            log.info("TaskUpdate.req:{}",JSON.toJSONString(req));
            if (Objects.nonNull(rsp) && StringUtils.isNotEmpty(rsp.getCode()) && rsp.isSuccess()) {
                log.info("TaskUpdate.result:true");
                return Boolean.TRUE;
            }
        } catch (ApiException e) {
            log.error(e.getMessage());
        }

  该问题是流程表单是旧版本的流程，修改流程任务状态的接口用的自有OA审批的接口，所以需要将接口换成官方OA审批的接口。

  问题二：com.aliyun.tea.TeaException: code: 400, 审批状态异常，无法执行

com.aliyun.tea.TeaException: code: 400, 审批状态异常，无法执行 request id: 9BE05FB8-1253-7C11-994E-43A49C08B294	at com.aliyun.teaopenapi.Client.doROARequest(Client.java:403)	at com.aliyun.dingtalkworkflow_1_0.Client.executeProcessInstanceWithOptions(Client.java:345)

  该问题是流程表单是旧版本的流程，使用的是新版的API导致的，正确的做法是新建一个新版本的流程然后提交一个钉钉流程实例然后在使用这个新版的流程的实例id，去修改这个流程实列的Task中的某一个任务的状态即可，这个官方文档也没有明文说明，老版本的流程没有这个API,所以使用的老版本的流程在调用新版的API来修改流程实列的任务状态就会报这个错，给官方提了工单也是好几天才回复，他们也就随便应付下，他们都不晓得是啥问题，只能靠自己来解决问题了，没有出钱想要找到技术支持那是白日做梦，就想着白嫖，人家官方的态度就是随便应付一下我们，真TMD坑，当时是心中有万马奔腾但是问题还是得解决。

5.新版API相关代码分享

DingDingConfig配置类

@Data
@Configuration
@RefreshScope
@ConfigurationProperties(prefix = "dingding")
public class DingDingConfig {

    private List<DingDingProperties> ddp;

}

DingDingProperties类

@Data
public class DingDingProperties {

    private String appKey;

    private String appSecret;

}

新版api代码接口

@Service
@Slf4j
public class DingDingServiceImpl{

    @Autowired
    private DingDingConfig dingDingConfig;
    
    //获取token接口
    @Override
    public String getAccessToken() {
        List<DingDingProperties> ddp = dingDingConfig.getDdp();
        if (CollectionUtils.isEmpty(ddp)) {
            throw new RuntimeException("请检查钉钉配置");
        }
        DingDingProperties dingDingProperties = ddp.get(0);
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        try {
            com.aliyun.dingtalkoauth2_1_0.Client client = new com.aliyun.dingtalkoauth2_1_0.Client(config);
            GetAccessTokenRequest getAccessTokenRequest = new GetAccessTokenRequest().setAppKey(dingDingProperties.getAppKey()).setAppSecret(dingDingProperties.getAppSecret());
            GetAccessTokenResponse accessToken = client.getAccessToken(getAccessTokenRequest);
            if (Objects.nonNull(accessToken) && Objects.nonNull(accessToken.getBody())) {
                GetAccessTokenResponseBody body = accessToken.getBody();
                log.info("DingDing accessToken :{}", body);
                if (StringUtils.isNotEmpty(body.getAccessToken())) {
                    return body.getAccessToken();
                }
            }
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
            }
            log.error(err.getMessage());
        } catch (Exception _err) {
            TeaException err = new TeaException(_err.getMessage(), _err);
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
            }
            log.error(_err.getMessage());
        }
        return null;
    }

    //根据流程实例id获取流程实例
    @Override
    public GetProcessInstanceResponseBody.GetProcessInstanceResponseBodyResult getProcessInstance(String processInstanceId) {
        log.info("getProcessInstance.param:{}", processInstanceId);
        com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config();
        config.protocol = "https";
        config.regionId = "central";
        try {
            com.aliyun.dingtalkworkflow_1_0.Client client = new com.aliyun.dingtalkworkflow_1_0.Client(config);
            com.aliyun.dingtalkworkflow_1_0.models.GetProcessInstanceHeaders getProcessInstanceHeaders = new com.aliyun.dingtalkworkflow_1_0.models.GetProcessInstanceHeaders();
            getProcessInstanceHeaders.xAcsDingtalkAccessToken = this.getAccessToken();
            com.aliyun.dingtalkworkflow_1_0.models.GetProcessInstanceRequest getProcessInstanceRequest = new com.aliyun.dingtalkworkflow_1_0.models.GetProcessInstanceRequest().setProcessInstanceId(processInstanceId);
            GetProcessInstanceResponse processInstanceWithOptions = client.getProcessInstanceWithOptions(getProcessInstanceRequest, getProcessInstanceHeaders, new RuntimeOptions());
            if (Objects.nonNull(processInstanceWithOptions)) {
                GetProcessInstanceResponseBody body = processInstanceWithOptions.getBody();
                if (Objects.nonNull(body) && Objects.nonNull(body.getSuccess()) && body.getSuccess().equals("true")) {
                    GetProcessInstanceResponseBody.GetProcessInstanceResponseBodyResult result = body.getResult();
                    log.info("getProcessInstance.result :{}", result);
                    return result;
                }
            }
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
            }
            log.error(err.getMessage());
        } catch (Exception _err) {
            TeaException err = new TeaException(_err.getMessage(), _err);
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
            }
            log.error(err.getMessage());
        }
        return null;
    }

    //更新流程task的状态
    @Override
    public Boolean TaskUpdate(String processInstanceId, Long taskId, String actionerUserId, String result) {
        log.info("TaskUpdate.processInstanceId:{},taskId:{},actionerUserId:{},result:{}", processInstanceId, taskId, actionerUserId, result);
        try {
            com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config();
            config.protocol = "https";
            config.regionId = "central";
            com.aliyun.dingtalkworkflow_1_0.Client client = new com.aliyun.dingtalkworkflow_1_0.Client(config);
            com.aliyun.dingtalkworkflow_1_0.models.ExecuteProcessInstanceHeaders executeProcessInstanceHeaders = new com.aliyun.dingtalkworkflow_1_0.models.ExecuteProcessInstanceHeaders();
            executeProcessInstanceHeaders.xAcsDingtalkAccessToken = this.getAccessToken();
        /*com.aliyun.dingtalkworkflow_1_0.models.ExecuteProcessInstanceRequest.ExecuteProcessInstanceRequestFileAttachments fileAttachments0 = new com.aliyun.dingtalkworkflow_1_0.models.ExecuteProcessInstanceRequest.ExecuteProcessInstanceRequestFileAttachments()
                .setSpaceId("123")
                .setFileSize("1024")
                .setFileId("B1oQixxxx")
                .setFileName("文件名称。")
                .setFileType("file");
        com.aliyun.dingtalkworkflow_1_0.models.ExecuteProcessInstanceRequest.ExecuteProcessInstanceRequestFile file = new com.aliyun.dingtalkworkflow_1_0.models.ExecuteProcessInstanceRequest.ExecuteProcessInstanceRequestFile()
                .setPhotos(java.util.Arrays.asList(
                        "https://url1"
                ))
                .setAttachments(java.util.Arrays.asList(
                        fileAttachments0
                ));*/
            com.aliyun.dingtalkworkflow_1_0.models.ExecuteProcessInstanceRequest executeProcessInstanceRequest = new com.aliyun.dingtalkworkflow_1_0.models.ExecuteProcessInstanceRequest()
                    .setProcessInstanceId(processInstanceId)
                    .setRemark("同意。")
                    .setResult(result)
                    .setActionerUserId(actionerUserId)
                    .setTaskId(taskId);
            //.setFile(file);
            ExecuteProcessInstanceResponse rsp = client.executeProcessInstanceWithOptions(executeProcessInstanceRequest, executeProcessInstanceHeaders, new RuntimeOptions());
            if (Objects.nonNull(rsp)) {
                ExecuteProcessInstanceResponseBody body = rsp.getBody();
                if (Objects.nonNull(body) && body.getSuccess() && body.getResult()) {
                    log.info("TaskUpdate.result:true");
                    return Boolean.TRUE;
                }
            }
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
            }
            err.printStackTrace();
            log.error(err.getMessage());
        } catch (Exception _err) {
            TeaException err = new TeaException(_err.getMessage(), _err);
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
            }
            err.printStackTrace();
            log.error(err.getMessage());
        }
        return Boolean.FALSE;
    }

    //获取流程审批的附件下载地址
    @Override
    public String getDingDingProcessFileDownLoadUrl(String processInstanceId, String fileId) {
        log.info("getDingDingProcessFileDownLoadUrl.processInstanceId:{},fileId:{}", processInstanceId, fileId);
        com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config();
        config.protocol = "https";
        config.regionId = "central";
        try {
            String token = this.getAccessToken();
            com.aliyun.dingtalkworkflow_1_0.Client client = new com.aliyun.dingtalkworkflow_1_0.Client(config);
            com.aliyun.dingtalkworkflow_1_0.models.GrantProcessInstanceForDownloadFileHeaders grantProcessInstanceForDownloadFileHeaders = new com.aliyun.dingtalkworkflow_1_0.models.GrantProcessInstanceForDownloadFileHeaders();
            grantProcessInstanceForDownloadFileHeaders.xAcsDingtalkAccessToken = token;
            com.aliyun.dingtalkworkflow_1_0.models.GrantProcessInstanceForDownloadFileRequest grantProcessInstanceForDownloadFileRequest = new com.aliyun.dingtalkworkflow_1_0.models.GrantProcessInstanceForDownloadFileRequest().setProcessInstanceId("FTTrgrqLRGa0MN2cvNnKFw07551665450943").setFileId("70572744764");
            GrantProcessInstanceForDownloadFileResponse grantProcessInstanceForDownloadFileResponse = client.grantProcessInstanceForDownloadFileWithOptions(grantProcessInstanceForDownloadFileRequest, grantProcessInstanceForDownloadFileHeaders, new RuntimeOptions());
            if (Objects.nonNull(grantProcessInstanceForDownloadFileResponse) && Objects.nonNull(grantProcessInstanceForDownloadFileResponse.getBody())) {
                GrantProcessInstanceForDownloadFileResponseBody body = grantProcessInstanceForDownloadFileResponse.getBody();
                if (body.getSuccess()) {
                    log.info("spaceId:{}", body.getResult().getSpaceId());
                    log.info("fileId:{}", body.getResult().getFileId());
                    log.info("downloadUri:{}", body.getResult().getDownloadUri());
                    return body.getResult().getDownloadUri();
                }
            }
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
            }
            log.error(err.getMessage());
        } catch (Exception _err) {
            TeaException err = new TeaException(_err.getMessage(), _err);
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
            }
            log.error(_err.getMessage());
        }
        return "";
    }

}
大飞哥～BigFei
关注
  • 1
    点赞
  • 踩
  • 3
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
钉钉E应用开发踩过的小坑之钉钉官网有两个全局错误码链接，啥区别？？
m0_37271466的博客
01-15 1万+
童鞋们注意下： 做钉钉平台内部开发的有没有注意到官网有两个全局错误码链接（我只看到两个目前）： https://open-doc.dingtalk.com/microapp/serverapi2/npfg02这是一个含错误码和说明（我一直看的是这个全局错误码，只看说明的话满脑子是问号啊 O(∩_∩)O哈哈~） 而https://open-doc.dingtalk.com/doc2/detai...
钉钉开发者服务端API后台封装，微信js-sdk验证，百度编辑器后台。
06-10
钉钉开发者服务端API后台封装，微信js-sdk验证，百度编辑器后台。 下载内容是一个springboot的项目，代码中有已经实现的例子可以自己看看，这个是我开发的项目已经把涉密的内容都删除了，留下钉钉，微信，百度编辑...
钉钉小程序 没有调用该接口的权限
qubes的专栏
02-20 1059
钉钉小程序 没有调用该接口的权限。
钉钉二次开发-企业内部系统集成官方OA审批流程（二）
最新发布
suiusoar
06-07 916
企业内部系统集成钉钉官方OA审批流程
JSONPath使用
CyberPunch's Blogs
06-23 370
JSON { "errcode": 88, "sub_code": "60011", "sub_msg": "没有调用该接口的权限", "errmsg": "ding talk error[subcode=60011,submsg=没有调用该接口的权限]", "request_id": "5imjny7u9xwa" } { "errcode": 40078, "errmsg": "不存在的临时授权码" } 需求 多情况匹配（errcode/err
钉钉第三方扫码登录实现（及获取个人详细用户信息）
qq_16613311的博客
11-30 3892
package com.springcloud.base.authserver.util; import com.alibaba.fastjson.JSON; import com.dingtalk.api.DefaultDingTalkClient; import com.dingtalk.api.DingTalkClient; import com.dingtalk.api.request.OapiGettokenRequest; import com.dingtalk.api.request.Oap
解决钉钉机器人发送文件到群报错{‘errcode‘: 60011, ‘errmsg‘: ‘没有调用该接口的权限‘}
m0_52200024的博客
12-11 481
2、查钉钉开发文档发现官方给了解决办法，把requiredScopes字段的内容粘到相应位置就可以找到对应的接口权限。1、发送请求的时候把json数据打印到控制台。
钉钉小程序开发指南
zhenjingcool的博客
11-15 270
钉钉开放平台：https://open.dingtalk.com/ 钉钉开放文档：https://open.dingtalk.com/document/ 对于微应用，请参考：https://www.cnblogs.com/zhenjingcool/p/16896396.html 1 创建应用 首先，我们需要有创建应用的权限，登陆钉钉开放平台，右上角，点击“我的后台” 然后点击“应用开发-企业内...
钉钉H5微应用开发免登以及接口调试
qq_41545233的博客
12-28 5480
钉钉H5微应用开发以及接口调试 企业内部应用免登 https://open.dingtalk.com/document/orgapp-server/enterprise-internal-application-logon-free 1. H5微应用免登录开发 开发微应用      需要获取到钉钉企业的ID ，打开https://open-dev.dingtalk.com/ 地址获取，页面右上角的CorpId     &nbsp
阿里云短信服务报错：SignatureDoesNotMatch : Specified signature is not matched with our calculation.
Fanor_的博客
11-27 6901
报错内容： com.aliyuncs.exceptions.ClientException: SignatureDoesNotMatch : Specified signature is not matched with our calculation. server string to sign is:POST&%2F&AccessKeyId%3********************%26Action%3DSendSms%26Format%3DJSON%26PhoneNumbers%3D
.NET 作为客户端调用WEBAPI RESTFUL服务端以及如何开发RESTFUL服务端用于客户端调用
09-23
本篇文章将详细探讨.NET作为客户端调用WebAPI RESTful服务端的方法，以及如何开发RESTFUL服务端以供客户端调用。 首先，让我们了解一下客户端如何使用.NET调用WebAPI RESTful服务端。这通常涉及以下几个步骤： 1. ...
cxf客户端调用axis服务端流程
10-10
本文将深入探讨如何使用CXF客户端调用Axis服务端的流程。 ### 一、了解CXF和Axis **CXF**（CXF: Composite eXtensible Framework）是一个开源的Java Web服务框架，它提供了多种方式来创建和使用Web服务，包括JAX-...
C#实现微信企业号API服务端调用封装
04-27
C#实现微信企业号API服务端调用封装全部源码 1、基础方法 1.1 在回调模式下验证服务器接口地址 1.2 服务器端解密方法 1.3 服务器端加密方法 1.4 获取AccessToken（企业号的全局唯一票据） 1.5 获取企业号应用的基本...
cxf客户端调用axis服务端流程.docx
10-09
cxf客户端调用axis服务端流程.docxcxf客户端调用axis服务端流程.docx
学习记录692@阿里云OCR身份证识别报错code: 400, Specified signature does not match our calculation
教练我想学编程
03-07 590
找了半天原因，查了很多资料也没找到，后来仔细检查发现是accessKeySecret有一位数错了…
【钉钉免登录】（详解）钉钉接口，H5微应用，钉钉免登录及获取当前用户信息
No8g攻城狮的博客
05-27 7761
一、背景描述 公司做一个项目要集成到钉钉上， 二、 钉钉免登录应用注意事项： 1、创建应用； 2、配置出口IP与访问首页； 3、开放权限（手机号码信息、通讯录部门信息读权限、成员信息读权限、通讯录部门成员读权限）； 4、 ...
阿里云发送短信验证码
没对象的指针的博客
06-30 1220
阿里云短信验证码，以及验证码存取 前言 第一篇文章介绍发送验证码，以及存储,采用的方法是存入redis，后面一篇文字介绍注册登录 废话不多说，直入正题！！！！！！ 二、使用步骤 1.引入库 <!-- 阿里云发送短信 --> <dependency> <groupId>com.aliyun</groupId> <artifactId>aliyun-java-sdk-cor
阿里云短信
weixin_43827533的博客
03-22 590
配置文件application.yml (properties中文会有乱码)
钉钉第三方服务商应用ISV应用开发及上架教程
renkai721的专栏
07-25 8993
钉钉服务商应用，ISV应用上架及开发教程。
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值