新增待办及删除待办

本案例介绍了待办任务如何通过API发起待办等流程。

说明

本文档以企业内部应用为例，第三方企业应用实现流程类似。

预期效果

待办任务展示

接入流程简介

本文档展示了，创建一个企业内部应用，使用待办任务提供的API，实现新增待办任务、完成待办任务、删除待办任务等流程：

步骤一：登录开发者后台，点击应用开发-企业内部开发，创建企业内部应用。

步骤二：单击基础信息 > 应用信息，获取应用AppKey和AppSecret。

步骤三：添加接口调用权限，查看“待办任务”，申请待办任务对应的权限。

步骤四：获取应用访问凭证获取企业内部应用的accessToken。调用接口时，通过accessToken鉴权调用者身份。

步骤五：调用待办任务相关API：

调用服务端API-创建钉钉待办任务接口，获取待办任务id。

根据待办任务id，调用服务端API-获取钉钉待办任务详情接口，获取待办任务信息。

根据服务端API-查询企业下用户待办列表接口，获取企业用户待办列表。

根据待办任务id，调用服务端API-更新钉钉待办任务接口，更新待办任务信息及状态。

根据待办任务id，调用服务端API-删除钉钉待办任务接口，删除待办任务信息。

步骤一：创建企业内部应用

说明

如果已有企业内部应用，可直接使用已有应用，可忽略此步骤。

登录开发者后台，创建企业内部应用。

应用类型：选择H5微应用。

开发方式：选择企业自主开发。

步骤二：获取AppKey和AppSecret

获取应用AppKey和AppSecret信息。

步骤三：添加接口权限

添加接口调用权限。查看“待办任务”，申请待办任务对应的权限。

步骤四：获取应用访问凭证accessToken

重要

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

服务端API接口SDK下载，详情参见服务端SDK下载。

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

以下接口均使用新版服务端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("ding*********hgn")
                .setAppSecret("9G_O**********xamBkhgGIO");
        GetAccessTokenResponse accessToken = client.getAccessToken(accessTokenRequest);
        System.out.println(JSON.toJSONString(accessToken.getBody()));
    }

步骤五：调用待办任务相关API

调用服务端API-创建钉钉待办任务接口，获取待办任务id。

 public void createTodo() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalktodo_1_0.Client client  = new  com.aliyun.dingtalktodo_1_0.Client(config);
        CreateTodoTaskHeaders createTodoTaskHeaders = new CreateTodoTaskHeaders();
        createTodoTaskHeaders.xAcsDingtalkAccessToken = "accessToken";
        CreateTodoTaskRequest.CreateTodoTaskRequestNotifyConfigs notifyConfigs = new CreateTodoTaskRequest.CreateTodoTaskRequestNotifyConfigs()
                .setDingNotify("1");
        CreateTodoTaskRequest.CreateTodoTaskRequestDetailUrl detailUrl = new CreateTodoTaskRequest.CreateTodoTaskRequestDetailUrl()
                .setAppUrl("https://www.dingtalk.com")
                .setPcUrl("https://www.dingtalk.com");
        CreateTodoTaskRequest createTodoTaskRequest = new CreateTodoTaskRequest()
                 .setSourceId("isv_dingtalkTodo1")
                .setSubject("钉钉企业待办")
                .setCreatorId("E9C********N7QiEiE")
                .setDescription("创建钉钉待办任务")
                .setDueTime(1661767200000L)
                .setExecutorIds(java.util.Arrays.asList(
                        "tXg************RAiEiE"
                ))
                .setParticipantIds(java.util.Arrays.asList(
                        "tXg************RAiEiE"
                ))
                .setDetailUrl(detailUrl)
                .setIsOnlyShowExecutor(true)
                .setPriority(40)
                .setNotifyConfigs(notifyConfigs);
        try {
            CreateTodoTaskResponse createTodo = client.createTodoTaskWithOptions("E9C********N7QiEiE", createTodoTaskRequest, createTodoTaskHeaders, new RuntimeOptions());
            System.out.println(JSON.toJSONString(createTodo.getBody()));
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        } 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 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        }
    }

根据待办任务id，调用服务端API-获取钉钉待办任务详情接口，获取待办任务信息。

 public void getTodoInfo() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalktodo_1_0.Client client  = new  com.aliyun.dingtalktodo_1_0.Client(config);
        GetTodoTaskHeaders getTodoTaskHeaders = new GetTodoTaskHeaders();
        getTodoTaskHeaders.xAcsDingtalkAccessToken = "accessToken";
        try {
            GetTodoTaskResponse todoTaskWithOptions = client.getTodoTaskWithOptions("E9C********N7QiEiE", "task6b9d*************316fe89acd", getTodoTaskHeaders, new RuntimeOptions());
            System.out.println(JSON.toJSONString(todoTaskWithOptions.getBody()));
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        } 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 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        }
    }

根据服务端API-查询企业下用户待办列表接口，获取企业用户待办列表。

 public void getOrgTodoList() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalktodo_1_0.Client client  = new  com.aliyun.dingtalktodo_1_0.Client(config);
        QueryOrgTodoTasksHeaders queryOrgTodoTasksHeaders = new QueryOrgTodoTasksHeaders();
        queryOrgTodoTasksHeaders.xAcsDingtalkAccessToken = "accessToken";
        QueryOrgTodoTasksRequest queryOrgTodoTasksRequest = new QueryOrgTodoTasksRequest()
                .setNextToken("0")
                .setIsDone(true);
        try {
            QueryOrgTodoTasksResponse queryOrgTodoTasksResponse = client.queryOrgTodoTasksWithOptions("tXg************RAiEiE", queryOrgTodoTasksRequest, queryOrgTodoTasksHeaders, new RuntimeOptions());
            System.out.println(JSON.toJSONString(queryOrgTodoTasksResponse.getBody()));
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        } 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 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        }
    }

根据待办任务id，调用服务端API-更新钉钉待办任务接口，更新待办任务信息及状态。

public void updateTodo() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalktodo_1_0.Client client  = new  com.aliyun.dingtalktodo_1_0.Client(config);
        UpdateTodoTaskHeaders updateTodoTaskHeaders = new UpdateTodoTaskHeaders();
        updateTodoTaskHeaders.xAcsDingtalkAccessToken = "accessToken";
        UpdateTodoTaskRequest updateTodoTaskRequest = new UpdateTodoTaskRequest()
                .setOperatorId("E9C********N7QiEiE")
                .setSubject("更新钉钉企业待办")
                .setDescription("更新钉钉企业待办")
                .setDueTime(1661767200000L)
                .setDone(true)
                .setExecutorIds(java.util.Arrays.asList(
                        "tXg************RAiEiE"
                ))
                .setParticipantIds(java.util.Arrays.asList(
                        "tXg************RAiEiE"
                ));
        try {
            UpdateTodoTaskResponse updateTodoTaskResponse = client.updateTodoTaskWithOptions("E9C********N7QiEiE", "task6b9d*************316fe89acd", updateTodoTaskRequest, updateTodoTaskHeaders, new RuntimeOptions());
            System.out.println(JSON.toJSONString(updateTodoTaskResponse.getBody()));
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        } 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 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        }
    }

根据待办任务id，调用服务端API-删除钉钉待办任务接口，删除待办任务信息。

 public void deleteTodo() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalktodo_1_0.Client client  = new  com.aliyun.dingtalktodo_1_0.Client(config);
        DeleteTodoTaskHeaders deleteTodoTaskHeaders = new DeleteTodoTaskHeaders();
        deleteTodoTaskHeaders.xAcsDingtalkAccessToken = "accessToken";
        DeleteTodoTaskRequest deleteTodoTaskRequest = new DeleteTodoTaskRequest()
                .setOperatorId("E9C********N7QiEiE");
        try {
            DeleteTodoTaskResponse deleteTodoTaskResponse = client.deleteTodoTaskWithOptions("E9C********N7QiEiE", "task6b9d*************316fe89acd", deleteTodoTaskRequest, deleteTodoTaskHeaders, new RuntimeOptions());
            System.out.println(JSON.toJSONString(deleteTodoTaskResponse.getBody()));
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        } 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 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        }
    }

新增待办及删除待办

预期效果#

待办任务展示#

接入流程简介#

步骤一：创建企业内部应用#

步骤二：获取AppKey和AppSecret#

步骤三：添加接口权限#

步骤四：获取应用访问凭证accessToken#

步骤五：调用待办任务相关API#