SuperAPI AI 工具集

b24jssdk-filtering

编程与开发

查看项目

更新于 10-15 20:06

技能介绍

用途:帮助通过 b24jssdk 的 actions.v2.* / actions.v3.* 调用 Bitrix24 REST 方法时,正确构建 filter、order 与 select 参数。Bitrix24 有两套互不兼容的过滤方言,需按所用 action 版本选择。

v2 方言(前缀键对象):用于 $b24.actions.v2.{call,callList,fetchList}.make 的 params.filter。运算符作为字段名前缀:无前缀为精确匹配;>=、>、<=、< 比较;! 或 != 为不等于;% 为 LIKE(子串、不区分大小写);=% 为带显式模式的 LIKE;!% 为 NOT LIKE。多键以 AND 组合,同一字段两个运算符需写成两个键。数组值表示 IN,!字段 加数组表示 NOT IN。

v3 方言(三元组数组):用于 actions.v3.*。filter 为 JSON 数组,每个元素是一个条件,如 ['stageId','=','NEW']。仅支持 8 个运算符:= != > >= < <= in between;无子串运算符。in 值必须为数组,between 值必须为 [min,max] 二元数组。两参数形式是简写。复杂嵌套可用 FilterV3 构建器 F.build/F.eq/F.ne/F.gt/F.ge/F.lt/F.le/F.in/F.between/F.and/F.or/F.not,客户端校验运算符形状。

order:callList/fetchList 会忽略并丢弃用户传入的 order,强制按游标键 ASC;需要自定义排序应改用 call.make 手动分页。call.make 的 v3 order 仅接受对象形式,数组会抛异常,且字段须带服务端可排序属性。

select:建议始终传入以限制响应大小;v3 支持点语法展开关系字段,自定义字段需显式列出。

关键限制:v2 内字段命名随方法而异(UPPER_SNAKE 与 camelCase 两套,filter/select/order 必须一致,否则分页静默出错);布尔条件仅在 JSON 请求体下有效;日期用 Text.toB24Format 生成时区格式;多漏斗阶段 ID 带前缀,勿用裸 NEW 跨漏斗匹配;两套方言混用会返回错误或错误结果。

文档未提供的其他事实暂未提供。