轻易云
注册体验

采购订单审核流钉钉通知:MySQL 聚合待审批到钉钉 Markdown 消息的实战配置

· 高金凤· 集成方案库· 12 次浏览· 约 5 分钟读完

这个策略解决什么问题(场景与价值)

某制造企业的外协采购流程,审批环节分散在多位负责人手里,过去靠人盯流程、邮件抄送,经常出现单据积压。一次实际项目中,我们把"采购订单待审批汇总 → 钉钉提醒"做成定时任务,每两小时由 MySQL 拉一次待审批数量,按审批人聚合后,通过企业自建钉钉机器人推一条 Markdown 消息,带数量、带时间、带"查看详情"链接。审批人不用登录业务系统,就能知道手里压了多少单。核心价值是把"被动发现积压"变成"主动送达提醒"。

集成方案列表 - 多策略状态巡检 + crontab 视图

数据流向与字段映射

整体链路只有一层,没有明细行嵌套:MySQL (源端聚合查询) → 轻易云中间层 (字段映射 + Markdown 拼接) → 钉钉机器人 batchSend (单条消息体)。

源端是扁平结果集,每行 = 一位审批人 + 其待审批采购订单数量;目标端是一段 JSON 消息体。关键字段对照如下:

源字段 (MySQL)目标字段 (钉钉)映射类型转换规则业务说明
—robotCodeCONSTANT固定编码钉钉自建机器人编码,用于发送采购审核提醒
useriduserIdsDIRECT{{userid}}钉钉接收人 ID,JSON 数组字符串
—msgKeyCONSTANT固定值 sampleMarkdown消息模板类型为 Markdown
多字段组合msgParamTRANSFORM_function CONCAT(...)拼接标题、待审批数量、当前时间、详情链接
user_countmsgParam.textDIRECT{{user_count}}该审批人待审批的采购订单数量
idmsgParam.textDIRECT{{id}}源端 now() 生成的当前时间戳

源端 SQL 里有几处值得留意:pur_status IN ('1','11') 圈定待审批状态、pur_type='2' 限定外协采购、is_del='1' 过滤有效单据、company_code 限定公司范围。审批人列表来自 act_to_form_process.audit_user(逗号分隔),通过数字序列拆分成单用户后再聚合,这是这种"审批流提醒"类策略里典型的做法。

消息通知推送 (集成→OA) 流程

在轻易云上如何配置

在轻易云数据集成平台里,这个策略被拆成两个集成方案:源端 MySQL 的 select 方案 + 目标端钉钉的 batchSend 方案,再用策略把它们串起来。

源端要点:API 类型选 select(WebAPI,POST 方式把 SQL 当作入参提交),把主 SQL 整段贴到 main_sql,用 :limit / :offset 做分页;请求体里加 main_params 绑定占位符,分页大小由调度传参注入。响应字段 user_id、user_count、job_number、userid、real_name、id 都按字符串声明。

目标端要点:API 选 /v1.0/robot/oToMessages/batchSend,四个请求字段 robotCode / userIds / msgKey / msgParam 全部配置好。其中 msgParam 用 _function CONCAT 把 Markdown 三段(标题、计数+时间、详情链接)拼成合法 JSON 字符串,这是轻易云里"表头表体一次拼完"的典型写法——既然消息没有明细行,就不必拆多阶段。

实施步骤

  1. 数据源连通:先在轻易云里把 MySQL 数据源配上,跑一次 select 拿到响应样本,确认 userid、user_count 能取到。这一步是排查权限、SQL 语法、字段命名最快的方式。
  2. 目标端连通:用钉钉开放平台的 robotCode 自建机器人,先用 Postman 直接调一次 batchSend,确认 Markdown 渲染没问题,再搬到轻易云里。
  3. 策略编排:新建策略,源端方案选 MySQL select,目标端方案选钉钉 batchSend,行级映射——源端每行触发一次目标端调用。
  4. 调度配置:crontab 写 1 8,10,12,14,16,18,20,22 * * *(源端比目标端早 1 分钟,避免消息先于查询到达)。分页 limit 起步给 50,确认无遗漏后再考虑加大。
  5. 灰度验证:先盯一个审批人,观察 8 点那一次他是否收到 Markdown、计数是否对、链接是否能点开。
  6. 全量上线:灰度 1-2 天没问题,再放开所有公司代码和审批人。

踩坑复盘

  • userid 抄送分支不能硬编码在目标端。本次特定用户需要追加两位抄送人,我们没把它写成映射规则里的 if-else,而是直接在源端 SQL 用 CASE WHEN 生成 JSON 数组。这样编码映射逻辑集中在 SQL 一处,后续要改抄送名单,改 SQL 就好,不必动轻易云的策略。编码映射集中管理是轻易云客户常见的应对模式。
  • JSON 数组里 userid 一定要带双引号。我们最早写成 CONCAT('[',userid,']'),钉钉接口直接 400——它要的是 JSON 字符串数组,不是 Python list。稳妥写法是 CONCAT('["',userid,'"]'),多用户用 \","\" 拼。
  • crontab 一定要源端比目标端早 1 分钟。源 1 分、目标 2 分,如果反过来,8 点那一刻目标端先于源端跑了一次,审批人收到一条"您有 0 张"的空提醒。
  • now() 放源端,不放轻易云。消息里的时间戳必须和查询时刻一致,如果用轻易云内置时间变量,在批量写入时会出现"同一批次多条消息共用一个时间"的奇怪现象。增量与全量双轨在这种"轻提醒"场景里很关键——平时增量按时间窗跑,出问题全量补跑一次性把积压清空。
  • 详情链接要可点击。Markdown 模板里 [<查看详情>](http://...:9000/examine/outsourcAudit) 这种尖括号包文字的形式钉钉能渲染成蓝色超链接;只用纯文本 URL 在钉钉 PC 端是纯文本,点不动。

适用场景与不适用场景

适用:待审批/待处理提醒类轻推送(采购、销售、合同、报销)、按接收人聚合的非结构化消息、对实时性要求在小时级别的业务通知。不适用:需要明细行展示的场景(比如把 5 张订单号列在一条消息里)——这时应该走 OA 待办或业务系统的待办中心,而不是钉钉群机器人;也不适用实时性要求分钟级的提醒,那种建议直接对接钉钉工作通知接口做单播。

本文为原创内容,转载请注明出处:https://www.qeasy.cloud/insights/solutions/strat-mysql-dingtalk-4900-sz-sc-6b462b75

评论