Dataphin支持设置对接企业内部、钉钉OA等审批流,提供统一的IT管理和企业化的内部流程系统,给予用户与原系统无差异的审批体验。同时支持自定义审批规则,您可以将不同敏感等级的资产权限申请配置成不同的审批规则,例如将低敏感等级的资产申请设置为自动审批,高敏感等级的资产申请设置指定审批人进行审批等。本文为您介绍如何对接外部审批系统。
相关文档
选择审批系统选择三方审批时,支持使用第三方审批流。详情请参见自定义审批系统对接接口。
背景信息
Dataphin中在对接外部审批系统时,由于Dataphin内部的用户与审批系统的用户的匹配与映射、审批系统的接口各异,与Dataphin的数据的接口不同需要转化处理等原因,往往需要开发Proxy应用,将Dataphin的接口与审批系统的接口进行对接。审批系统SDK则用于Proxy应用的研发,用户可快速基于SDK打通基本的流程。

使用限制
仅超级管理员与系统管理员角色的账号有权限进行审批设置。
注意事项
变更审批流设置时,如已有审批单在处理,需注意:
若从Dataphin内部审批流切换为对接外部审批流,则已在途(已发起审批,但未完成审批)的审批单可继续在Dataphin进行处理。
若从一个Dataphin外部审批流对接到另一个外部审批流,或变更审批流设置参数,则已在途的审批单按照新流程进行处理。若callbackURL已经变更(包括认证信息),可能造成回调失败,则不可以同步审批状态到Dataphin,需要重新发起审批,原有的审批单可通过撤回(或强制撤回)关闭。
若从外部审批流变更为内部审批流,则在途的审批单在外部审批的结果无法同步至Dataphin,原审批单可通过撤回(或强制撤回)关闭。
配置审批设置
使用超级管理员或系统管理员账号,登录元仓租户。
在Dataphin首页,在顶部菜单栏中选择管理中心 > 系统设置。
在左侧导航栏中选择系统设置 > 审批设置,打开审批设置页面。
配置默认审批系统。
当关闭外部审批系统时,默认审批系统为内置审批系统。当开启外部审批系统时,默认审批系统支持选择内置审批系统或第三方审批系统。开启外部审批系统后,还需配置外部审批系统配置和审批服务配置。
说明此处默认审批系统选择完成后,审批模板-审批系统的默认选项同此处的默认审批系统。
配置外部审批系统配置和审批服务配置。
审批系统名称:自定义审批系统名称,支持所有字符,不超过128个字符。
选择审批系统:可选择钉钉OA或其他,不同审批系统需配置不同审批服务配置。
钉钉OA
参数
描述
API地址
输入钉钉OA的API地址。
AppKey
输入钉钉OA的Key值。
AppSecert
输入钉钉OA的Secert值。
单击测试连接,可以测试Dataphin与外部审批系统的连通性。如果测试不通过,请根据页面错误提示排查处理。
Callback URL
Dataphin接收钉钉OA回调结果的URL地址,系统会自动生成Callback URL。支持自定义,格式为
https://{Dataphin部署的域名}/task/callback。Encoding AES Key
输入加解密所使用的密钥。
单击
图标,可以自动生成Encoding AES Key。Token
输入在钉钉OA客户端身份验证的令牌。
可以单击
图标自动生成。AgentId
输入钉钉OA的AgentId。
其他
外部审批系统传递不同的参数时,Dataphin中展示说明请参见Dataphin中外部审批系统传参的取值。
参数
描述
对接方式
可选择仅显示最终审批结果或显示三方审批的所有节点,默认选择仅显示最终审批结果。
仅显示最终审批结果:仅需返回审批系统的最终结果,系统中仅展示开始节点和结束节点。
显示三方审批的所有节点:需返回审批系统每个节点的详情,系统中将同步展示所有审批节点。
提交审批申请URL
对接外部审批系统的URL地址。Dataphin会将用户提交的审批,通过该URL提交到外部审批系统中。
Access Token
Access Token是访问外部审批系统的认证信息,Dataphin提交审批单至外部审批系统的时候需要填写。
单击测试连接,可以测试Dataphin与外部审批系统的连通性。如果测试不通过,请根据页面错误提示排查处理。
Callback URL
Dataphin接收外部审批系统回调结果的URL地址,系统会自动生成Callback URL。支持自定义,格式为
https://<Dataphin部署的域名>/api/oa/bpms/integration/thirdparty/callback。Encoding AES Key
输入加解密所使用的密钥。
单击
图标,可以自动生成Encoding AES Key。Dataphin中外部审批系统传参的取值
字段名称
条件
Dataphin中展示值
操作
无条件区分
node_name的值。结果
"node_status": "PENDING
待审批"node_status": "APPROVED
审批通过"node_status": "REJECTED
驳回"node_status": DELEGATED
加签${用户名称}"node_status": TRANSFERRED
转交${用户名称}操作人
"node_status": PENDING
"approverRelation":or
所有待审批人,取
pending_approvers中的user_name。"node_status": PENDING
"approverRelation":and
待审批:
${待审批人01}, ${待审批人02}, ${待审批人03}已审批:
${已审批人01}, ${已审批人02}, ${已审批人03}其余情况
操作人操作说明
"node_status": PENDING
"approverRelation":or
任一审批人同意即通过。
"node_status": PENDING
"approverRelation":and
"operator"为空
所有审批人同意才通过。
"node_status": PENDING
"approverRelation":and
"operator"不为空
部分审批人已通过,${审批同意的用户}(${同意的理由})、${审批同意的用户}(${同意的理由})...
例如:部分审批人已通过,张三(同意)、李四(需求合理,准许上线)。
其余情况
操作人的
reason。
参数配置完成后,单击保存。