> ## Documentation Index
> Fetch the complete documentation index at: https://help.teable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 记录更新时

> 当已有记录被修改时触发工作流

<Tip>请注意：所有触发器设置都可以在 AI 对话中完成。告诉 AI 你希望工作流做什么，剩下的交给 AI。</Tip>

记录被修改时触发，新建时不会触发。

## 用 AI 创建

打开表格右侧边栏的 AI 对话，描述你的需求。

AI 会为你处理一切：选择合适的触发器，映射相关字段，自动设置所有操作。

只需描述一次目标，工作流即刻就绪，无需手动配置。

**示例：** *"状态字段变更时给负责人发邮件"*

## 配置

| 设置 | 必填 | 说明 |
| - | - | - |
| 表格 | 是 | 要监控的表格 |
| 监听字段 | 是 | 选择一个或多个特定字段，或选择"全部字段" |
| 筛选条件 | 否 | 仅在更新后的记录满足这些条件时触发 |

## 如何设置

1. 新建工作流，选择**记录更新时**作为触发器。
2. 选择要监控的表格。
3. 配置监听字段——建议选择你真正关心的字段，而非"全部字段"。
   4.（可选）添加筛选条件来进一步限定触发范围。
4. 添加后续操作步骤。
5. 点击**测试**验证触发器配置。
6. 开启工作流。

## 监听字段详解

监听字段决定了哪些字段的变化会触发工作流：

* **选择特定字段**：只有当你选定的字段发生变化时才触发。例如只监听"状态"字段，那么修改"备注"字段不会触发工作流。
* **全部字段**：任何字段的变化都会触发，包括自动计算字段、关联字段等。

<Tip>强烈建议选择特定的监听字段。选择"全部字段"容易导致工作流在不相关的编辑中被频繁触发，浪费运行次数，也可能导致意外行为。</Tip>

### 计算字段

[公式](/zh/basic/field/formula)、[查找](/zh/basic/field/lookup)、[汇总](/zh/basic/field/rollup)、[条件查找](/zh/basic/field/conditional-lookup)、[条件汇总](/zh/basic/field/conditional-rollup)的值由 Teable 算出，不用手填。这些值重新计算时，只有把该字段列入 **监听字段** 才会触发本触发器，五种字段的行为一致。

这样你可以直接响应最终结果，不用盯着背后的每个输入项。监听"总金额"公式字段，不管是哪个基础字段变了，只要总额真的变化工作流就会运行；监听关联任务的汇总字段，汇总值变化时同样会运行，包括变化来自关联表格里的编辑。

## 筛选条件说明

筛选条件在记录更新后被评估。只有当更新后的记录满足筛选条件时，后续步骤才会执行。常见用法：

* 只在状态变为"已完成"时触发后续操作
* 只处理特定部门或分类下的记录变更

## 触发后可用的数据

触发后，后续步骤可以访问该记录的所有字段数据（更新后的最新值），包括记录 ID。你可以在后续步骤中通过点击 **+** 按钮来引用这些数据。

## 适用场景

* **价格同步**：当产品表中的价格字段被修改时，自动通过 HTTP 请求将新价格同步到外部电商平台或 ERP 系统，确保各渠道价格一致。
* **任务状态通知**：监听任务表的"状态"字段，当任务状态变为"已完成"时，自动发送邮件通知项目负责人，同时在日志表中记录完成时间。
* **变更审计日志**：监听关键数据表的重要字段，每次变更时自动在审计表中创建一条记录，写入变更时间和变更人信息，方便后续追溯。

## 常见问题

### 如何避免更新循环？

<Warning>如果工作流中包含"更新记录"操作，且更新的是同一个表的同一条记录的被监听字段，会导致工作流再次触发，形成无限循环。</Warning>

避免方法：

* 在"更新记录"操作中，只更新不在监听范围内的字段
* 使用筛选条件限制触发范围，例如"状态不等于已处理"
* 将需要被自动化修改的字段（如时间戳）排除在监听字段之外

### 批量更新会怎样？

通过 API 或批量操作修改多条记录时，每条记录的更新都会单独触发工作流。

### 与"记录满足条件时"有什么区别？

"记录更新时"在每次监听字段变化时都会触发；"记录满足条件时"只在状态从"不满足"变为"满足"时触发一次。如果你只需要在首次达到某个条件时执行操作，建议使用[记录满足条件时](/zh/basic/automation/trigger/records/record-matches-conditions)。

## 相关文档

* [记录创建时](/zh/basic/automation/trigger/records/record-created)
* [记录满足条件时](/zh/basic/automation/trigger/records/record-matches-conditions)
* [更新记录（操作）](/zh/basic/automation/actions/records/update-record)
* [防止意外触发](/zh/basic/automation/examples/prevent-unwanted-triggers)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.