对接新版钉钉OA

使用限制

仅Dataphin地址为公网地址的Dataphin，支持配置钉钉OA审批。

操作步骤

步骤一：创建钉钉应用

1. 拥有钉钉开放平台开发权限的用户登录钉钉开发平台。

2. 在钉钉应用页面，单击创建应用，在创建应用面板中输入应用名称和应用描述，并上传应用图标。

   • 应用名称：输入2~20个字符之间的名称，支持所有字符。

   • 应用描述：输入4~200个字符之间的描述，方便应用使用者了解应用的用途和具体功能，支持所有字符。

   • 应用图标：上传240*240px以上、2MB以内的无圆角JPG或PNG图标。可单击查看图标规范，查看详情规则。

   

   配置完成后，单击保存。

步骤二：在权限管理中开启OA审批相关权限

1. 在权限管理页面的左侧导航栏中，选择OA审批。

2. 在权限信息列表中，开启审批流数据管理权限、工作流实例写权限、工作流模板写权限、工作流模板读权限和工作流实例读权限。

步骤三：获取应用凭证

1. 在左侧导航栏中，选择基础信息 > 凭证与基础信息。

2. 在右侧页面中，获取应用凭证，包含AgentID、Client ID（原AppKey和SuiteKey）、Client Secret（原AppSecret和SuiteSecret）。

步骤四：在Dataphin中配置钉钉OA审批系统

1. 前往Dataphin元仓租户 > 管理中心 > 系统设置 > 审批设置，配置钉钉OA审批。

   参数		描述
   审批设置	默认审批系统	选择第三方审批系统（审批设置保存后，默认审批系统名称将根据审批系统名称展示）。
   	外部审批系统	开启后，方可对外部审批系统进行配置。
   外部审批系统配置	审批系统名称	自定义审批系统名称，不能超过128个字符。
   	选择审批系统	选择钉钉OA。
   审批服务配置	API地址	填写固定地址http://oapi.dingtalk.com。
   	AppKey	填写上一步获取到的Client ID（原AppKey和SuiteKey）。
   	AppSecret	填写上一步获取到的Client Secret（原AppSecret和SuiteSecret）。
   	Callback URL	保持默认值即可，可单击图标复制地址。
   	Encoding AES Key	单击图标，系统将自动生成相应参数。
   	Token
   	AgentId	填写上一步获取到的AgentID。

2. 配置完成后，单击保存。

步骤五：在钉钉开放平台中配置事件订阅

1. 前往钉钉开发平台 > 开发配置 > 事件订阅中，配置订阅管理信息。

   • 推送方式：选择HTTP推送。

   • 加密aes_key、签名token、请求网址：填写上一步在Dataphin中获取的Encoding AES Key、Token和Callback URL。

   

2. 配置完成后，单击保存。

步骤六：发布应用

1. 在左侧导航栏中选择应用发布 > 版本管理与发布，在版本管理与发布页面单击创建新版本。

2. 在版本详情页面，填写应用版本号和版本描述，并选择当前应用的可用范围。其中应用可用范围默认选择为全部员工，您可根据实际需要进行选择。配置完成后，单击保存，在弹出的对话框中单击直接发布。

步骤七：创建流程表单并配置表单的展示信息

1. 前往钉钉企业管理后台，进入OA审批。

2. 在创建审批表单对话框中，选择流程表单。

   

3. 采用多行输入框配置表单的展示信息。

   • Dataphin内存在多个审批场景，需要根据不同的场景创建不同的审批表单。

   • Dataphin内的元数据信息是根据表单中字段名称进行精确匹配的，所以需要确保表单中的名称和Dataphin元数据中提供的名称保持一致，不同场景的审批表单配置如下。

     Dataphin内审批模板	钉钉配置表单	审批示例
     物理表权限申请 逻辑表权限申请 元表、镜像表权限申请
     函数权限申请	参考右图字段
     数据源权限申请	参考右图字段
     标准审核	参考右图字段
     数据服务应用权限申请	参考右图字段
     发布审批	参考右图字段
     数据服务服务单元	参考右图字段
     代码审核	参考右图字段
     一键转交	参考右图字段
     发布目录专题申请	参考右图字段
     数据服务API权限申请	参考右图字段

步骤八：在Dataphin中修改业务租户的审批模板

前往Dataphin对应业务租户 > 管理中心 > 系统设置 > 审批管理 > 审批模板中，将相应审批模板改为钉钉OA中所创建的用于表权限申请的表单。