N8N中文教程
使用 n8n/Getting_started/Text_courses/Level_one

构建一个小型工作流#

在本课中,你将构建一个小型的 工作流(workflow),用于从 Hacker News 获取 10 篇关于自动化的文章。该过程包含五个步骤:

  1. 添加手动触发节点(Manual Trigger node)
  2. 添加 Hacker News 节点
  3. 配置 Hacker News 节点
  4. 执行节点
  5. 保存工作流

最终的工作流将如下所示: 查看工作流文件

1. 添加手动触发节点(Manual Trigger node)#

打开节点面板(提示:你可以通过点击画布右上角的 + 图标,或按下键盘上的 Tab 键来打开)。 然后执行以下操作:

  1. 搜索 Manual Trigger 节点。
  2. 在搜索结果中选择该节点。

这会将 Manual Trigger 节点添加到你的画布(canvas)中,使你能够随时点击 Execute workflow 按钮运行工作流。

手动触发说明 为了加快工作流创建速度,未来你可以跳过此步骤。如果在没有触发器的情况下添加其他节点,n8n 会自动为你添加 Manual Trigger 节点。 在实际场景中,你可能更希望设置一个定时任务或其他类型的 触发器(trigger) 来自动运行工作流。

2. 添加 Hacker News 节点#

点击 Manual Trigger 节点右侧的 + 图标以打开节点面板。 然后执行以下操作:

  1. 搜索 Hacker News 节点。
  2. 在搜索结果中选择该节点。
  3. Actions 区域,选择 Get many items

n8n 会将该节点添加到你的画布中,并自动打开节点窗口以显示其配置详情。

3. 配置 Hacker News 节点#

当你向编辑器界面(Editor UI)中添加新节点时,该节点会自动激活,并在其窗口中显示多个配置选项:

  • Parameters(参数):调整参数以细化和控制节点的功能。
  • Settings(设置):调整设置以控制节点的外观和执行行为。
  • Docs(文档):在新窗口中打开该节点的 n8n 官方文档。

参数 vs. 设置

  • 参数(Parameters) 因节点功能不同而各异。
  • 设置(Settings) 对所有节点都相同。

参数#

我们需要为 Hacker News 节点配置几个参数,使其正常工作:

  • Resource(资源) : All(全部) 该资源选项会选择所有数据记录(文章)。
  • Operation(操作) : Get Many(获取多个) 此操作用于获取所选的所有文章。
  • Limit(限制) : 10 此参数用于限制“获取多个”操作返回的结果数量。
  • Additional Fields(附加字段) > Add Field(添加字段) > Keyword(关键词) : automation(自动化) 附加字段 是你可以添加到某些节点的可选配置项,用于使请求更具体或对结果进行过滤。在此示例中,我们只想获取包含关键词 "automation" 的文章。

Hacker News 节点的参数配置现在应如下所示: Hacker News 节点参数Hacker News 节点参数

设置#

设置(Settings) 部分包含多个与节点外观和执行相关的选项。在本例中,我们将仅配置最后两个设置项,它们用于控制节点在编辑器 UI 画布中的显示方式。 在 Hacker News 节点的设置中,请修改以下内容:

  • Notes(备注) : 获取最新的 10 篇文章。 节点备注 通常建议在节点中添加简短描述,说明其用途。这对于复杂或共享的工作流尤其有帮助!
  • Display note in flow?(在流程中显示备注?) : 切换为 true 启用此选项后,备注将显示在画布中节点的下方。

Hacker News 节点的设置配置现在应如下所示: Hacker News 节点设置Hacker News 节点设置

重命名节点 你可以将节点重命名为更符合你使用场景的名称。有三种方法可以实现:

  • 选中要重命名的节点,同时按下键盘上的 F2 键。
  • 双击节点以打开节点窗口。点击窗口左上角的节点名称,输入新名称,然后点击 Rename(重命名) 保存更改。
  • 右键点击节点,选择 Rename(重命名) 选项。

重命名节点通过键盘重命名节点 要查看原始节点名称(即节点类型),请打开节点窗口并选择 Settings(设置)。页面底部会显示节点的类型和版本。

4. 执行节点#

在节点详情窗口中选择 Execute step(执行步骤)按钮。你应该能在输出的 Table(表格)视图中看到 10 条结果。

Hacker News 节点在表格视图中的结果Hacker News 节点在表格视图中的结果

节点执行#

节点执行(Node execution) 节点执行表示该节点运行一次,用于获取或处理指定的数据。

如果节点成功执行,在画布上的节点顶部会出现一个绿色的小对勾。

成功执行的工作流成功执行的工作流

如果参数没有问题且一切正常,请求到的数据将在节点窗口中以 Table(表格)、JSONSchema(模式)三种格式显示。你可以通过节点窗口顶部的 Table | JSON | Schema 按钮切换这些视图。

表格视图 vs JSON 视图 Table(表格)视图是默认视图。它将请求的数据以表格形式展示,其中每一行代表一条记录,每一列代表该记录的一个可用属性。

以下是 Hacker News 节点在 JSON 视图下的输出:

Hacker News 节点在 JSON 视图中的结果Hacker News 节点在 JSON 视图中的结果

节点窗口还会显示更多关于本次节点执行的信息:

  • Output(输出)标题旁边,你会看到一个小图标(若执行成功则为绿色对勾)。其右侧还有一个信息图标(i)。将鼠标悬停在此图标上时,会显示另外两个有助于了解工作流中每个节点性能的信息:
    • Start Time(开始时间):节点执行启动的时间。
    • Execution Time(执行时间):从节点开始执行到返回结果所花费的时间。
  • Output 标题下方,还有一项信息:10 items(10 条项目)。该字段显示了节点请求返回的项目(记录)数量。本例中预期为 10 条,因为我们已在第二步中设置了此限制。但如果你未设置限制,这个数值可以帮助你了解实际返回了多少条记录。

节点中的错误 节点上出现红色警告图标表示该节点存在错误。这可能是由于节点的凭据缺失或不正确,或者节点参数未正确配置所致。 节点中的错误节点中的错误

5. 保存工作流#

完成节点编辑后,选择 Back to canvas(返回画布) 以回到主画布界面。 默认情况下,你的工作流会自动保存为“My workflow”(我的工作流)。 在本课程中,请将工作流重命名为“Hacker News workflow”(Hacker News 工作流)。

提示 你可以通过点击编辑器 UI 顶部的工作流名称来重命名工作流。 重命名工作流后,请务必保存更改。

有两种方式可以保存工作流:

  • 在编辑器 UI 的画布界面中,按下键盘上的 Ctrl + SCmd + S
  • 点击编辑器 UI 右上角的 Save(保存) 按钮。你可能需要先点击对话框外部,退出节点编辑器。

如果你看到灰色的 Saved(已保存) 文字而非 Save(保存) 按钮,则说明你的工作流已被自动保存。

总结#

恭喜!你刚刚创建了你的第一个工作流!在本课中,你学习了如何在应用节点中使用操作(actions)、配置其参数和设置,以及如何保存和执行你的工作流。

在下一课中,你将认识你的新客户 Nathan,他需要自动化他的销售报告工作。你将为他构建一个更复杂的工作流,帮助他在工作中提升效率。