用户流程操作

更新时间:2024-12-16 14:06:33

魔笔平台提供了强大的用户流程集成功能,增大了流程的灵活性和适应性,从而更好地处理复杂的业务场景。本文档将指导您如何使用用户流程集成。

什么是用户流程操作

魔笔是一款强大的低代码开发平台,可以帮助企业快速创建内部工具和应用。在这些工具和应用的创建过程中,经常涉及各种集成流。而用户任务便是这些流中的一个关键组成部分。在集成流中,用户任务节点代表了一个需要人工干预或决策的步骤。它通常指的是需要某个用户完成某些操作,比如审核、批准或填写数据。

用户流程操作包括了用户任务以及与这些任务相关的集成流的集成操作。

功能介绍

魔笔平台的用户流程集成功能支持以下特点:

  • 自定义触发方式:集成操作可以设置为手动触发或自动运行,满足不同的业务场景需求。

  • 回调和数据转换:支持在查询成功或失败时执行特定的集成操作事件,以及对返回的数据进行自定义处理。

事件相关内容可参考:集成操作事件

使用用户流程集成

步骤1: 在应用内部创建集成操作

  1. 打开“代码”面板,点击对应作用域的“+”后选中“用户流程”。

image

  1. 选择操作类型,并根据需求选择集成操作的触发方式和更加细节的配置内容。

image

  1. 点击“运行”预览查询效果。

配置面板详解

操作类型

  • 获取集成流实例

  • 获取集成流实例列表

  • 取消集成流实例

  • 获取用户任务

  • 获取用户任务列表

  • 完成用户任务

  • 重新指定用户任务审批人

  • 取消用户任务

集成配置

下面列出了几种操作的配置面板参数:

获取集成流实例列表
  • 集成流:定义了预期获取的集成流。

  • 集成流执行状态:定义了预期获取集成流的状态,包括已完成已取消运行失败运行中

    image

  • 开始时间:定义了预期获取集成流的开始执行时间。

  • 结束时间: 定义了预期获取集成流的结束时间。

完成用户任务
  • taskId:定义了预期完成的用户任务实例 ID。

  • 执行结果输出:定义了预期完成的用户任务的执行结果输出。

获取用户任务列表
  • 筛选方式:定义了预期获取用户任务的筛选方式,包括集成流集成流实例 ID

  • 集成流:若筛选方式为集成流,定义了预期获取流中的用户任务的集成流。

  • 用户任务:若筛选方式为集成流,定义了预期获取的用户任务。

  • flowInstanceId:若筛选方式为集成流实例 ID,定义了预期获取用户任务的集成流实例 ID。

  • 用户任务执行状态:定义了预期获取用户任务的状态,包括待处理已完成已过期已取消

    image

  • 创建时间起始、创建时间结束:定义了预期获取用户任务的创建时间区间。

  • 提交时间起始、提交时间结束:定义了预期获取用户任务的提交时间区间。

  • pageNumber:定义了当前请求的是第几页的数据,从1开始计数。

  • pageSize:定义了每页包含多少条数据。

重新指定用户任务审批人
  • taskId:定义了预期重新指定审批人的用户任务 ID。

  • 审批人:定义了用户任务新的审批人。

说明
集成流权限
  • 只有集成流的发起者可以查看此集成流。

用户任务权限
  • 只有用户任务的发起者和审批人可以查看此任务。

  • 只有用户任务的审批人可以执行“完成用户任务”、“重新指定用户任务审批人”、“取消用户任务”操作。

通用配置

  • 参数:定义了完成操作所需的参数,包括类型、默认值和描述。在输入框中,可通过{{ varName }}的方式引用参数。

  • 描述:为集成操作提供详细描述。

回调配置

  • 数据转换:对接口返回的数据进行处理,默认为return data,即不进行处理。

  • 成功回调:配置接口调用成功时触发的事件。

  • 失败回调:配置接口调用失败时触发的事件。

手动触发集成

事件触发

  1. 在需要触发集成操作的组件中,配置事件处理器。

  2. 将动作类型设置为集成操作,并选择相应的集成。

  3. 以对象形式填写已配置的参数。

API 触发

若此集成操作的名称为action1,则在任何可以执行脚本的地方,可以使用action1.trigger()方法触发集成操作,若集成操作配置了参数,则需要以对象形式填写已配置的参数。

  • 本页导读
  • 什么是用户流程操作
  • 功能介绍
  • 使用用户流程集成
  • 步骤1: 在应用内部创建集成操作
  • 配置面板详解
  • 操作类型
  • 手动触发集成
  • 事件触发
  • API 触发