自动化规则

自动化规则用于根据用户操作（例如，将字段设置为特定值时应用修改）、电子邮件事件、时间条件（例如，在最后一次更新后 7 天存档记录）或外部事件触发自动更改。

使用 Studio 创建自动化规则的步骤如下：

  1. 开启 Studio 并点击 自动化，然后点击 新建。

  2. 选择 触发器 并根据所选触发器填写屏幕上出现的字段。

  3. 点击 添加操作，然后选择 操作 的 类型，并根据所选操作，填写屏幕上出现的字段。

  4. 点击 保存并关闭 或 保存并新建。

Example

订阅模型中的自动操作示例

小技巧

  • 要修改自动化规则的 模型，请在 Studio 中点击 自动化 之前切换模型，或 激活开发者模式，创建或编辑自动化规则，并在 自动化规则 表单中选择 模型 。

  • 您也可以从任何看板阶段创建自动化规则，方法是点击看板阶段名称旁边的齿轮图标（⚙），然后选择 自动化。在这种情况下，触发器 默认设置为 阶段设置为，但您可以根据需要进行更改。

    从看板阶段创建自动化

触发器

触发器 用于定义何时应用自动化规则。可用的触发器取决于 模型。共有五个触发器类别：

小技巧

您还可以定义 域名更新前 来指定在触发自动化规则*之前*必须满足的条件。相反，使用 额外条件 和 应用于 筛选器定义的条件会在执行自动化规则*时*进行检查。

要定义 域名更新前，激活开发模式，创建或编辑自动化规则，点击 编辑域名，然后点击 新规则。

例如，如果要在之前没有地址的联系人设置电子邮件地址时执行自动操作（而不是修改其现有地址），请将 域名更新前 定义为 未设置电子邮件，将 应用于 域名定义为 电子邮件已设置。

Example of a trigger with a Before Update Domain

值更新

该类别中可用的触发器取决于模型，并基于常见的字段更改，例如添加特定标记（如添加到任务）或设置 用户 字段。选择触发器，然后根据需要选择值。

值更新触发器示例

电子邮件活动

接收或发送电子邮件时触发自动操作。

时间条件

根据日期字段触发自动操作。可使用以下触发器：

  • 基于日期字段：选择要用于 延迟 字段旁边的字段。

  • 创建后： 创建并保存记录时触发该操作。

  • 上次更新后：该操作在编辑并保存现有记录时触发。

然后，您可以定义：

  • 延迟：指定分钟、小时、天或月的数量。要在触发日期前触发操作，请指定负数。如果选择了 基于日期字段 触发器，还必须选择用于确定延迟的日期字段。

  • 附加条件： 点击 添加条件，然后指定触发自动化规则所需的条件。点击 新规则 添加其他条件。

当达到延迟时间并满足条件时，就会触发操作。

Example

如果要在日历事件开始前 30 分钟发送提醒电子邮件，请选择 触发日期`下的 :guilabel:`开始（日历事件），并将 延迟`设置为 **-30** :guilabel:`分钟。

基于日期字段触发器示例

注解

默认情况下，系统的调度程序会每隔 4 小时运行一次，以检查并执行由时间触发的自动化规则。这意味着，对于那些需要高精度时间的自动化任务，系统可能无法保证在预设的精确时间点执行。

自定义

触发自动操作：

  • 保存时：保存记录时；

  • 删除时：删除记录时；

  • 当 UI 变更时：当一个字段的值在 表单视图 上被更改时（甚至在保存记录之前）触发。

对于 :guilabel:`保存时`和 :guilabel:`当 UI 变更时`这两种触发器，您**必须**在 :guilabel:`更新时`字段中选择一个或多个用于触发此自动化规则的字段。

警告

如果在 :guilabel:`更新时`字段中没有选择任何字段，该自动化操作可能会对同一条记录执行多次。

（可选）您还可以在 :guilabel:`应用于`字段中定义额外的触发条件。

注解

当 UI 变更时`触发器只能与 :ref:`studio/automated-actions/action/python-code 操作一起使用，并且只在手动进行修改时生效。如果该字段的值是由另一个自动化规则更改的，则此操作不会被执行。

外部

基于 Webhook 触发自动化动作。Webhook 是一种跨系统通信机制，当源系统发生特定事件时，会向目标系统发送 HTTP(S) 请求，该请求通常携带事件相关数据载荷。

要配置 网络钩子 触发器，请将 Odoo 生成的 URL 复制到目标系统（即接收请求的系统）。然后，在 目标记录 字段中输入要运行的代码，以定义使用自动化规则更新的记录。

警告

URL 必须属于**机密**；在网络公开或随意分享可能导致系统遭受恶意攻击。如有必要，请点击 重置密钥 按钮更改 URL 加密凭证。

注解

  • 在 目标记录 字段中默认定义的代码，适用于来自其他 Odoo 数据库的网络钩子。它用于根据载荷中的信息，确定需要更新的记录。

  • 如果您希望将网络钩子的内容用于查找记录以外的目的（例如*创建*记录），您唯一的选择是使用 执行代码 操作。在这种情况下，:guilabel:`目标记录`字段必须包含任何有效代码，但其结果不会对自动操作本身产生任何影响。

  • 网络钩子的内容可在服务器操作上下文中作为 payload 变量（即包含传入请求的 GET 参数或 POST JSON 主体的字典）使用。

您还可以选择 记录调用 来记录接收到的数据负载，例如，确保源系统发送的数据符合预期格式和内容。这也有助于识别和诊断可能出现的任何问题。要访问日志，请点击 自动化规则 表单顶部的 日志 智能按钮。

参见

Web挂钩

操作

定义自动化规则的 触发器 后，点击 添加操作 以定义要执行的操作。

小技巧

您可以为同一触发器/自动化规则定义多个操作。操作将按照定义的顺序执行。例如，如果您定义了 更新记录 操作，然后又定义了 发送电子邮件 操作，则电子邮件将使用更新后的值。但是，如果在 更新记录 操作之前定义了 发送电子邮件 操作，则电子邮件将使用更新操作运行**之前**设置的值。

更新记录

此操作允许更新记录的一个（相关）字段。点击 更新 字段，在打开的列表中选择或搜索要更新的字段；必要时点击字段名旁的向右箭头，访问相关字段列表。

如果您选择了 many2many 字段，请选择是否必须通过 添加、删除、设置为`选定值或 :guilabel: 清除`来更新该字段。

Example

如果您希望自动操作从客户记录中删除标签，请将 更新 字段设置为 客户 > 标签，选择 通过删除，然后选择标签。

更新记录操作示例

小技巧

另外，您也可以使用 Python 代码来动态地设置记录的字段。要执行此操作，请选择 计算 `而不是 :guilabel:`更新，然后输入用于计算该字段值的代码。例如，如果您希望在某个任务的优先级被设为`高`（通过加星标的方式）时，让自动化规则为一个自定义的 日期时间字段 计算其值，那么您可以将触发器定义为 优先级`设为 `高，并将 :guilabel:`更新记录`操作按如下方式定义：

使用 Python 表达式计算自定义日期时间字段

创建活动

此操作用于安排与记录关联的新活动。选择 活动类型，输入 标题 和描述，然后在 到期日在 字段中指定要安排活动的时间，并选择 用户类型：

  • 要始终将活动分配给同一用户，请选择 特定用户，并在 负责人 字段中添加用户；

  • 要针对动态链接到记录的用户，请选择 动态用户（基于记录），并根据需要更改 用户字段。

Example

将潜在客户转化为商机后，您希望自动操作为负责该潜在客户的用户发起呼叫。要执行此操作，请将 活动类型 设为 呼叫，并将 用户类型 设为 动态用户（基于记录）。

创建活动操作示例

发送电子邮件和发送短信

这些操作用于向链接到特定记录的联系人发送电子邮件或短信。为此，请选择或创建 电子邮件模板 或 短信模板，然后在 发送电子邮件为 或 发送短信为 字段中选择发送电子邮件或短信的方式：

  • 电子邮件：将信息作为电子邮件发送给 电子邮件模板 的收件人。

  • 消息：在记录上发布消息，并通知记录的关注者。

  • 备注：将消息作为内部备注发送，内部用户可在沟通栏中看到。

  • 短信（无备注）：将信息作为文本信息发送给 :guilabel:`短信模板`的收件人。

  • 短信（带备注）：将短信作为文本消息发送给 短信模板 的收件人，并作为内部备注发布在沟通栏中。

  • 仅限备注：只将消息作为内部备注发布在沟通栏中。

发送 WhatsApp

重要

要自动发送 WhatsApp 消息，必须创建一个或多个 WhatsApp 模板。

此操作用于向链接到特定记录的联系人发送 WhatsApp 消息。为此，请从下拉菜单中选择相应的 WhatsApp 模板。

添加关注者和删除关注者

可使用这些操作来为现有联系人（取消）订阅该记录。

创建记录

此操作用于在任何模型上创建新记录。

在 记录创建 字段中选择所需的模型；默认情况下它包含当前模型。为记录指定 名称，然后，如果要在其他模型上创建记录，请在 链接字段 字段中选择一个字段，以链接触发创建新记录的记录。

注解

与 链接字段 字段相关的下拉列表只包含当前模型上存在的 one2many 字段 字段，这些字段与目标模型上的 many2one 字段 字段链接。

小技巧

您可以使用 更新记录 操作创建另一个自动化规则，以便在必要时更新新记录的字段。例如，您可以使用 创建记录 操作创建新项目任务，然后使用 更新记录 操作将其分配给特定用户。

执行代码

此操作用于执行 Python 代码。您可以使用以下变量将代码写入 代码 选项卡：

  • env：触发操作的环境

  • 模型：触发操作的记录的模型；是一个无效记录集

  • 记录：触发操作的记录；可能无效

  • 记录：在多模式下触发操作的所有记录的记录集；可留空

  • time、datetime、dateutil、timezone：实用的Python时间处理库

  • float_compare: utility function to compare floats based on specific precision

  • log(message, level='info'): logging function to record debug information in ir.logging table

  • _logger.info(message): logger to emit messages in server logs

  • UserError: exception class for raising user-facing warning messages

  • Command: x2many commands namespace

  • action = {...}: to return an action

小技巧

The available variables are described both in the Code and Help tabs.

发送 Webhook 通知

This action allows to send a POST request with the values of the Fields to the URL specified in the URL field.

The Sample Payload provides a preview of the data included in the request using a random record’s data or dummy data if no record is available.

执行现有行动

The action is used to trigger multiple actions (linked to the current model) at the same time. To do so, click on Add a line, then, in the Add: Child Actions pop-up, select an existing action or click New to create a new one.