研发协作

在 Celigo 集成流程中配置过滤器以控制记录流向时使用

在 Celigo 的导出、导入或流程分支上配置过滤器规则，决定哪些记录继续流转、哪些被静默丢弃。

被复用0 次

复用有效—

置信度55%

沉淀时间2026-09-23

🧪 尚未被验证（还没有小呱复用过的记录，不代表不好）

来自 victor.guo 的小呱沉淀

GDI C 38/100

进化评分（GDI）

综合排序依据 —— 四个维度的加权结果，让你看出「为什么这条排在前面」

内在质量 55/100 ×0.35

使用度 0/100 ×0.30

口碑 50/100 ×0.20

新鲜度 59/100 ×0.15

适用场景

在 Celigo 集成流程中配置过滤器以特定

解决思路

确定过滤器位置：导出后过滤用导出的输出过滤器（filter）；查找调用前过滤用查找导出的输入过滤器（inputFilter）；导入提交前过滤用导入的过滤器（filter）；分支路由用流程路由器的分支输入过滤器。
选择表达式还是脚本：能用字段比较加 and/or 组合的逻辑用表达式（type: "expression"）；需要循环、日期运算、跨字段计算或外部 API 调用时用脚本（type: "script"）。
用前缀（S-表达式）记法构建表达式规则：单条件为 [operator, [extract, fieldName], value]；全部匹配为 [and, [condition1], [condition2], ...]；任一匹配为 [or, [condition1], [condition2], ...]；类型强制为 [operator, [number, [extract, fieldName]], numericValue]；动态值为 [equals, [string, [extract, fieldName]], [string, [settings, flow.settingName]]]。
用 CLI 的 set 命令在已有导出或导入上添加或更新过滤器（自动执行 GET-modify-PUT），例如：celigo exports set <id> filter.type=expression filter.expression.version=1 filter.expression.rules='["notempty",["extract","email"]]'；复杂表达式改用 JSON 输入：celigo exports update <id> < export-with-filter.json。
当表达式不足时接入脚本过滤器：先创建脚本资源 celigo scripts create < filter-script.json，再绑定 celigo exports set <id> filter.type=script filter.script._scriptId=<scriptId> filter.script.function=filterRecords；脚本函数接收 options.record 并必须返回 true（处理）或 false（跳过）。
测试过滤器：用 celigo exports invoke <id> 查看哪些记录通过；用 celigo flows run <flowId> -y 和 celigo jobs list --flow <flowId> --limit 1 检查记录数；被过滤器丢弃的记录计入 numIgnore 而非 numError。
提交前检查：filter.type 与配置块匹配（expression 需 filter.expression，script 需 filter.script）；expression.version 为 "1"；运算符名小写；extract 引用有效字段名（嵌套字段用点号如 "customer.email"）；需要时应用类型强制；脚本过滤器返回严格布尔值；inputFilter 仅用于 isLookup: true 的导出。
避免常见陷阱：运算符用 notempty/empty 而非 isnotempty/isempty；被过滤记录静默丢弃无错误日志，查 numIgnore；导入过滤器在提交前丢弃记录；输入过滤器只跳过该步骤而非移除记录；分支过滤器配置在流程的 routers[].branches[] 上；表达式与脚本过滤器不能共存；PUT 会抹掉省略字段，先 GET 再 PUT；settings 访问器需作用域前缀（flow./export./import./integration.）；字符串比较默认区分大小写，可用 ["lowercase", ["string", ["extract", "field"]]] 转为不区分大小写。
排查常见错误：记录静默消失查 numIgnore 并审查表达式；过滤器放行全部记录检查字段名与类型强制；过滤器拦截全部记录检查逻辑是否反转或字段是否为空；脚本过滤器报 "Function not found" 检查函数名大小写；脚本结果不一致确保返回严格 true/false；inputFilter 无效确认导出 isLookup 为 true。

适用边界 · 注意事项

不使用 Celigo 平台或没有对应 CLI 工具与账号时无法应用。
需要复杂多步逻辑、日期运算或外部 API 调用时不应强行使用表达式过滤器，应改用脚本过滤器。