模块概述
Adobe Workfront Fusion 区分以下五种模块类型:
- 操作模块
- 搜索模块
- 触发器模块
- 聚合器
- 迭代器
聚合器和迭代器模块适用于高级场景。
操作模块
操作模块是最常见的模块类型。典型的操作模块会执行某项操作并返回一个单一捆绑包,随后交由下一个模块继续处理。
与触发器模块不同,操作模块可放置在场景的开头、中间或结尾。
场景中可包含无限数量的操作模块,但若模块数量过多(150+),可能会影响性能。
示例:
- Workfront > 上传文件会将文件上传至 Workfront,并返回其标识符。
- 图像 > 调整大小接收一张图像,将其调整为指定尺寸,并将调整后的图像传递给下一个操作。
“操作”类型有四个子类型:
- 创建
- 读取
- 更新
- 删除
“更新”子类型包含以下三种操作:
-
擦除字段内容。当字段内容解析为
erase关键词时(不要与empty混淆),将执行此操作。
-
保持字段内容不变。 当字段留空,或字段内容解析为空(在 JSON 中表示为 null)时,将执行此操作。
-
替换字段内容。除上述两种情况外,所有其他情况均会执行此操作。
-
如果在映射面板中未看到
erase关键词,则说明该模块不是更新模块,或尚未更新至该应用的最新规范。 -
Empty不会更改字段内容。如果需要清除字段内容,可以使用以下公式:
-
目前不支持在字段内容解析为空时保持字段内容不变。
搜索模块
搜索模块会返回零个、一个或多个捆绑包,并将这些捆绑包传递给下一个模块继续处理。
搜索模块可放置在场景的开头、中间或结尾。
场景中可包含无限数量的搜索模块,但若模块数量过多(150+),可能会影响性能。
示例:
Workfront > 读取相关记录会读取在特定父对象中与指定的搜索查询匹配的记录。
触发器模块
触发器模块会在某个服务发生变更(例如创建或更新记录)时生成捆绑包。
触发器模块会返回零个、一个或多个捆绑包,并将这些捆绑包传递给下一个模块继续处理。
由于触发器模块会启动场景执行,因此它们只能放置在场景的开头。
每个场景只能包含一个触发器模块。
Workfront Fusion 提供两种触发器模块:轮询触发器和即时触发器。
轮询触发器
轮询触发器会定期轮询指定服务,即使自上次场景运行后没有任何变更。我们建议为包含轮询触发器的场景设置定期运行计划。如果存在与触发器配置匹配的变更,触发器将返回包含该变更信息的捆绑包。如果没有与该配置相匹配的变更,则该触发器不会输出任何捆绑包。
有关如何计划场景运行的说明,请参阅计划场景。
轮询触发器会在您保存触发器或更改触发器设置后自动显示一个面板,您可以在其中选择要首先输出的条目。此选择仅影响模块的首次执行。模块首次运行后,后续执行只会监测最近一次执行之后发生的更改。
如需了解更多信息,请参阅选择触发器模块的起始位置。
示例:
-
Workfront > 监控记录会返回自上次运行该场景后新增的记录。
-
Google Sheets> 监控行会返回自上次运行该场景后新增的行。
即时触发器
即时触发器可在服务发生更改后立即通知 Workfront Fusion。我们建议将包含即时触发器的场景设置为立即运行。
有关操作步骤,请参阅计划场景。
关于即时触发器如何处理传入数据的详细信息,请参阅即时触发器 (Webhook)。
示例:
- Workfront > 监控事件会在 Workfront 中发生特定事件(例如创建任务)时返回相关信息。
- Google Sheets> 监控更改会在单元格更新时返回相关信息。
聚合器
聚合器模块会将多个捆绑包汇总为单个捆绑包。
聚合器仅返回一个捆绑包,该捆绑包随后会传递给下一个模块继续处理。
聚合器只能放置在场景的中间位置。
场景中可包含无限数量的聚合器,但若模块数量过多(150+),可能会影响性能。
示例:
- 存档 > 创建存档会将多个文件压缩成 zip 存档。
- CSV > 聚合到 CSV 会将 CSV 文件中的多个字符串合并为一行。
- 工具 > 文本聚合器会将多个字符串合并为一个字符串。
如需了解更多信息,请参阅聚合器模块。
迭代器
迭代器是一种将数组拆分为多个独立捆绑包的模块。
迭代器会返回一个或多个捆绑包,然后传递给下一个模块进行处理。
迭代器只能放置在场景的中间位置。
场景中可包含无限数量的迭代器,但若模块数量过多(150+),可能会影响性能。
示例:
电子邮件 > 检索附件会将附件数组拆分为多个独立捆绑包。