传递数据
在当前步骤中使用上一步骤的数据
数据流
任何 Activepieces 工作流都是一个垂直图表,以一个触发器步骤开始,后跟任意数量的动作步骤。
步骤之间垂直连接。数据从父步骤流向子步骤。子步骤可以访问父步骤的输出数据。
示例步骤
该工作流有 3 个步骤,它们的数据访问方式如下:
-
步骤 1 是主要数据生产者,供后续步骤使用。步骤 1 产生的数据将在步骤 2 和 3 中可用。不过有些触发器(如定时触发器)不产生数据。
-
步骤 2 可以访问步骤 1 产生的数据。执行完成后,该步骤也会产生数据供后续步骤使用。
-
步骤 3 可以访问步骤 1 和 2 产生的数据,因为它们是该步骤的父步骤。该步骤可以产生数据,但因为是工作流的最后一个步骤,其数据无法被其他步骤使用。
数据插入面板
要在当前步骤中使用上一步骤的数据,请将光标放在任意输入框中,数据插入面板将会弹出。
该面板显示了可访问的步骤及其数据。您可以展开数据项查看其内容,也可以点击数据项将其插入到当前设置输入框中。
如果面板中的某个数据项右侧有插入符(⌄),说明您可以点击该数据项以展开其子属性。您可以根据需要选择父项或其属性。
从该面板插入数据时,数据会插入到输入框中光标所在的位置。这意味着您可以在任意字段中混合使用静态文本和动态数据。
我们通常建议您在插入数据项之前先将其展开,以便了解它们包含的数据类型,以及是否适合您正在填写的输入框。
测试步骤以生成数据
我们要求您在访问步骤数据之前先进行测试。这种方法可以保护您不会选错数据,从而避免在发布后破坏工作流。
如果某个步骤尚未测试,而您尝试访问其数据,将会看到以下消息:
要解决此问题,请进入该步骤并使用”生成样本数据”面板进行测试。不同步骤使用不同的测试方法。以下是常见的测试方式:
- 加载数据: 某些触发器允许您从已连接的账户加载数据,而无需在该账户中执行任何操作。
- 测试触发器: 某些触发器要求您前往已连接的账户并触发该触发器,以生成样本数据。
- 发送数据: Webhook 需要您向 Webhook URL 发送一个样本请求以生成样本数据。
- 测试动作: 动作步骤允许您运行该动作以生成样本数据。
请按照”生成样本数据”面板中的说明了解如何测试您的步骤。某些触发器还允许您使用模拟数据,这将从 Piece 组件生成静态样本数据。我们建议您实际测试步骤,而不是使用模拟数据。
以下是使用加载数据按钮为触发器生成样本数据的示例:
高级技巧
切换到动态值
下拉框和其他一些输入类型不允许您选择上一步骤的数据。如果您想绕过此限制并使用上一步骤的数据,可以使用此按钮将输入切换为动态输入:
通过路径访问数据
如果您在数据插入面板中找不到所需的数据,但仍想使用它,可以编写 JSON 路径来代替。
使用以下语法编写 JSON 路径:
{{step_slug.path.to.property}}
将鼠标悬停在任意工作流步骤上即可找到其 step_slug,它会显示在步骤的右侧。