field — 字段管理

field get — 获取字段详情

Usage:
  dws aitable field get [flags]
Example:
  dws aitable field get --base-id <BASE_ID> --table-id <TABLE_ID>
  dws aitable field get --base-id <BASE_ID> --table-id <TABLE_ID> --field-ids fld1,fld2
Flags:
      --base-id string     Base ID (必填)
      --field-ids string   字段 ID 列表，逗号分隔，单次最多 10 个
      --table-id string    Table ID (必填)

返回字段的完整配置（含 options 等）。不要假设未指定 --table-ids 的 table get 枚举结果含字段；字段目录和配置以 field get 返回为准。

field create — 创建字段

Usage:
  dws aitable field create [flags]
Example:
  dws aitable field create --base-id <BASE_ID> --table-id <TABLE_ID> \
    --name "状态" --type "singleSelect" --config '{"options":[{"name":"待办"},{"name":"进行中"},{"name":"已完成"}]}'

  # 或者使用批量创建模式:
  dws aitable field create --base-id <BASE_ID> --table-id <TABLE_ID> \
    --fields '[{"fieldName":"状态","type":"singleSelect","config":{"options":[{"name":"待办"}]}}]'
Flags:
      --base-id string    Base ID (必填)
      --name string       要创建的单字段名称（与 --type 配合使用，替代 --fields）
      --type string       要创建的单字段类型（需要配合 --name，参考 table create 的内置类型）
      --config string     单字段配置 JSON（需要配合 --name/--type，结构参考 table create）
      --ai-config string  单字段 AI 配置 JSON（需要配合 --name/--type）
      --fields string     批量新增字段 JSON 数组，单次最多 15 个；每个字段的配置写在其 config/aiConfig 内
      --table-id string   Table ID (必填)

field create 有且只有两种输入模式：

单字段模式：必须同时传 --name 和 --type；--config、--ai-config 只作为该字段的附加配置。
批量模式：只传 --fields；字段配置写在数组内各对象的 config / aiConfig 中。

两种模式严格互斥。--fields 不能与 --name、--type、--config 或 --ai-config 混用；单独传 --config 也会报错，不会被静默忽略。

例如创建单选字段时，单字段模式的 --config 是一个配置对象；批量模式则把同一对象放入对应字段元素的 config：

# 单字段模式
dws aitable field create --base-id <BASE_ID> --table-id <TABLE_ID> \
  --name "部门" --type singleSelect \
  --config '{"options":[{"name":"技术部"},{"name":"产品部"}]}'

# 批量模式
dws aitable field create --base-id <BASE_ID> --table-id <TABLE_ID> \
  --fields '[{"fieldName":"部门","type":"singleSelect","config":{"options":[{"name":"技术部"},{"name":"产品部"}]}}]'

允许部分成功，返回结果逐项标明成功/失败状态。

AI 字段创建示例

dws aitable field create --base-id <BASE_ID> --table-id <TABLE_ID> \
  --name "AI摘要" --type text \
  --ai-config '{
    "outputType":"text",
    "prompt":[
      {"type":"text","value":"请将下面内容总结成不超过80字的中文摘要："},
      {"type":"fieldRef","fieldId":"fld_content"}
    ],
    "autoRecompute":true,
    "enableWebSearch":false,
    "enableThinking":true
  }' --format json

说明：

outputType 与字段类型需一致（如 outputType=text 配 --type text）
prompt 里通过 fieldRef 引用已有字段
autoRecompute=true 表示引用字段变化后自动重算
AI 字段的 prompt 必须至少包含一个 fieldRef 引用，纯文本 prompt 会被后端拒绝

关联字段与跨表引用字段

创建 lookup（关联引用）和 filterUp（查找引用）字段时，config 格式有严格要求：

bidirectionalLink / unidirectionalLink（关联字段）

dws aitable field create --base-id <BASE_ID> --table-id <TABLE_ID> \
  --name "关联客户" --type bidirectionalLink \
  --config '{"linkedTableId":"<目标表tableId>","multiple":true}' --format json

lookup（关联引用，通过已有关联字段取值）

前置条件：本表必须已有一个 bidirectionalLink 或 unidirectionalLink 类型的关联字段。

dws aitable field create --base-id <BASE_ID> --table-id <TABLE_ID> \
  --name "客户城市" --type lookup \
  --config '{"associateField":"<本表关联字段的fieldId>","valuesField":"<关联目标表中要取值的字段fieldId>","aggregator":"CONCATENATE"}' --format json

config 必填字段：

associateField：本表中已有的关联字段（bidirectionalLink/unidirectionalLink）的 fieldId
valuesField：关联目标表中要取值的字段 fieldId
aggregator：聚合方式，可选 SUM|AVERAGE|COUNT|MAX|MIN|CONCATENATE

常见错误：associateField 不是目标表的 tableId，也不是目标表的字段 ID，而是本表中关联字段自身的 fieldId。

filterUp（查找引用，无需关联字段，直接跨表取值）

# 基本用法：字段对常量匹配
dws aitable field create --base-id <BASE_ID> --table-id <TABLE_ID> \
  --name "客户总金额" --type filterUp \
  --config '{"targetSheet":"<目标表tableId>","filters":[{"fieldId":"<目标表字段Id>","operator":"equal","value":"匹配值","link":"AND"}],"valuesField":"<目标表中要取值的字段Id>","aggregator":"SUM"}' --format json

# 进阶用法：字段对字段动态匹配（currentSheetFieldId）
dws aitable field create --base-id <BASE_ID> --table-id <TABLE_ID> \
  --name "本城市订单金额" --type filterUp \
  --config '{"targetSheet":"<目标表tableId>","filters":[{"fieldId":"<目标表字段Id>","operator":"equal","currentSheetFieldId":"<本表字段Id>","link":"AND"}],"valuesField":"<目标表中要取值的字段Id>","aggregator":"SUM"}' --format json

config 必填字段：

targetSheet：目标表的 tableId
filters：至少一条筛选规则
- fieldId：目标表中用于匹配的字段 fieldId
- operator：仅支持 equal、contain（不支持 not_equal/not_contain）
- value：常量匹配值（与 currentSheetFieldId 二选一）
- currentSheetFieldId：本表中用于动态匹配的字段 fieldId（与 value 二选一，实现每行按本表字段值去目标表筛选）
- link：多条件时的逻辑关系，AND 或 OR（单条件时可省略，多条件时建议显式指定；所有 filter 的 link 必须统一）
valuesField：目标表中要取值的字段 fieldId
aggregator：聚合方式，可选 SUM|AVERAGE|COUNT|MAX|MIN|CONCATENATE

field update — 更新字段

Usage:
  dws aitable field update [flags]
Example:
  dws aitable field update --base-id <BASE_ID> --table-id <TABLE_ID> --field-id <FIELD_ID> --name "新字段名"
  dws aitable field update --base-id <BASE_ID> --table-id <TABLE_ID> --field-id <FIELD_ID> --config '{"options":[{"name":"A"},{"name":"B"}]}'
Flags:
      --base-id string    Base ID (必填)
      --config string     字段配置 JSON (不修改时省略)
      --ai-config string  AI 配置 JSON (不修改时省略)
      --field-id string   Field ID (必填)
      --name string       新字段名称 (不修改时省略)
      --table-id string   Table ID (必填)

不可变更字段类型
更新 singleSelect/multipleSelect 的 options 时需传入完整列表，已有选项应回传原 id
--name / --config / --ai-config 至少传一个

field delete — 删除字段

Usage:
  dws aitable field delete [flags]
Example:
  dws aitable field delete --base-id <BASE_ID> --table-id <TABLE_ID> --field-id <FIELD_ID> --yes
Flags:
      --base-id string    Base ID (必填)
      --field-id string   待删除字段 ID (必填)
      --table-id string   Table ID (必填)

不可逆。禁止删除主字段和最后一个字段。

7.7 KiB Raw Blame History Unescape Escape