审批设置

相关文档

选择审批系统选择三方审批时，支持使用第三方审批流。详情请参见自定义审批系统对接接口。

背景信息

Dataphin中在对接外部审批系统时，由于Dataphin内部的用户与审批系统的用户的匹配与映射、审批系统的接口各异，与Dataphin的数据的接口不同需要转化处理等原因，往往需要开发Proxy应用，将Dataphin的接口与审批系统的接口进行对接。审批系统SDK则用于Proxy应用的研发，用户可快速基于SDK打通基本的流程。

使用限制

仅超级管理员与系统管理员角色的账号有权限进行审批设置。

注意事项

变更审批流设置时，如已有审批单在处理，需注意：

• 若从Dataphin内部审批流切换为对接外部审批流，则已在途（已发起审批，但未完成审批）的审批单可继续在Dataphin进行处理。

• 若从一个Dataphin外部审批流对接到另一个外部审批流，或变更审批流设置参数，则已在途的审批单按照新流程进行处理。若callbackURL已经变更（包括认证信息），可能造成回调失败，则不可以同步审批状态到Dataphin，需要重新发起审批，原有的审批单可通过撤回（或强制撤回）关闭。

• 若从外部审批流变更为内部审批流，则在途的审批单在外部审批的结果无法同步至Dataphin，原审批单可通过撤回（或强制撤回）关闭。

配置审批设置

1. 使用超级管理员或系统管理员账号，登录元仓租户。

2. 在Dataphin首页，在顶部菜单栏中选择管理中心 > 系统设置。

3. 在左侧导航栏中选择系统设置 > 审批设置，打开审批设置页面。

4. 配置默认审批系统。

   当关闭外部审批系统时，默认审批系统为内置审批系统。当开启外部审批系统时，默认审批系统支持选择内置审批系统或第三方审批系统。开启外部审批系统后，还需配置外部审批系统配置和审批服务配置。

   说明

   此处默认审批系统选择完成后，审批模板-审批系统的默认选项同此处的默认审批系统。

5. 配置外部审批系统配置和审批服务配置。

   • 审批系统名称：自定义审批系统名称，支持所有字符，不超过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。

6. 参数配置完成后，单击保存。

附录：对接新版钉钉OA