UX 工作流控件参考

工作流与UX的关联配置说明

工作流的任务处理可以在UX元素中操作，同时也有很多控件支持在UX元素中配置，此处统一说明如何在工作流中关联一个UX元素，同时实现需要的数据传递。

先在 UX 的“页面变量”中声明所需的外部变量，再配置控件并保存。工作流选择这个 UX 后，加载已保存的外部变量清单，为同名跳转参数赋值。

例如声明字符串类型的外部变量 contract、task、proc，工作流分别传入 wfi$contract_id、acp$task_id、wfp$proc_id。UX 通过变量选择器或 $var.变量编码 使用这些值：

• 业务数据源：以 $var.contract 为主键查询合同。

• 任务处理：任务实例 ID 使用 $var.task；需要后备查询时，按规则使用 $var.proc 或业务键。

• 流程记录：流程实例 ID 使用 $var.proc；按业务键查询时，提供与流程一致的业务键。

• 流程备注：按查询范围使用 $var.proc 或 $var.task。

• 流程图：流程实例 ID 使用 $var.proc。

业务键若从外部传入，也要先声明对应外部变量；若由本页控件或数据源计算，则继续使用相应数据来源。完整步骤见 打开 UX 与传参。

动作-发起流程

• UX中发起流程通过UX中的动作配置实现，选择工作流元素之后，可以为工作流的启动参数赋值

• 逐步配置及保存顺序见 从 UX 发起流程。

  

动作-发起消息事件

• UX中发起消息事件通过UX中的动作配置实现，选择工作流元素之后，可以选择此工作流的消息体，并为消息参数赋值

• 消息选择、接收范围和参数配置见 消息交互与批量发起。

  

待办页面

任务处理

任务处理控件，支持直接在UX中进行任务处理操作：

任务处理配置可从 合同审批 Demo 的审批详情 UX 查看；如需业务键后备查询，应选择相应的外部变量。

• 该页面为标准功能，上方的操作按钮将根据任务中配置的动作动态渲染

• 此控件根据传入的任务实例ID显示对应任务。未查到结果时，需开启后备查询，才能按配置的流程实例ID或业务键继续查询；仅填写后备参数不会自动开启。详见 任务处理与结果回传。

  • UX 通过已声明的外部变量接收跳转参数，见上文关联配置说明。

• 展示字段配置：允许配置字段是否展示、展示名称、展示顺序

在 Demo 的审批详情 UX 中选择任务处理控件，打开“展示字段配置”即可查看和调整。

• 完成任务所需参数：支持完成任务时，将参数传递到工作流中的【acr$extra_res】变量中进行使用

  

  

流程备注

流程备注控件，支持直接在UX中显示流程进程中的备注信息

• 此控件按查询范围使用承接流程实例 ID 或任务实例 ID 的外部变量，例如 $var.proc 或 $var.task。

  • 工作流先为同名跳转参数赋值，见上文关联配置说明。

详细说明见 展示记录与流程图。

流程记录

流程记录控件，支持直接在UX中显示流程进程中的历史记录

• 此控件使用流程实例 ID 或业务键查询流程。外部传入的值应先声明为 UX 外部变量；业务键的取值必须与工作流配置一致，不能直接假定等于业务主键。

  • UX 中选择对应变量，见上文关联配置说明。

    

• 名称：控件的展示标题

• 流程实例查询：先按流程实例 ID 查询；当前面板可开启“结果为空时，基于业务键进行动态查询”。旧截图中的查询方式布局仅供参考。

  • 基于流程实例查询：使用外部变量 proc_id（表达式为 $var.proc_id），工作流配置同名跳转参数 proc_id = wfp$proc_id。本章合同示例用变量 proc，两种命名均需保证两端一致。

  • 基于业务键查询：需要选择工作流元素，并提供业务键的值（例如由UX中多个维度选择器的值拼接而成），对应工作流中的配置为全局配置-高级-启用业务键唯一-businessKey值来源

• 展示已完成/已终止的流程实例：根据上述查询方式，查询出一个或多个流程实例，是否需要展示已完成/已终止状态的流程实例，查询出多个流程实例时，可以进行流程实例的切换，默认展示的流程实例为：

  • 当存在进行中流程实例时，默认展示第一个进行中的流程实例；

  • 当不存在进行中流程实例时，默认展示第一个已完成的流程实例；

• 展示字段配置：可配置区域内字段是否展示、展示名称、排序

  • 流程信息：红框内的信息

  • 流程记录：绿框内的信息

    

    

• 使用态效果

  

  

流程图

流程图控件，支持直接在UX中以图例化的方式展示当前流程的运行状态，显示进行中、未开始、已完成和发生异常的流程节点。

• 此控件使用接收流程实例 ID 的外部变量，例如 $var.proc；工作流需配置 proc = wfp$proc_id，见上文关联配置说明。

• 当前流程图的展示和子流程查看方式见 展示记录与流程图，以实际版本提供的选项为准。

流程图配置可从 合同审批 Demo 的审批详情 UX 查看，流程实例 ID 选择【UX变量 → proc】。