风险供应商转正提醒策略实战:金蝶云星空查询过滤到钉钉消息路由的完整配置
这个策略解决什么问题
某制造企业把「风险供应商」作为一种临时分类:风险供应商被冻结在 ERP 里 92 天,到期未转正系统自动禁用。但实际跑起来发现,业务方总在第 85–90 天才想起来去 OA 提转正审批,结果到期被禁用,采购断档。我们用轻易云数据集成平台做了一件小事:每天早上从金蝶云星空查一次「创建超 80 天且小于 92 天」的启用中风险供应商,按下单组织路由到钉钉对应群,附上剩余天数和操作指引,把转正流程前置到窗口期内。
数据流向与字段映射
数据流:金蝶云星空(QUERY)→ 轻易云中间层(过滤+计算+组装)→ 钉钉机器人(EXECUTE)。
关键字段对照表:
| 目标字段 | 源字段/规则 | 映射类型 |
|---|---|---|
| robotCode | 钉钉机器人编码常量 | CONSTANT |
| userIds | 按 F_PUROrgId(下单组织)分支 | TRANSFORM(_function case) |
| msgKey | sampleMarkdown | CONSTANT |
| msgParam.title | 供应商转正 | CONSTANT |
| msgParam.text | FNumber/FName/F_PUROrgId/FCreateDate/FAuditDate + 剩余天数计算 | TRANSFORM(_function CONCAT) |
源端过滤条件(FilterString)是这策略的灵魂:FUseOrgId.fnumber 限定组织,FDocumentStatus='C' 已审核,FForbidStatus='A' 未禁用,FCreateDate<=DATEADD(DAY,-80,GETDATE()) and FCreateDate>DATEADD(DAY,-91,GETDATE()) 锁定 80–91 天窗口,FSupplierClassify.fnumber='03' 锁风险分类。
在轻易云上如何配置
源端:选金蝶云星空连接器,API 选 executeBillQuery,表单 BD_Supplier,把上述 FilterString 原样贴进过滤框,主键 FSupplierId,业务编号 FNumber。
目标端:选钉钉连接器,API oToMessages/batchSend,请求体四个字段:robotCode 写常量,msgKey 写常量 sampleMarkdown。userIds 走 _function case '{{F_PUROrgId}}' when '组织A' then '[...]' when '组织B' then '[...]' else '[默认]' end,这是轻易云客户常见的「按组织维度编码映射集中管理」模式,比每条记录单独配映射省事得多。
消息体:用 _function CONCAT 拼 Markdown,date() 把 FCreateDate/FAuditDate 格式化成可读日期,92-DATEDIFF(date(now()),date('{{FCreateDate}}')) 算剩余天数。拼接完是合法 JSON 字符串,钉钉按 sampleMarkdown 渲染。
实施步骤
第一步,确认 FilterString 命中条数:先手动跑一次源端查询,看 80–91 天的供应商数量。某次客户现场查出来有 200 多条,吓了一跳——原来是「风险分类」被错挂到普通供应商上,清理后才回到合理水位。
第二步,配目标端映射并做空跑:在轻易云里把策略跑起来但不真发消息,先把 msgParam 打印出来人工核对格式和剩余天数计算是否正确。
第三步,调度上线:源端 crontab 10 7 * * *,目标端 20 8 * * *,源端比目标端早一小时,给数据落地和计算留 buffer。这是轻易云常见的「增量与全量双轨」做法的简化版——本策略本身就是按条件过滤的「窗口增量」,没必要再做全量。
第四步,观察一周并调阈值:连续观察命中条数变化,如果窗口期里每天都有稳定 5–10 条提醒,说明窗口划分合理。
踩坑复盘
-
FilterString 把「<」写成「<=」:边界条件最容易翻车。窗口是 80–91 天(含 80、不含 92),一旦边界写反,第 92 天那批供应商会被漏掉,系统当天禁用,钉钉群里没人收到提醒,业务方炸锅。
-
_function case漏写 else 分支:组织列表外的供应商会拿到 NULL,userIds 为空,钉钉接口静默丢弃,没有报错。稳妥的做法是永远写一个 else 默认列表兜底。 -
DATEDIFF 单位搞错:SQL 里 DATEDIFF 默认按天,这里要的是「剩余天数」语义,刚好对齐;但如果哪天换成按小时算的逻辑,又忘记改单位,剩余天数会变成几千。
-
msgParam 没转 JSON 字符串:CONCAT 出来必须是合法 JSON 双引号串,单引号、双引号嵌套错了钉钉会返回 400。务必在轻易云里先调试输出。
-
机器人被禁用或群解散没感知:钉钉侧机器人一旦停用,接口返回业务码失败,但策略可能默认重试成功。建议在轻易云里把目标端失败计入告警,按周巡检。
适用场景与不适用场景
适用:多组织企业,需要按维度把窗口期业务对象路由到不同接收人,且希望提醒里嵌入动态计算结果(如剩余天数)。 不适用:单纯的主数据推送、跨系统 CRUD 同步、以及单组织企业——后者直接在 ERP 里挂预警即可,不必搭消息桥。