审批系统

本文介绍在 Zadig 系统上集成审批应用，目前支持集成飞书应用和钉钉应用。

飞书

提示

用户在飞书上审批完成后，飞书平台需回调审批状态到 Zadig 上，为保证飞书审批功能正常使用，请保证飞书平台可以访问 Zadig 域名。

按照以下流程配置飞书审批：

1. 在飞书开发者平台创建应用并发布
2. 配置应用凭证信息到 Zadig 系统，获得应用推送事件消息的请求地址
3. 在飞书开发者平台配置请求地址

步骤 1：创建飞书应用

1. 访问飞书开发者平台 (opens new window)，创建「企业自建应用」，如下图所示。

1. 在权限管理中设置通讯录权限范围，并开通审批应用需要的权限，如下图所示。

Zadig 的工作流支持配置飞书审批，可选审批人和此处指定的通讯录范围有关。

需要的权限项如下：

• approval:approval
• approval:approval.list:readonly
• approval:approval:readonly
• contact:user.id:readonly
• contact:contact:readonly_as_app
• contact:user.employee_id:readonly

1. 创建应用版本，并申请发布。

应用发布过程需要的其他信息请自行配置，此处不详细赘述。

1. 获取 App ID、App Secret 和 Encrypt Key。

应用发布审批通过后，进行下一步配置。

步骤 2：集成审批系统

访问 Zadig，点击系统设置->系统集成->审批系统，添加飞书审批应用，如下图所示。

参数说明：

• 应用名称：自定义，方便在 Zadig 系统中识别
• APP ID：在 步骤 1 中获取
• APP Secret：在 步骤 1 中获取
• Encrypt Key：在 步骤 1 中获取

填写完成后获取「请求地址」，并保存配置。

步骤 3：配置「请求地址」和「事件」

1. 配置请求地址。访问飞书开发者平台 (opens new window)，填写请求地址，如下图所示。

1. 添加事件。点击「事件订阅」-> 「添加事件」，选择审批任务状态变更。

提示

完成配置后需再次创建应用版本，并发布最新版本。

钉钉

提示

用户在钉钉上审批完成后，钉钉平台需回调审批状态到 Zadig 上，为保证钉钉审批功能正常使用，请保证钉钉平台可以访问 Zadig 域名。

按照以下流程配置钉钉审批：

1. 在钉钉开发者平台创建应用并发布
2. 配置应用凭证信息到 Zadig 系统，获得应用推送事件消息的请求网址
3. 在钉钉开发者平台配置请求网址

步骤 1：创建钉钉应用

1. 访问钉钉开放平台 (opens new window)，创建应用，如下图所示。

2. 在权限管理中配置权限范围，并开通审批应用需要的权限，如下图所示。

Zadig 的工作流支持配置钉钉审批，可选审批人和此处指定的权限范围有关。

需要的权限项如下：

• snsapi_base
• qyapi_base
• Contact.User.Read
• qyapi_get_department_list
• qyapi_get_member
• qyapi_get_member_by_mobile
• Workflow.Form.Write
• Workflow.Form.Read
• Workflow.Instance.Read
• Workflow.Instance.Write

1. 获取 AppKey、AppSecret、aes_key 和 token 信息。

AppKey 和 AppSecret 在应用信息中获取：

aes_key 和 token 在事件与回调中获取：

提示：保存 aes_key 等信息后请勿关闭当前页面，在 Zadig 中配置完毕后还需填写此处的请求网址。

步骤 2：集成审批系统

访问 Zadig，点击系统设置->系统集成->审批系统，添加钉钉审批应用，如下图所示。

参数说明：

• 应用名称：自定义，方便在 Zadig 系统中识别
• APPKey：在 步骤 1 中获取
• APPSecret：在 步骤 1 中获取
• aes_key：在 步骤 1 中获取
• token：在 步骤 1 中获取

填写完成后复制「请求网址」，并保存配置。

步骤 3：配置「请求网址」和「事件」

1. 访问钉钉开放平台 - 应用功能 - 事件与回调，填写请求网址并保存。

1. 在审批事件中开启以下事件：

• 审批任务开始，结束，转交
• 审批实例开始，结束

扩展阅读

在 Zadig 中使用飞书审批

参考文档：飞书审批

在 Zadig 中使用钉钉审批

参考文档：钉钉审批