企业微信(WeCom)-办公 icon

企业微信(WeCom)-办公

企业微信办公功能 - 文档、微盘、邮件、日程、会议、直播、打卡、审批、汇报、人事、会议室、紧急通知、公费电话

Actions259

文档 → [获取智能表格数据] 查询记录

AI-generated

Summary

查询企业微信智能表格子表中的记录,可按记录 ID、筛选条件或排序规则缩小结果,并选择返回字段和分页范围。

Inputs

  • 文档ID(docid) (required) — 智能表格的文档 ID。
  • 子表ID(sheet_id) (required) — 要查询的子表 ID。
  • 视图ID(view_id) — 指定查询视图;留空时使用默认视图。
  • 返回Key类型(key_type) — 返回记录字段值时,以字段标题(默认)或字段 ID 作为键。
  • 指定记录ID(record_ids) — 以逗号分隔的记录 ID 列表;留空时不按记录 ID 限定查询。
  • 筛选条件(filterConditions) — 可添加一个或多个条件,指定字段 ID、字段类型、操作符及相应值;日期字段可选日期范围或提供毫秒时间戳,复选框可选勾选状态。多个条件通过 AND(默认)或 OR 组合。
  • 排序规则(sort) — 可按字段标题添加排序规则,并选择升序(默认)或降序。界面声明筛选条件与排序规则不能同时使用。
  • 分页设置(pagination) — 设置每页记录数(默认 50,界面范围 0–1000)和偏移量(默认 0)。
  • 返回字段(returnFields) — 按逗号分隔的字段 ID 或字段标题指定要返回的字段;留空时返回所有字段。使用字段标题作为返回键时,可按标题指定字段。

Output shape

记录查询结果,按 n8n 项目输出。

可按分页设置限制和偏移结果。属性说明筛选条件与排序规则不能同时使用;具体返回结构未明确显示。

Examples

Example 1: Retrieve all records from a specific view, using field titles as keys.

Provide the document ID and sheet ID, then set the view ID and pagination limit if needed.

Example 2: Find records where a field matches one of several values.

Add a filter condition with the field ID, field type, operator, and comma-separated values; select AND or OR to combine multiple conditions.

Example 3: Retrieve selected columns from a sorted page.

Provide field IDs or titles under Return Fields, add sort rules by field title, and configure the page limit and offset.

Links

Discussion