Dingtalk NodeInstall

Summary

在数据表中创建一个字段

Inputs

• overrideOperator — 不使用凭证中的操作人，手动设置操作人unionId。默认 false 时将使用凭据中的 userUnionId。
• operatorId (required) — 操作人的unionId。当 overrideOperator 为 true 时必填，否则从凭据自动读取。可通过 [用户管理 查询用户详情] 获取。
• baseId (required) — AI表格的 baseId 或 URL。支持 By ID 或 From URL 两种模式，URL 需符合 https://alidocs.dingtalk.com/i/nodes/{baseId} 格式。
• sheetIdOrName (required) — 要操作的数据表 ID 或名称。支持 From List（需先加载）、By ID 或 From URL 三种模式。
• body (required) — 请求体 JSON，用于定义新字段的名称、属性和类型。官方文档: https://open.dingtalk.com/document/orgapp/api-noatable-createfield。默认内容为 { name: '状态', property: { choices: [ { name: '完成' }, { name: '失败' } ] }, type: 'singleSelect' }。

Output shape

{ json: <API响应对象>, pairedItem: { item: number } }

返回 AI 表格创建字段接口的原始 JSON 响应。pairedItem 为 n8n 内部项索引，供后续节点使用。

Examples

Example 1: 使用凭据默认操作人创建名为‘进度’的单选字段

保留 overrideOperator 为 false（默认），填入 baseId 和 sheetIdOrName，body 保留默认或自定义 name/property/type 后执行。

Example 2: 手动指定操作人 unionId 创建字段

将 overrideOperator 设为 true，在 operatorId 中填入获取的 unionId，其余参数同常规模式。