学AI代码笔记【020】号【WPS嘉年华】
AI知识库:WPS知识库 加入知识库
学习笔记整理：AI学WPS代码笔记【整理】
学习笔记查看：AI学WPS代码笔记【查看】
案例库：多维表代码使用案例库
发帖：WPS多维表格 | WPS Office官方社区
WPS开放平台：API简介 | WPS开放平台
20.2025年09月01日 星期一学AI代码笔记【020】号
主要内容
| 🔔 | 设置查询条件 QueryView.QueryFields 说明 可读写 查询视图的查询条件配置数组，可以将数组设置到QueryFields属性，查询条件的数据结构如下 { conditionCanBlank: false, // 是否必填 customPrompt: "", // 自定义提示语 enableScanCodeToInput: false, // 是否允许扫码输入 fieldId: "s", // 字段ID needSecondCheck: false, // 电话字段时是否校验号码 op: "Equals" // 匹配方式，参看下面说明 } 根据字段类型支持不同的匹配方式 文本/邮箱/URL/地址/级联：Intersected，Contains，Equals 日期： Intersected，GreaterEquAndLessEqu，Equals 时间： Equals 数字/货币/百分比/最后修改时间/等级/进度/创建时间： GreaterEquAndLessEqu， Equals 身份证/电话/自动编号：Intersected，Equals 复选框/单选项/多选项/联系人/创建人/最后修改人/双向关联/单向关联/父记录：Intersected 返回值 Array 官方的执行效果  其他没搞清楚，应该要怎么设置，问了ai的用途 设置查询条件在 WPS 表格中具有多种用途，能够显著提升数据处理和分析的效率。以下是一些常见的应用场景： 1. 数据筛选与过滤 通过设置查询条件，可以快速筛选出符合特定条件的数据行。例如，您可以根据日期、文本内容或数值范围来过滤数据，从而聚焦于需要分析的核心数据集。 2. 动态视图配置 查询条件可以用于动态调整表格视图的显示内容。例如，在一个包含大量记录的工作表中，不同的用户可能关注不同的数据子集。通过修改 QueryFields 属性，可以为每个用户定制个性化的视图，而无需创建多个独立的工作表。 3. 数据验证与校验 在某些场景下，查询条件可以用于数据验证。例如，您可以设置必填字段（conditionCanBlank: false）或电话号码校验（needSecondCheck: true），确保输入数据的完整性和准确性。 4. 提高查询效率 对于大型数据集，直接操作整个数据表可能会导致性能问题。通过设置查询条件，可以减少需要处理的数据量，从而提高脚本运行效率和响应速度。 5. 集成外部系统 在与其他系统集成时，查询条件可以作为接口的一部分，用于从 WPS 表格中提取特定数据。例如，通过 API 调用，外部系统可以根据预定义的查询条件获取所需的数据，而无需传输整个表格。 6. 支持复杂查询逻辑 查询条件支持多种匹配方式，例如等于（Equals）、包含（Contains）、区间匹配（GreaterEquAndLessEqu）等。这些功能使得用户能够实现更复杂的查询逻辑，满足多样化的业务需求。 用了一个包含写代码 查询条件，用包含，文本字段    可以运行，不过没搞懂  |
关键代码
官方
function main() {
const view = Application.Sheets(1).Views(1);
console.log(view.QueryFields);
}
main();优化
function main() {
const view = Application.Sheets(1).Views(1); // 获取第一个工作表的第一个视图
const queryFields = view.QueryFields; // 获取当前查询字段配置
// 添加新的查询条件
queryFields.push({
conditionCanBlank: false,
customPrompt: "",
enableScanCodeToInput: false,
fieldId: "字段 ID", // 替换为目标字段的实际 ID
needSecondCheck: false,
op: "Contains", // 使用“包含”匹配方式
value: ["目标文本"] // 替换为要匹配的目标文本
});
view.QueryFields = queryFields; // 更新查询字段
console.log(view.QueryFields); // 打印更新后的查询字段配置
}
main();