---
title: "工作流快速开始"
description: "工作流快速开始：配置第一个工作流、数据表事件触发器、运算节点、保存与测试，5 分钟上手。"
keywords: "工作流,快速开始,数据表事件,运算节点,触发器配置,NocoBase"
---

# 快速开始

## 配置第一个工作流

从顶部菜单栏的插件配置菜单进入工作流插件的管理页面：

![工作流插件管理入口](https://static-docs.nocobase.com/20251027222721.png)

管理界面中会列出所有已创建的工作流：

![工作流管理](https://static-docs.nocobase.com/20251027222900.png)

点击“新建”按钮，创建一个新的工作流，选择数据表事件：

![创建工作流](https://static-docs.nocobase.com/20251027222951.png)

提交后点击列表中的“配置”链接，进入工作流配置界面：

![一个空的工作流](https://static-docs.nocobase.com/20251027223131.png)

然后点击触发器的卡片，打开触发器配置抽屉，选择一张之前创建的数据表（例如“文章”表），触发时机项选择“新增数据后”触发，点击“保存”按钮，完成触发器的配置：

![配置触发器](https://static-docs.nocobase.com/20251027224735.png)

接下来我们可以点击流程中的加号按钮为流程增加一个节点，例如选择一个运算节点，用于将触发器中的数据的“标题”字段与“ID”字段进行拼接计算：

![新增运算节点](https://static-docs.nocobase.com/20251027224842.png)

点击节点卡片打开节点配置抽屉，使用 Formula.js 提供的运算函数 `CONCATENATE`，拼接“标题”与“ID”字段，两个字段通过变量选择器插入：

![运算节点使用函数及变量](https://static-docs.nocobase.com/20251027224939.png)

之后再创建一个更新数据节点，用于将结果保存到“标题”字段中：

![创建更新数据节点](https://static-docs.nocobase.com/20251027232654.png)

同样地，点击卡片打开更新数据节点的配置抽屉，选择“文章”表，更新的数据 ID 选择触发器中的数据 ID，更新的数据项选择“标题”，更新的数据值选择运算节点的结果：

![配置更新数据节点](https://static-docs.nocobase.com/20251027232802.png)

最后再点击右上角工具栏里的“启用”/“停用”开关，将工作流切换至启用状态，这样工作流就可以被触发执行了。

## 触发工作流

回到系统主界面，通过文章区块创建一篇文章，填入文章标题：

![创建文章数据](https://static-docs.nocobase.com/20251027233004.png)

提交后刷新区块后可以看到文章标题被自动更新为“文章标题 + 文章 ID”的形式：

![被工作流修改的文章标题](https://static-docs.nocobase.com/20251027233043.png)

:::info{title=提示}
由于数据表触发的工作流是异步执行的，所以在提交数据后的界面中无法马上看到数据更新，但片刻之后刷新页面或区块后即可看到更新的内容。
:::

## 查看执行历史

刚才的工作流已经成功触发执行了一次，我们可以回到工作流的管理界面中查看到对应的执行历史：

![查看工作流列表](https://static-docs.nocobase.com/20251027233246.png)

工作流列表中可以看到这个工作流已经产生了一次执行历史，点击次数的链接，可以打开对应工作流的执行历史记录：

![对应工作流的执行历史列表](https://static-docs.nocobase.com/20251027233341.png)

再点击“查看”链接可以进入到当次执行的详情页面，可以看到每个节点的执行状态和结果数据：

![工作流执行历史详情](https://static-docs.nocobase.com/20251027233615.png)

触发器的上下文数据和节点执行的结果数据都可以通过点击对应卡片右上角的状态按钮打开查看，比如我们查看其中运算节点的结果数据：

![运算节点结果](https://static-docs.nocobase.com/20251027233635.png)

可以看到运算节点的结果数据中包含了运算后的标题，这个标题就是后续更新数据节点更新的数据。

## 小结

通过上面的步骤，我们已经完成了一个简单的工作流的配置和触发，也接触了以下几个基础概念：

- **工作流**：用于定义流程的基本信息，包括名称、触发器类型和启用状态等，可在其中配置任意多个节点，是承载流程的实体。
- **触发器**：每个工作流都包含一个触发器，可配置为工作流被触发的特定条件，是流程的入口。
- **节点**：节点是工作流内的执行特定操作的指令单元，工作流中多个节点之间通过上下游关系组成完整的执行流程。
- **执行计划**：执行计划是工作流触发后的具体执行对象，也称为执行记录或执行历史，包含了执行的状态、触发上下文数据等信息。其中针对每个节点也有对应的执行结果，包含了节点执行后的状态和结果数据信息。

更深入的使用可以进一步参考以下内容：

- [触发器](./triggers/index)
- [节点](./nodes/index)
- [使用变量](./advanced/variables)
- [执行计划](./advanced/executions)
- [版本管理](./advanced/revisions)
- [高级配置](./advanced/options)
