使用企业微信审批

CloudDM Team 开启企业微信审批步骤如下：

创建并配置企业微信应用。
使用主账号登录 CloudDM Team 产品。
进入页面配置 > 个人偏好 > 通用参数 选项卡。
参考如下表格修改配置项。最后点击右上角保存按钮后确认保存。

(必选) 需要修改的配置
配置项                        │ 修改后     │ 说明
─────────────────────────────┼───────────┼──────────────────────────────────────
wechatEnableApprovalService  │ true      │ 工单流程服务使用企业微信提供服务
wechatApprovalCorpId         │ xxxxx     │ 企业 ID
wechatApprovalAgentId        │ xxxxx     │ 应用 AgentId
wechatApprovalSecret         │ xxxxx     │ 应用 Secret
wechatApprovalToken          │ xxxxx     │ 消息通道 Token（在配置消息通道环节配置）
wechatApprovalEncodingAesKey │ xxxxx     │ 消息通道 EncodingAESKey（在配置消息通道环节配置）

(可选) 高级参数选项说明
配置项                       │ 修改后     │ 说明
────────────────────────────┼───────────┼──────────────────────────────────────
wechatApprovalTemplateLang  │           │ 如果配置了多国语言模版，需要指定使用的默认语言。

企业微信应用参考

info

您可以将 CloudDM Team 中单点登录(SSO) 和工单整合进同一个企业微信应用。CloudDM Team 支持独立或分开配置。

准备工作

登录企业微信后台。
需要准备一个域名并且部署 CloudDM Team Console 的服务器能够通过这个域名被外网访问。

应用基本配置

点击 应用管理 > 应用 > 创建应用。
填写应用的基础信息，涉及图标资源可以在资源下载中获取。应用可用范围选择组织机构的 根部门(包含所有员工)，然后点击 创建应用。
在 应用详情 中可以获取，获取 AgentId 和 Secret。
在 我的企业 页面底部可以获取 企业 ID (CorpId)。
在 应用详情 中找到 企业可信 IP 卡片，点击设置，填写您部署 CloudDM Team 环境中公网出口 IP。

表单配置参考

进入企业微信后台，进入 应用管理 > 审批应用。
首次进入 应用需要设置应用负责人，然后点击 模版管理 > 添加模版，在弹出框中选择 自定义模版。
在 表单设计 的步骤，按照情况添加必要的控件，在添加过程中请不要开启必填选项。表单内容请参考 配置企业微信表单。
在 流程设计 的步骤，设置各节点的审批人及审批方式（需要注意：在设置节点审批人时 CloudDM Team 不支持申请人自选）。
配置完成后，在页面最下方点击保存。

SQL 工单

tip

在配置表单项时需要严格按照下列要求配置，否则会造成数据错乱或者无法递交审批的情况。
- 表单项
- 表单顺序
由于表单大小限制，表单如果内容超长会被截断，完整内容需到 CloudDM Team 控制台。
- 单行输入框：400 长度
- 多行输入框：4000 长度

SQL 工单的表单按照如下内容填写。

标题（文本）
目标数据源（文本）
需求描述（多行文本）
执行 SQL（多行文本）
回滚 SQL（多行文本）
预计受影响行数（文本）

权限工单

权限工单的表单按照如下内容填写。

标题（文本）
需求描述（多行文本）
申请的权限（明细，打印格式请选择：合并成一行打印）
   数据源描述（文本）
   资源路径（文本）
   生效时间（文本）
   权限列表（多行文本）

变更工单

变更工单的表单按照如下内容填写。

标题（文本）
需求描述（多行文本）
目标数据源（文本）
项目（文本）
变更（文本）
分支（文本）
执行 SQL（多行文本）

配置消息通道

启用消息消息通道。
接收消息服务器在配置时，需要
- 先将 Token、EncodingAESKey 更新到 CloudDM Team 系统配置中（请参考文章开头部分）。
- 然后在到企业微信中点击保存。
填写接收消息服务器 URL：（上图 1 部分）
- 格式为：http://your.domain.com/callback/event?puid=\{ownerUid\}&platform=WECHAT&eventType=APPROVAL
- 其中：{ownerUid} 需要 主账号 登录系统后，点击右上角头像中获取 UID。
在审批应用中设置 开启回调通知的模版 和 可调用接口的应用。