必读实验说明
在开始本教程前,确保你已经完成了以下准备工作:
- 已拥有阿里云账号并完成实名认证。若未完成,请参考注册阿里云账号。
- 已经完成了钉钉开发者的注册与激活并拥有了子管理员和开发者权限。若尚未完成,请参考成为钉钉开发者。
- 为保证最好的体验,请使用最新版Chrome浏览器。
注意事项
- 本教程中使用了阿里云函数计算服务FC和日志服务SLS,开通云产品在免费资源消耗完成以后会产生费用。
- 体验完后,尽量根据文档操作应用下线,停止服务,以免产生欠费。
创建钉钉H5应用
- 登录钉钉开放平台后台. https://open-dev.dingtalk.com,如果还没有创建企业的话点击右上角的创建企业或者点击链接创建https://oa.dingtalk.com/register_new.htm。
- 创建一个H5应用。在开发者后台页面,单击应用开发,然后选择企业内部开发 > H5微应用,最后单击创建应用。
- 填写应用信息,应用类型:选择H5微应用;开发方式:选择企业自助开发,完成应用的创建。
将钉钉开放平台与阿里云平台绑定
- 在钉钉开放平台选择开发管理 > 开通云开发
- 点击确定并登录云开发平台进行绑定行为的授权
- 根据提示使用阿里云账号进行登录,授权成功后点击下一步
- 确认所需开通的产品信息,如有未开通功能需要依次开通,全部开通后,点击完成并返回
- 组织阿里云账号已经绑定,此时还再点击绑定个人阿里云账号即可实现组织和账号的一键绑定。
- 点击确定确认绑定个人阿里云账号后即可免登到阿里云云开发平台
- 绑定完成后页面右下方会出现去开发的按钮,点击去开发,并在弹出的选项中点击确定即可快速跳转至云开发平台创建应用
在云开发平台创建后端云应用
- 绑定完成后页面右下方会出现去开发的按钮,点击去开发,并在弹出的选项中点击确定即可快速跳转至云平台创建应用
- 页面跳转到云开发平台的应用创建页面,选择JAVA和通过模版创建,并在弹出的选项中选择官方模版 > 能力中心:OA物品领用,并点击下一步
- 填写基本信息,选择计算服务为FC,并选择Region(以华东2上海为例),然后点击完成创建
- 选择日常环境,然后在操作列单击应用配置,点击编辑配置参数,下一步去钉钉开放平台获取应用的参数。
该步骤需要配置钉钉应用的6个参数,4个参数已经直接获取,其中corpId和processCode需要去钉钉开放平台上获取
- aesKey= #数据加密密钥
- appKey= #H5应用Key
- appSecret= #H5应用秘钥
- corpId= #钉钉组织ID
- processCode= #审批模板唯一标识
- token= #加解密需要用到的token
- 访问钉钉开放平台首页,复制左侧的CorpId填入到应用的配置参数里面。
- 访问钉钉OA平台获取processCode
- 依次点击 工作台 > OA审批。
- 选择表单管理 > 行政管理 > 物品领用,并点击对应的编辑。
- 在URL中获取对应的processCode,填入到应用的配置参数中,点击确定完成参数的配置。
- 信息填写完成后点击保存和确定
该步骤配置的钉钉应用6个参数配置完以后复制下来备用
- aesKey= #数据加密密钥
- appKey= #H5应用Key
- appSecret= #H5应用秘钥
- corpId= #钉钉组织ID
- processCode= #审批模板唯一标识
- token= #加解密需要用到的token
- 点击部署按钮并在弹窗中确认信息无误后点击确认将产品部署上线
- 部署成功后打开日志并拷贝图中所示域名,留作备用。
钉钉H5应用配置上线
- 在钉钉开放平台选择OA物品领用的应用,选择事件订阅,使用上一步骤复制的aes_key和token的参数,并将拷贝的网址+/callback填入请求网址选项中,例如拷贝的临时域名是https://testxxxx.workbenchapi.com, 那请求网址填写https://testxxxx.workbenchapi.com/callback ,全部填写完成后点击保存。
- 将事件订阅 > 审批事件下的两个选项设置为打开。
- 选择开发管理,将步骤7)中拷贝的地址写入应用首页地址并将服务器出口ip设置为255.255.255.255并保存。
- 在权限管理中申请开通如下权限。1)通讯录管理下的成员信息读权限,2)智能工作流下的所有两个权限
- 在版本管理与发布中添加可使用人员并确认发布
- 打开“OA物品领用”钉钉应用。打开钉钉进入创建好的组织,在组织界面中找到全部的应用,在最后「未分组」中可以看到这个应用,进行使用了。
下线应用,停止计费
应用上线后会按照使用量消耗云资源,如果不需要保留应用,请及时下线,以免一直产生不必要的费用。