跳转到内容

事件调度器

为特定工作流设置计划是一种实用的组织工具,因此 PlaidCloud 提供了这项功能。使用事件调度器,可以按月、每月的日期、每周的日期、小时和分钟计划工作流的运行,并可指定按哪个时区解读该计划。

计划事件指定一个项目中的一个工作流,以及它运行所依据的计划。要让多个工作流按相同的节奏运行,请为每个工作流各添加一个事件。

Events Table 列出工作区中的每个事件,包括其运行的项目和工作流、UTC 偏移量、上次运行的状态、开始和结束时间,以及下次到期时间。

查看事件:

  1. 打开 Analyze
  2. 选择“Tools”
  3. 点击“事件调度器”

这将打开 Events Table,其中显示为工作区配置的所有当前事件。

计划按月 · 日 · 小时 · 分钟按所选时区解读触发工作流运行运行运行运行按计划,随时间推移 →
定义何时运行(按月、每月的日期、每周的日期、小时和分钟,并按您选择的时区解读),事件就会在每个计划时间自动触发工作流。

创建事件:

  1. 打开 Analyze
  2. 选择“Tools”
  3. 点击“事件调度器”
  4. 点击“Add Scheduled Event”
  5. 完成下文所述的详细信息、时区和计划字段
  6. 点击“Create”

名称:事件在 Events Table 中的显示方式。必填。

备注:关于事件用途的可选说明。

激活作业并按定义的计划运行:默认勾选。取消勾选可保存事件但不让其运行,请参阅暂停事件。

项目和工作流:此事件运行的工作流。请先选择项目,工作流列表会根据所选项目填充。两者均为必填,并且事件创建后即固定不变,要将事件改到其他工作流,请删除它并添加新事件。

计划按此时区解读,时区以从 UTC -12 到 UTC +14 的偏移量选择。默认为 UTC +0,按伦敦时间解读,包括英国夏令时。

大多数偏移量对应该偏移量所在地的当地时间,并遵循该地的夏令时:设置为 UTC -5 且时间为 09:00 的事件,无论夏季还是冬季,都在纽约时间 09:00 运行,对应夏季的 13:00 UTC 和冬季的 14:00 UTC。下次运行列和即将运行的日历会显示事件实际运行的时间。

偏移量 对应时间 夏令时
UTC -12 UTC -12 否
UTC -11 帕果帕果 否
UTC -10 檀香山 否
UTC -9 安克雷奇 是
UTC -8 洛杉矶 是
UTC -7 丹佛 是
UTC -6 芝加哥 是
UTC -5 纽约 是
UTC -4 波多黎各 否
UTC -3 圣保罗 否
UTC -2 南乔治亚 否
UTC -1 亚速尔群岛 是
UTC +0 伦敦 是
UTC +1 罗马 是
UTC +2 UTC +2 否
UTC +3 利雅得 否
UTC +4 迪拜 否
UTC +5 卡拉奇 否
UTC +6 UTC +6 否
UTC +7 曼谷 否
UTC +8 新加坡 否
UTC +9 东京 否
UTC +10 悉尼 是
UTC +11 瓜达尔卡纳尔岛 否
UTC +12 奥克兰 是
UTC +13 阿皮亚 否
UTC +14 基里蒂马蒂 否

计划由五个字段组成:个月、小时、分钟、每月的日期和每周的日期,每个字段都是一组复选框,顶部有一个全部复选框。只要当前时间同时匹配每个字段中已勾选的值,事件就会运行。

每个字段都必须有内容:勾选全部以匹配所有值,或勾选您想要的各个值。如果某个字段完全留空,事件将无法保存,提示信息会指出该字段名称,便于您找到它。

一些示例:

  • 每天 06:30:在“个月”“每月的日期”和“每周的日期”下勾选全部;在“小时”下勾选 06;在“分钟”下勾选 30。
  • 每月 1 日午夜:在“个月”和“每周的日期”下勾选全部;在“每月的日期”下勾选 01;在“小时”和“分钟”下勾选 00。
  • 每个工作日 18:00:在“个月”和“每月的日期”下勾选全部;在“每周的日期”下勾选星期一到星期五;在“小时”下勾选 18;在“分钟”下勾选 00。
  • 每 15 分钟:在“个月”“每月的日期”“每周的日期”和“小时”下勾选全部;在“分钟”下勾选 00、15、30 和 45。

每个事件都带有自己的 ERP过账模式:实时、模拟或关闭,其启动的每次运行都使用该模式。未设置模式的事件按实时运行,并且项目自身的过账模式上限仍然适用,因此事件的过账自由度绝不会超过其项目所允许的范围。

通过 API 或 AI 助手设置模式:在 PUT /rest/v1/analyze/workflow/scheduled-event 上使用 erp_write_mode 字段(live、simulate 或 off),或在 workflow_schedule MCP 工具的 upsert 上使用。此后事件会一直保留该模式。在事件调度器中编辑事件、暂停或重新启用事件都不会改变该模式,因此设置为模拟的计划每次触发时都会保持模拟,直到您更改模式本身。

编辑事件:

  1. 打开 Analyze
  2. 选择“Tools”
  3. 点击“事件调度器”
  4. 点击编辑图标
  5. 调整所需字段
  6. 点击“更新”

编辑时,项目和工作流以只读方式显示,事件始终附属于创建它时所针对的工作流。

AI 助手可以通过 workflow_schedule MCP 工具编辑事件,只需发送要更改的字段,例如新的名称或计划。它省略的每个字段都保留其当前值。

删除事件:

  1. 打开 Analyze
  2. 选择“Tools”
  3. 点击“事件调度器”
  4. 从事件行菜单(⋯)中,通过右键点击,或从操作菜单中选择删除
  5. 确认删除

暂停一个或多个事件:

  1. 打开 Analyze
  2. 选择“Tools”
  3. 点击“事件调度器”
  4. 选择一个或多个事件
  5. 点击“禁用所选项”

点击启用所选项可使其重新开始运行。暂停的事件会保留其计划和运行历史,只是在重新启用之前不再触发,并且其活动图标会在 Events Table 中清除。

也可以在编辑单个事件时将其暂停:取消勾选激活作业并按定义的计划运行,然后点击更新。

立即运行事件:

  1. 打开 Analyze
  2. 选择“Tools”
  3. 点击“事件调度器”
  4. 选择所需的一个或多个事件
  5. 点击“Run Selected Events”

每个事件都在其自己的 ERP过账模式下运行,因此处于模拟模式的事件会以模拟方式运行。其工作流已在运行的事件会被跳过,运行后的消息只统计已启动的事件。