Dingtalk Node icon

Dingtalk Node

Interact with the Dingtalk API

Actions56

AI表格 → 列出多行记录

AI-generated

Summary

获取AI表格里指定数据表的多行记录

Inputs

  • overrideOperator — 不使用凭证中的操作人，手动设置操作人unionId
  • operatorId (required) — 操作人的unionId。当overrideOperator为true时必填；否则使用凭据 dingtalkApi 中的 userUnionId
  • baseId (required) — AI表格baseId。支持 By ID 模式（直接输入 baseId）或 From URL 模式（输入 https://alidocs.dingtalk.com/i/nodes/...?，系统会通过 regex /i/nodes/([^/?#]+) 解析出 baseId）
  • sheetIdOrName (required) — 目标数据表。支持 From List 模式（搜索列表）、By ID 模式（直接输入 sheetId）或 From URL 模式（输入 https://alidocs.dingtalk.com/i/nodes/...?，系统会通过 regex iframeQuery=[^#]*?sheetId%3D([A-Za-z0-9_-]+) 解析出 sheetId）
  • sendBody — 如何发送请求体数据。可选：使用下面定义的表单 / 使用JSON
  • jsonBody — JSON格式的请求体数据。当 sendBody 为 json 时生效。官方API文档: https://open.dingtalk.com/document/development/api-notable-listrecords
  • filter — 筛选条件。fixedCollection类型，multipleValues=true。包含 conditions 数组（每条包含 field/operator/value）和 combination 组合方式（and/or）
  • combination — 筛选条件组合方式。默认 and。可选 AND（同时满足所有条件）或 OR（满足任一条件）
  • maxResults — 每页获取的数据量。默认 100，取值范围 1-100
  • nextToken — 上一次查询返回的游标。首次查询时不需要传入

Output shape

API返回的钉钉AI表格记录列表JSON，包含记录数据及分页元数据，具体结构取决于后端响应

操作在执行时会通过 operatorId（凭据 userUnionId 或手动指定）查询记录，返回的每条记录包含字段ID与值

Examples

Example 1: 默认查询（使用凭据操作人），不带筛选

overrideOperator=false（默认），baseId 和 sheetIdOrName 正常填写，sendBody 保持默认 form，不填 jsonBody / filter / maxResults / nextToken

Example 2: 自定义操作人并筛选

overrideOperator=true，operatorId 手动填写 unionId，依据需要添加 filter.conditions（字段/运算符/值）并设置 combination，如需要分页可使用 maxResults 与 nextToken

Discussion