全部文档
文档中心工作流使用手册关联元素UX工作流相关控件说明

工作流相关控件说明

工作流组件用于逻辑侧的编排,缺少前端展现部分,前端展现需要结合先胜云其他组件进行使用。


目前与工作流最为契合的、用于前端展现的组件则为UX组件。

页面2.0UX组件都主要用于展现,工作流以支持UX组件为主,页面2.0支持的相关工作流功能在UX中都可以支持,因此请尽量使用UX组件。

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

场景示例: 从待办页面,打开一条合同审批的任务,至少需要将以下参数传递给UX

  • 任务实例ID:用来在UX中展示任务信息

  • 相关的业务信息(如合同号):用来展示任务关联的业务数据

UX中配置需要的前端控件,进行保存。

  • UX中有对应JS方法$urlQuery.key,可以获取url传入的数据

  • 可根据需求,将url中传入的数据作为UX中数据源的查询条件/控件的动态默认值

工作流中选择对应UX元素后,会获取UX配置的外部变量,也可自行添加跳转参数。

  • 此处添加的跳转参数键值对,会拼接在打开UX的url链接中

    • 可添加不定数量的键值对

    • 赋值可以使用表达式,将变量/需要赋值的内容计算后赋值给对应参数

UX中的工作流控件,为查询到对应任务/流程所必需的参数配置:

  • 任务处理:任务实例ID-acp$task_id/流程实例ID-wfp$proc_id/业务键

  • 流程记录:流程实例ID-wfp$proc_id/业务键

  • 流程备注:流程实例ID-wfp$proc_id/任务实例ID-acp$task_id

  • 流程图:流程实例ID-wfp$proc_id

配置示例: 可以先在UX中进行赋值操作

  • 数据源(单条)业务主键:$urlQuery.contract

  • 任务处理卡片-任务实例ID:$urlQuery.task

然后在工作流中设置跳转参数

  • contract:wfi$contract_id

  • task:acp$task_id

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

  • 详细方法请参考UX中的对应机制和使用文档

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

  • 详细方法请参考UX中的对应机制和使用文档

  • 当需要将业务信息和任务信息在同一个页面中展示时,可以考虑将UX作为待办页面的入口

  • 切换为【自定义】模式之后,可以配置针对单个流程的显示模式

    • 此时可以针对单个流程,配置在不同tab页下的展示字段,可以配置预置字段的显示隐藏,也可以配置变量(目前只支持string)的显示

    • 当需要将一些业务信息展示在待办页面时,可以考虑这种配置方式


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



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

  • 此控件需要承载从外部通过url传入的任务实例ID,然后根据任务实例ID显示对应的任务信息和任务处理按钮,任务实例为空时,UX控件还支持根据流程实例ID业务键进行动态查询

    • UX采用自定义key的方式进行传参,见上文工作流与UX的关联配置说明

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

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


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

  • 此控件需要承载从外部通过url传入的流程实例ID任务实例ID获取相关的所有流程备注信息

    • UX采用自定义key的方式进行传参,见上文工作流与UX的关联配置说明

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

  • 此控件需要承载从外部通过url传入的proc_id-流程实例ID/业务主键值获取相关的所有流程实例的信息

    • UX采用自定义key的方式进行传参,见上文工作流与UX的关联配置说明

  • 名称:控件的展示标题

  • 流程实例查询:查询目标流程实例的条件,目前支持基于流程实例查询基于业务键查询

    • 基于流程实例查询:需要提供流程实例ID,常用$urlQuery.proc_id(工作流中需配置对应的跳转参数proc_id=wfp$proc_id

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

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

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

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

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

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

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


  • 使用态效果

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

  • 此控件需要承载从外部通过url传入的流程实例ID获取相关的所有流程实例信息,见上文工作流与UX的关联配置说明

  • 展示非人工活动:是否展示子流程或其他非人工节点,非人工活动无法展示进行中状态,可能与您的实际情况有状态差距

回到顶部

咨询热线

400-821-9199

我们使用 ChatGPT,基于文档中心的内容以及对话上下文回答您的问题。

ctrl+Enter to send