用途:为HTI仪表盘和合规报告提供动态筛选、排序与查询优化,通过API层筛选减少返回数据量、提升仪表盘性能。
主要能力:build_filter用于构建Knack兼容筛选对象,支持match为and或or、rules数组(含field、operator、value);apply_sort按sort_field与sort_order(asc或desc)排序;combine_filters用AND/OR合并多组筛选;可配合fetch_all_pages实现筛选加分页。支持文本、数字、日期、布尔运算符:文本有is、is not、contains、starts with、ends with;数字有is、is not、>、<、>=、<=;日期有is、is before、is after、is during及is today/this week/this month/this year;布尔为is。资料还给出HTI专用筛选示例,如本季度获取(is during日期范围)、可捐赠、按县、循环捐赠者、培训场次、待处理设备、高价值捐赠者等。
使用方式:在调用get_records时传入filters(build_filter结果)和sort(apply_sort结果),并建议在API层而非客户端筛选;对大数据集用分页函数配合一致筛选。示例命令或代码保持原样,如const ready = await get_records("object_1", { filters: build_filter({ rules: [{ field: "field_status", operator: "is", value: "Ready" }] }) });
适用场景:HTI仪表盘、拨款报告、合规报告、目标追踪、季度报告同步等需要按状态、日期、县、金额等条件过滤与排序的场景。
限制:资料未提供价格、平台支持范围、具体性能数字、安装方式及依赖版本,这些信息暂未提供;筛选字段名需与实际Knack对象匹配,错误处理中需识别invalid field。集成点包括knack_reader、knack_pagination、knack_dashboard_ai、knack_reporting_sync、knack_goal_tracker。