何时使用运行脚本 vs 内置操作
运行环境
如何设置
- 在工作流中添加运行脚本操作。
- 在代码编辑器中编写 JavaScript 代码。
- 通过
input对象访问前序步骤的数据。 - 通过
output.set()将结果传递给后续步骤。 - (可选)在配置面板中声明 npm 依赖。
- 点击测试运行脚本并查看输出。
input 对象结构
input 对象包含前序所有步骤的输出数据。键为步骤的 Action ID,值为该步骤的输出。
字段通过字段 ID(如
fldXXXXXX)而非字段名称引用。你可以在测试面板中查看实际的数据结构和字段 ID。output.set 详解
使用output.set(key, value) 将数据输出给后续步骤:
内置变量
利用这两个变量,你可以在脚本中直接调用 Teable API:
调用外部 API
npm 依赖
在配置面板的依赖声明区域,以 JSON 格式添加需要的包:require() 引入:
调试技巧
- 使用
console.log():在脚本中添加日志,测试运行后可以在输出面板中查看。 - 先测试数据结构:在编写复杂逻辑前,先用
output.set("debug", input)查看完整的输入数据结构。 - 逐步构建:从简单的代码开始,确认数据获取正确后再添加业务逻辑。
- 检查字段 ID:字段使用 ID(如
fldXXXXXX)引用,在测试面板中确认实际的 ID。
错误处理
使用try/catch 捕获错误,避免脚本崩溃导致工作流中断:
安全说明
- 脚本在安全沙箱中运行,与宿主系统隔离,无法访问文件系统或操作系统资源。
AUTOMATION_TOKEN是自动生成的临时凭证,仅在当前工作流运行期间有效。- 不要在脚本代码中硬编码密码或 API 密钥。建议通过 Webhook 触发器或记录字段传入敏感信息。
- 脚本有 60 秒的执行时间限制,超时会自动终止。
适用场景
- 复杂数据转换:将多个字段的数据重新组织为特定格式,如生成报告摘要、拼接多语言内容。
- 多步 API 编排:先调用 API A 获取 Token,再调用 API B 发送数据,在一个脚本中完成多步操作。
- 条件分支处理:根据记录的不同字段值执行不同的处理逻辑,如根据订单金额选择不同的审批流程。
- 数据校验和清洗:批量检查数据格式、去重、填充缺失值等。

