钉钉如何接入钉钉OA审批?
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
要接入钉钉OA审批,您可以使用钉钉提供的审批应用接口来实现与钉钉OA审批的集成。以下是一般的接入步骤:
创建审批应用: 在钉钉开放平台的管理后台中,创建一个审批应用,并获取对应的AgentID和AccessToken。审批应用可以用于发起和管理审批流程。
构建审批实例: 根据您的业务需求,构建相应的审批流程实例,包括审批流程的模板、节点、表单等信息。
调用审批应用API发起审批: 使用编程语言或工具,在您的应用程序中调用钉钉审批应用的API接口,通过传递需要的参数来发起审批。例如,您可以使用 dingtalk.smartwork.bpms.processinstance.create
接口来发起一个审批实例。
处理审批结果: 钉钉会将审批结果以回调方式通知到您的服务器。您需要编写相应的代码逻辑来接收、解析和处理审批结果回调。
示例代码(Python):
import requests
access_token = "your_access_token"
url = "https://oapi.dingtalk.com/topapi/processinstance/create?access_token=" + access_token
data = {
"process_code": "your_process_code",
"originator_user_id": "your_user_id",
"dept_id": "your_dept_id",
"form_component_values": [
{
"name": "field_name1",
"value": "field_value1"
},
{
"name": "field_name2",
"value": "field_value2"
}
]
}
response = requests.post(url, json=data)
上述示例中的 access_token
是您的审批应用的AccessToken,process_code
是您定义的审批流程编码,originator_user_id
是发起人的用户ID,dept_id
是发起部门的部门ID,form_component_values
是审批表单的字段值。
要接入钉钉OA审批,您可以按照以下步骤进行操作:
创建企业自建应用:在钉钉开放平台上创建一个企业自建应用。提供应用的基本信息,如应用名称、LOGO和回调地址等。
获取应用的AgentId和AppKey:创建成功后,获得一个AgentId和AppKey,作为与您的应用关联的唯一标识符。保存好这些信息,以便后续使用。
开发OA审批接口:根据您的需求和业务逻辑,使用钉钉提供的API开发与OA审批相关的接口。通过这些接口,您可以实现创建、查询、更新和撤销审批实例等操作。
接收审批事件回调:为了获取审批实例的变更通知,您可以设置一个回调URL,用于接收审批事件的推送通知。钉钉将在审批实例状态发生变化时向该URL发送相应的回调通知。
调用OA审批接口:在您的应用中,使用相应的API调用来创建、查询、更新或撤销审批实例。您可以根据业务需求和用户操作,在钉钉工作台或其他位置展示和操作审批流程。
步骤一:创建和配置应用
参考以下操作,创建一个小程序应用:
使用管理员账号登录钉钉开发者后台。
说明
只有管理员和子管理员可登录开发者后台。
在应用开发页面,选择企业内部开发,然后单击创建应用。
填写应用的基本信息,然后单击确定创建。
在应用信息页面,单击开发管理,然后单击修改。
根据以下信息配置开发信息,然后单击保存。
服务器出口IP:输入调用钉钉服务端API时使用的IP即企业服务器的公网IP,多个IP请以","隔开,支持带一个*号通配符的IP格式。
本示例中输入127.0.0.1。
PC端首页地址(可选):输入在PC端钉钉工作台上打开本应用的地址。链接地址必须以http或https开头。
说明
如果未填写,在钉钉PC端工作台点击应用图标时,会提示“电脑版暂不支持显示,请用手机钉钉扫描下方二维码查看”。只能在手机钉钉客户端使用小程序应用。
管理后台地址(可选):输入组织管理员在钉钉管理后台访问该应用的地址。
单击权限管理,添加通讯录和审批接口权限。
通讯录相关权限
单击通讯录管理,选择通讯录相关接口权限,然后单击申请权限。
审批相关接口权限
单击OA审批,选择审批相关接口权限,然后单击申请权限。
单击安全中心,然后单击添加添加一个HTTP安全域名。
当小程序的前端与服务端需要进行网络通信时,需要设置安全域名。小程序前端只能通过已设置的安全域名(或IP)与服务端进行网络通信。当安全域名更新时,需要在小程序开发工具重新打包上传版本,设置的域名才会生效。
安全域名是后端服务部署的服务器的公网IP或域名。
单击基础信息获取应用的AppKey和AppSecret。
要在钉钉中接入钉钉 OA ,您需要进行以下步骤:
钉钉上的企业或组织可以基于钉钉的开放能力,自主开发供企业或组织内部使用,以满足办公场景中的个性化需求。该类应用无需钉钉团队审核,企业内部自行开发并使用即可。以下应用类型均支持接入OA审批:企业内部应用、第三方企业应用。OA审批开放的接口可以对审批实例等进行操作,将企业原有的业务系统与钉钉OA审批打通。企业可以参考客户案例来了解更多应用场景。钉钉的OA审批提供了丰富的接口开放能力,开发者可以通过API接口实现OA审批和企业业务系统打通。
此回答整理自钉群“钉钉开发者社区(互助群)”