本文我们将以云开发这个场景来讲解怎么使用OA 物品领用的能力。首先这节课需要两个前置条件。 1. 需要有一个钉钉组织。这个钉钉组织需要在钉钉的站点里去申请创建。
2. 钉钉组织需要在钉钉开放平台里绑定阿里云主账号,钉钉账号也要绑定一个阿里云账号。因为钉钉和阿里云的账号体系是两套,所以这两个要做一个绑定关系。 ![]()
下面是实操过程:
一、应用创建 应用创建包括两部分,一个是钉钉应用的创建,另外一部分是云开发平台的应用创建。钉钉应用相当于一个实体,云开发平台的应用是一个代码工程。
二、应用配置管理 OA 物品领用的能力很大一部分都需要做一些配置。主要包括三部分:
事件定义 API权限管理。
OA 审批单。
这几个配置都需要在钉钉开放平台完成。
三、应用开发 应用开发就是一个写代码的过程,比如调用一个API,比如怎么去发消息,这些就会涉及到调用API的过程,而这个过程会涉及到两部分,第一个是输入参数,需要准备哪些参数?第二个是参数传递进去后,响应内容是什么?只要掌握了这两部分,基本上就可以在实际写代码的过程中灵活使用API了。云开发拥有断点调试功能,可以看到里面的输入输出参数。
四、实操 首先,用自己创建好的组织扫描登录到钉钉开放平台。
选择创建应用应用的组织。
进入钉钉开放平台后,创建一个应用,如下图,选择应用类型,开发方式,填写应用名称、应用自述。 ![]()
点击开发管理右下角的按钮,去开发。
![]()
在云开发平台创建应用中编程语言选择java。然后通过模板创建,选择OA 物品领用。
![]()
下一步,计算服务我们采用函数计算,区域可以根据自己钉钉应用部署的区域选择,最后点击完成创建。
![]()
可以看一下应用配置,这里会把appkey,appsecret这两个词都通过接口的方式从钉钉开放平台传递过来。这个就是消息定义的时候需要用到的,现在这个值是应用模板默认配置的,等下我们把要这个值替换掉。
下面我们进入在线开发部署。打开Cloud IDE。
![]()
然后先配置一下这些应用。
![]()
这些参数我们都可以在ReadME里看到。
![]()
配置完,我们回到云开发平台启动一下。然后这个服务启动的是一个8080端口,我们在这里把地址映射出来。
![]() ![]()
我们把映射出来的地址拷贝到云开发这里,在这里回调地址。
![]() ![]()
现在基本上这个应用就启动了,但其实业务还没跑动起来,接下来我们还要在钉钉开放平台里做一些配置。 首先要把事件订阅中“审批任务开始、结束、转交”和“审批实例开始、结束”打开。当这两个流程在钉钉内部启动时,就会发相应的消息到钉钉里。 ![]() ![]() ![]() ![]()
在OA申请的链接里有一个流程编号,我们把这个编号拷贝到应用配置里。
![]()
下图是流程编号拷贝到的位置:
![]()
现在API权限、事件订阅、OA 审批单这三个步骤都弄好以后,我们就可以在Verde里把这个应用跑起来了。
那这里还要做什么操作呢?需要把这个地址配置到钉钉应用的主入口页面上。
![]() ![]() ![]()
如何查看、调用输入输出参数?
首先我们看一下回调这个接口是怎么操作的。我们刚才只看到日志没有断点调试,我们在这加个断点,如图:
![]()
回到刚才那个应用,我们再来操作一次,或者我们也可以在事件订阅里保存,它就会做一次测试事件,这就是一个回调的断点调试。
我们也可以在创建流程里打个断点,然后我们在手机上操作一下。
![]()
提交好OA物品领用申请后,这里断点就已经拦截住了,我们可以看一下这里的输入输出参数,这里的request 是输入参数,response是输出参数。
如何部署钉钉应用?
我们部署的是日常环境,所以选择日常环境。部署的时候会输出一个域名出来,我们把这个服务停掉。这个应用部署完了会生成另外一个临时域名出来,那这个域名它其实是回传给钉钉开放平台了。
![]()
上图就是回传回来的域名。我们用这个替换掉刚才的测试域名,这个就是启动的域名,当然事件订阅也要做修改。保存好后,这个钉钉应用其实就已经发布到线上了,然后我们就可以在手机端正常访问这个应用了。
![]()
![]() |
![]() 鲜花 |
![]() 握手 |
![]() 雷人 |
![]() 路过 |
![]() 鸡蛋 |
• 新闻资讯
• 活动频道
更多