# 流程节点
流程节点为工作流提供了最基础的功能,用于执行具体的任务、活动、动作,以实现如数据处理、分支判断、消息通知等能力。
# 基本功能
# 1. 添加节点的方式
鼠标选中连线,将会显示添加图标,悬停图标后显示节点选择器弹窗。 点击任意选项则在选中位置新增一个节点。
# 2. 流程节点操作
- 悬停已添加的流程节点,显示操作选项。
- 复制:在当前位置复制一个完整的流程节点
- 删除:删除流程节点
# 3. 节点基本信息
不同的节点类型将显示固定的节点图标,在节点数量较多时仍可以直观地区分节点类型。
- 节点名称:默认为节点类型,修改节点名称可提高工作流的易读性。
- 节点描述:添加描述后,悬停节点卡片的图标可显示描述信息,可用于编写节点说明。
# 数据处理
数据处理节点提供了对表单数据的新增、更新、查询、删除能力,支持对原有数据进行处理,并根据规则进行简单的数据过滤、清洗。
# 新增数据
根据获取的数据向目标表单新增单条或多条数据。
1. 选择目标表单
从当前应用表单、公共表中选择表单执行新增数据操作。
2. 新增方式
- 新增单条数据:向目标表单中新增一条数据
- 表单赋值时,仅写入一条数据;
- 若赋值变量存在多条数据,则使用第一条数据进行写入。
- 基于数据源新增多条数据:从数据源中获取数据列表,向目标表单添加多条数据
- 需要从输入参数、当前节点之前的任一节点中选择数据源
- 数据源以列表的形式提供多条数据,实现数据的批量写入
- 表单赋值时,需要使用“数据源”计算单元中的变量进行批量写入,否则仅支持写入单条数据
3. 表单赋值
从目标表单中选择字段进行赋值,其中未选择与未赋值的字段将自动置空。
# 更新数据
从目标表单中获取部分数据执行更新操作。
- 选择目标表单
从当前应用表单、公共表中选择表单执行更新数据操作。
- 更新方式
- 常规更新:
- 当筛选条件的引用变量为多条数据时,仅取首条数据进行数据过滤。
- 若表单赋值的变量存在多条数据,则使用第一条数据进行更新。
- 基于数据源更新数据:
- 需要从输入参数、当前节点之前的任一节点中选择数据源
- 当筛选条件引用数据源计算单元中的变量进行赋值时,支持逐条匹配更新
- 表单赋值时,需要使用“数据源”计算单元中的变量进行批量更新,否则仅支持使用单条数据更新目标表。
示例:
当筛选条件设置目标表中的「城市」字段值等于「输入参数.city」变量时。 向目标表的「联系人」字段进行赋值「输入参数.联系人」。
- 获取「输入参数.city」 中所有的数据。
- 与目标表单中的数据进行匹配。
- 根据规则将匹配成功的数据进行更新。
常规更新与数据源更新模式的预期执行结果如下:
- 筛选条件
配置筛选条件,从目标表单中过滤出需要更新的部分数据。
若未配置任何筛选条件,则不会执行更新操作。
- 表单赋值
从目标表单中选择字段进行赋值,其中未选择与未赋值的字段将不执行更新,保留原数据。
# 删除数据
过滤出目标表单中的部分数据进行删除操作。
1. 选择目标表单
从当前应用表单、公共表中选择表单执行删除数据操作。
2. 删除方式
常规删除:
- 当筛选条件的引用变量为多条数据时,仅取首条数据进行数据过滤。
基于数据源删除数据:
- 需要从输入参数、当前节点之前的任一节点中选择数据源
- 当筛选条件引用数据源计算单元中的变量进行赋值时,支持逐条匹配删除
示例:
当筛选条件设置目标表中的「城市」字段值等于「输入参数.city」变量时。
- 获取「输入参数.city」 中所有的数据。
- 与目标表单中的数据进行匹配。
- 根据规则将匹配成功的数据进行删除。
常规删除与数据源删除模式的预期执行结果如下:
3. 筛选条件
配置筛选条件,从目标表单中过滤部分数据,符合过滤条件的数据将被删除。
若未配置任何筛选条件,则不会执行删除操作。
# 查询数据
从目标表单中获取数据,支持对获取的数据进行简易的数据处理,为其他业务节点提供数据源。
1. 选择目标表单
从当前应用表单、公共表中选择表单,进行数据查询。
2. 查询方式
常规查询:
- 当筛选条件的引用变量为多条数据时,仅取首条数据进行数据过滤。
基于数据源查询数据:
- 需要从输入参数、当前节点之前的任一节点中选择数据源
- 当筛选条件引用数据源计算单元中的变量进行赋值时,支持逐条匹配查询
常规查询与数据源查询模式的预期执行结果如下:
3. 筛选条件
根据实际业务场景设置筛选条件,过滤出所需的数据。
未设置筛选条件则获取目标表单的全部数据(上限1000条)
4. 数据排序
获取数据时,支持设置自定义排序。
当查询节点为其他节点的数据源时,设置数据排序就很重要了。
- 新增、更新、删除数据时,根据数据排序依次执行。
- 常规模式,根据查询数据的顺序,取第一条数据执行相关动作。
5. 高级设置
分组字段:根据选择字段的字段值进行分组,调整数据结构。
- 分组后,对原有数据结构进行重组,一级为分组字段、二级为其余字段。
- 相同的字段值将归于同一分组,如性别中的“男”“女”分别为一组。
统计字段:对选择的字段进行数据统计
- 分组后,将根据组的维度进行数据统计。例:分别统计高一年级“男”“女”的平均身高。
# 判断
流程的分支判断,可以根据业务实际需要对工作流进行分流。
# 条件分支
排他分支,根据优先级顺序进行条件判断,仅执行第一个通过的条件判断的分支。
- 当所有分支条件均不符合时,将执行「其他情况」分支
- 当筛选条件的引用变量为多条数据时,仅取首条数据进行判断。
# 业务节点
集成平台内部接口,提供业务能力。
# 消息通知
提供PC端站内信、企业微信消息的通知能力。
业务场景:流程审批完成后,发送企业微信消息通知提单人。
1. 通知方式
- 常规通知:获取单条数据进行消息通知
- 基于数据源发送通知:从数据源中获取多条数据进行消息通知
2. 消息赋值
- 接收人:消息的实际接收方,需要提供「成员」变量或成员ID。
- 消息标题:消息通知的文本标题。
- 消息内容:消息通知的实际内容。
3. 消息渠道
- PC消息中心(站内信):通过站内信向用户发送消息通知,支持配置PC端页面进行跳转。
- 企业微信:通过企业微信应用向用户发送消息通知,支持配置移动端页面进行跳转。
# 企业微信
基于企业微信的开放接口提供产品功能。
# 日程管理
新建、更新、删除企业微信日程。
业务场景:通过发起表单,填写会议内容自动发起会议日程。
1. 日程类型
- 创建日程:根据赋值内容自动发起一个新的日程。
- 更新日程:根据日程ID更新日程信息。
- 取消日程:根据日程ID取消已建立的日程。
2. 提醒时间
设置日程的提醒通知时间。到达提醒时间时,将自动发送企业微信日程通知。
3. 日程信息
定义日程的基本信息与参与方信息。
# 群机器人
通过企业微信群机器人向群成员发送消息通知。
业务场景:业务方收到高优先级报障时,第一时间发送群通知告知相关方进行处理。
1. webHook地址
提供发送消息的群机器人Webhook地址,进行群消息通知。
如何获取群机器人地址?
找到需要发送通知的企业微信内部群,按以下步骤创建群机器人。
2. 通知方式
- 常规通知:获取单条数据进行消息通知
- 基于数据源发送通知:从数据源中获取多条数据进行消息通知
3. 消息类型
- 文本类型:通过群机器人发送文本消息。
- 图片类型:通过群机器人发送图片消息。
- 图文类型:通过群机器人发送图文消息卡片,支持配置移动端、外部链接跳转地址。