一、指令概述
用于向指定多维表格中新增一条记录，并返回新增记录的唯一 ID，适用于数据录入、业务流程数据同步等场景，可替代手动逐条录入的操作。
二、调用参数配置
| 参数名称 | 配置说明 | 约束规则 |
|---|---|---|
| 表格对象 | 目标多维表格的对象（用于定位要新增记录的表格）可通过指令《通过授权码获取授权对象》获取 | 必填； |
| 要添加的数据 | 包含字段名与对应值的字典（单条记录），如{"订单ID": "001", "金额": 100} | 必填；键需与表格字段名完全匹配，值需符合字段数据类型要求 |
| 生成的变量 | 存储新增记录 ID 的变量名称 | 必填；用于承接输出结果，供下游指令调用（如后续修改、查询操作） |
三、输出说明
- 输出类型定义：输出为字符串（单条记录）或字符串列表（多条记录）；
- 输出核心内容：返回新增记录的唯一 ID
四、典型操作示例
示例：批量新增订单记录
- 配置 “表格对象”：选择目标订单多维表格；
- 配置 “要添加的数据”：输入字典：
- 配置 “生成的变量”：命名为
new_order_ids； - 执行指令后，
new_order_ids变量存储新增订单的 ID 列表，可直接用于后续订单状态更新。
五、注意事项
- 字段匹配：“要添加的数据” 中的键必须与表格字段名完全一致（区分大小写），否则对应字段不会被写入；
- 数据类型：新值需符合字段数据类型要求（如数字字段不能填字符串），否则会触发类型校验错误；
- ID 复用：返回的记录 ID 为唯一标识，可用于后续修改、查询等操作，不可重复使用。