开始使用 BPM

在画布上点击 StartEvent 元素。属性面板则会展示其属性。

Form（表单） 部分填写的内容是会在用户启动流程之后展示给用户的。我们指定 Input dialog（输入对话框） 作为流程启动的表单。

然后我们需要指定在输入对话框内给用户展示的参数。

点击 + 按钮，然后在 Input dialog parameter edit（输入对话框参数编辑器） 窗口中创建一个 requestNumber 参数，有下列属性：

再创建三个输入对话框参数：

之后，再创建一个输入对话框参数 manager，类型为 Entity，可编辑且必需。选择 User 实体名称。指定 UI 组件为 ComboBox，方便用户选择。我们将 JPQL 查询字段留空，这样会使用默认的 select e from smpl_User e 查询语句。

在输入对话框参数列表的下方 Business key（业务键值） 字段，选中 requestNumber。业务键值是一个流程实例的特定领域标识符。

添加完所有参数之后，Form 部分将展示如下：

流程启动之后，输入对话框参数会保存在对应的流程变量中。

我们开始创建 Approval（审批） 用户任务。在画布中选中开始事件节点，展示弹出菜单。点击 Append task 按钮。

然后点击 Change type，扳手图标按钮，并选择 User Task。

在属性面板中，指定任务名 Approval 以及任务 id approval。

我们用 Process variable（流程变量） 作为执行人来源。下拉列表展示这些字段和 Entity 类型的流程变量，实体类型需要实现 UserDetails 接口。从列表中选择 manager 流程变量。

对于 Approval 任务，我们还需要指定一个流程表单。这也是一个输入对话框。这个对话框将展示开始表单中的流程变量，但需要新增一个参数。

创建一个新的输入对话框参数，并在 Process variable 下拉列表中选择 requestNumber 变量。将这个字段设置为不可编辑，即，取消勾选 Editable 复选框。

用同样的方式创建输入对话框参数 expenseAmount、expenseDate 和 document 变量。这些参数都是不可编辑的。

新增一个对话框参数，流程变量名为 comment，类型为 Multiline string。字段是可编辑，非必需。这个字段是给经理用的，当批准或驳回报销申请时，可以用来写一些说明。

在 Approval 这一步，经理有两个选择：批准或驳回请求。做到这点有个简单的办法 - 使用输出。对于每个输出，表单上都会显示一个按钮，结果会存在一个特殊的流程变量中。

首先创建 Approval 用户任务的第一个输出，点击属性面板中 Outcomes（输出） 部分的相应按钮。在输出编辑器界面，指定输出 id approve，名称为 Approve 并在图标列表选择一个图标 CHECK。

然后创建第二个输出：id 是 reject，名称是 Reject，图标是 BAN。

Approval 任务完成之后，流程需要根据输出选择相应的路径。我们创建一个互斥网关（exclusive gateway）。

选中 Approval 任务元素，在菜单中点击 Append Gateway 操作。

点击这个网关，使用菜单中的相应按钮创建 EndEvent 和 User task。一个顺序流从互斥网关流向 EndEvent 元素，另一个顺序流流向用户任务。给这两个顺序流分别命名为：approved 和 rejected。

为 approved 流指定条件，点击这个流元素，然后在序列流属性面板的 Condition source（条件来源） 下拉框字段选择 User task outcome。再选中 Approval 用户任务和 approve 输出。

按同样的步骤配置 rejected 序列流，但是在输出值字段需要选择 reject。

第二个用户任务，设置任务名称为 Payment，任务 id 为 payment。

我们实现下列行为：所有的会计都能看到这个任务，他们中的任何一人都能领取这个任务。因此，为了实现这个功能，我们不能指定某个特定的任务执行人，而是需要指定 Candidate groups（候选组） 或 Candidate users（候选用户）。

我们给会计创建一个 Candidate group。打开 BPM → User groups（用户组） 界面，新建一个组，名称为 Accountants，编码为 accountants。修改组类型为 Users 并添加几个用户到组内。

需要给这些用户分配 bpm-process-actor-ui 角色，给予必要的访问 BPM 界面和实体的权限，以便这些用户能开始流程、处理用户任务。可以在 Application → Users 界面分配角色。

返回建模器，选择 Payment 用户任务并点击 Assignee（执行人） 区域 Candidate groups 字段旁边的编辑按钮。

在弹窗中，选择 Groups source（组来源） 字段的值为 User groups 然后添加 Accountants 分组。

为 Payment 任务创建输入对话框表单。添加已有的 requestNumber、expenseAmount、expenseDate、document 和 comment 字段，全部为不可编辑。

在 Payment 用户任务后添加 EndEvent 元素。

我们需要做的最后一件事就是指定谁能发起这个流程。如果这个流程可以由任何用户发起，我们可以创建并使用一个特殊的用户分组。

打开 User groups 界面并创建一个新的组，命名为 All users。设置其 Type 为 All users，这表示这个组会自动包含所有的用户。建模器中，选择 All users 组作为流程发起候选人。

回到建模器，点击画布的空白处，展示流程属性。与 Payment 任务相似，我们将在 Starter candidates（候选发起人） 区域定义 Candidate groups。