Dingtalk NodeInstall

Summary

Updates a field in a DingTalk AI table.

Inputs

• overrideOperator — 不使用凭证中的操作人，手动设置操作人unionId. 默认 false; 为 true 时必须填写 operatorId
• operatorId (required) — 操作人的unionId. 当 overrideOperator 为 true 时必填; 否则从 dingtalkApi 凭据的 userUnionId 读取. 可通过 [用户管理 查询用户详情] 获取
• baseId (required) — AI表格标识. 支持两种模式: By ID (直接填 baseId) 或 From URL (输入 alidocs.dingtalk.com/.+ 链接，节点会自动解析 baseId)
• sheetIdOrName (required) — 数据表. 支持三种模式: From List (搜索列表), By ID (填 sheetId), From URL (同 baseId 的 URL 解析). 依赖 baseId 生效
• fieldIdOrName (required) — 字段ID或字段名称, 用于定位要更新的字段
• body (required) — 请求体 JSON. 官方文档: https://open.dingtalk.com/document/orgapp/api-noatable-updatefield. 示例默认: { name: '字段名', property: { choices: [{name: '选项一'}, {name: '选项二'}] } }

Output shape

API response JSON (field update result). 由 request 模块通过 PUT /notable/bases/{baseId}/sheets/{sheet}/fields/{field} 返回

返回值为钉钉 API 返回的完整 JSON 对象，具体取决于字段类型和配置

Examples

Example 1: 在已知 baseId、sheetIdOrName、fieldIdOrName 的情况下，使用凭据内置操作人更新字段配置

overrideOperator: false; operatorId 留空; body 为目标字段的新配置 JSON

Example 2: 手动指定操作人 unionId 更新字段

overrideOperator: true; operatorId: 'ou_123456...'; body 为目标字段的新配置 JSON