zc-ui-workflow
Version:
基于vue bpmn 封装的流程引擎前端组件
230 lines (170 loc) • 11.1 kB
Markdown
<!--
* @Descripttion:
* @Author: fanfuda
* @Date: 2023-01-18 10:41:29
* @LastEditors: fanfuda
* @LastEditTime: 2023-06-08 15:41:52
-->
## Install
```shell
# 使用 npm 包管理器的
npm install zc-ui-workflow -S
# 使用 yarn 包管理器的
yarn add zc-ui-workflow
```
## Quick Start
```javascript
// main.js or .vue
import Vue from 'vue';
import zcWorkflow from 'zc-ui-workflow';
import 'zc-ui-workflow/libs/index.css';
Vue.use(zcWorkflow);
// or
import { WorkFlow } from 'zc-ui-workflow';
Vue.component(WorkFlow.name, WorkFlow);
// 流程组件--编辑模式
<zc-workflow
ref="workflow"
:mode="'edit'"
:showStartDesign="false"
:config="bpmnConfig"
:formId="formId"
:engineId="engineId"
@flow-action="flowAction"
@bpmn-modeler="initModeler"
></zc-workflow>
// 流程组件--预览模式
<zc-workflow
ref="workflow"
:mode="'view'"
:engineId="engineId"
@flow-detial="flowDetail"
@bpmn-modeler="initModeler"
></zc-workflow>
// 流程组件--流程操作按钮
<zc-workflow-permission
ref="workflowAction"
hideButtonGroups='all'
:permissionParams="permissionParams"
@permission-success="permissionData"
@action-handle="actionHandle"
></zc-workflow-permission>
//流程办理组件
<zc-workflow-handle
:formData="formData"
:permissionParams="permissionParams"
@get-submitCode="getSubmitCode"
@get-formData="getNewFormData"
@action-handle="actionHandle"
>
<template #headerLeft> 这是左侧内容 </template>
<template #headerRight>
这是右侧内容
</template>
<template v-slot:formView>这是表单数据</template>
</zc-workflow-handle>
// 流程操作工具类引用
import utils from 'zc-ui-workflow/utils/bpmnUtils';
//流程列表相关API
import flowHandle from 'zc-ui-workflow/utils/handleUtils';
```
### 版本更新记录
#### 0.2.2
| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 |
| :------- | :----------- | :----------------------------------------------------------- | :--- | :--------: |
| 流程引擎 | -- | 修复边界事件节点增加 isUserChange 属性处理监听器移除失效问题 | ffd | 2023/06/08 |
| 流程办理 | 增加转办操作 | 修复有网关单选人员选择回显问题 | ffd | 2023/06/08 |
#### 0.2.1
| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 |
| :------- | :----------------------------- | :------------------------------------------------- | :--- | :--------: |
| 流程引擎 | -- | 修复表单权限回显问题 | ffd | 2023/06/06 |
| 流程办理 | 增加节点办理人单个人员直接回显 | 移除处理意见必填校验、流修复程办理人选中未回显问题 | ffd | 2023/06/06 |
#### 0.2.0
| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 |
| :------- | :----------------------- | :------------------------------------------------------------- | :--- | :--------: |
| 流程引擎 | 增加超时配置面板 | 修复新增节点时表单权限、操作权限为空问题、优化表单权限选中逻辑 | ffd | 2023/06/05 |
| 流程办理 | 对接基本信息面板相关接口 | -- | ffd | 2023/06/05 |
#### 0.1.8
| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 |
| :------- | :----------------------------------------------------------------------- | :------- | :--- | :--------: |
| 组件 | 新增流程办理组件 | | ffd | 2023/05/26 |
| 流程引擎 | 用户任务节点增加跳转规则配置、连线增加默认路径配置 | | ffd | 2023/05/26 |
| 流程引擎 | 用户任务节点增加跳转规则配置、去除操作按钮默认全选；连线增加默认路径配置 | | ffd | 2023/05/26 |
| 流程办理 | 催办、收回、终止、撤办操作取消回退操作 | | ffd | 2023/05/26 |
#### 0.1.7
| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 |
| :----- | :------------------------------- | :------- | :--- | :--------: |
| 组件 | 公共组件、第三方库抽取，优化体积 | | ffd | 2023/05/12 |
#### 0.1.6
| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 |
| :------- | :------------------------------------------- | :---------------------------- | :--- | :--------: |
| 流程引擎 | 调整流程版本样式、更新流程保存、发布相关逻辑 | 修复办理记录 loading 状态问题 | ffd | 2023/05/10 |
#### 0.1.5
| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 |
| :------- | :--- | :--------------------------- | :--- | :--------: |
| 流程引擎 | -- | 修复关闭流程后状态未更新问题 | ffd | 2023/05/06 |
#### 0.1.4
| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 |
| :------- | :--------------------------------------------------- | :------- | :--- | :--------: |
| 流程引擎 | 优化流程版本功能、增加流程加载动效、优化流程接口请求 | -- | ffd | 2023/05/06 |
#### 0.1.3
| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 |
| :------- | :--- | :------------------------------------------- | :--- | :--------: |
| 按钮权限 | -- | 修复自定义调用按钮时、按钮组件不存在报错问题 | ffd | 2023/04/28 |
| 流程引擎 | -- | 修复初始化流程时，按钮权限为空问题 | ffd | 2023/04/28 |
#### 0.1.2
| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 |
| :------- | :---------------------------------------------------------------------------------------- | :------- | :--- | :--------: |
| 按钮权限 | 优化弹窗追加位置、增加表单 formData 传参、优化部分 url 参数获取方式、增加流程按钮隐藏参数 | -- | ffd | 2023/04/28 |
| 流程引擎 | 移除 enCode 参数增加 fromId 作为唯一标识、禁用部分未使用流程节点、增加流程版本切换功能 | -- | ffd | 2023/04/28 |
| 体积优化 | 移除部分未使用组件，优化打包后生成的体积 | -- | ffd | 2023/04/28 |
#### 0.1.1
| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 |
| :------- | :------------------------------------- | :----------------------------------------------- | :--- | :--------: |
| 按钮权限 | 默认操作按钮全选，优化操作弹窗显示样式 | -- | ffd | 2023/04/20 |
| 流程引擎 | -- | 优化初始化流程 id 赋值、预览模式修复渲染显示问题 | ffd | 2023/04/20 |
#### 0.1.0
| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 |
| :------- | :--------------------- | :------------------------- | :--- | :--------: |
| 按钮权限 | 增加抄送、终止操作按钮 | | ffd | 2023/04/18 |
| 办理记录 | -- | 优化人员信息显示样式 | ffd | 2023/04/18 |
| 组件 | -- | 修复打包后弹窗样式失效问题 | ffd | 2023/04/18 |
#### 0.0.9
| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 |
| :----- | :----------- | :------- | :--- | :--------: |
| -- | 移除部分依赖 | -- | ffd | 2023/04/17 |
#### 0.0.8
| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 |
| :----- | :---------------------------------------- | :------------------------- | :--- | :--------: |
| 组件 | 处理 css 样式隔离、抽离人员选择器公用组件 | 修复人员选择器赋值回显问题 | ffd | 2023/04/17 |
#### 0.0.7
| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 |
| :----- | :---------------------------------------------------------- | :----------------------- | :--- | :--------: |
| 组件 | 优化流程为空处理逻辑、编辑模式增加 showStartDesign 配置字段 | 修复流程版本运行状态判断 | ffd | 2023/04/13 |
#### 0.0.6
| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 |
| :------- | :------------------------------------------------------------- | :------- | :--- | :--------: |
| 按钮权限 | 优化操作完成回调方法、增加自定义提交调用方法 | -- | ffd | 2023/04/13 |
| 组件 | 增加流程为空时展示页面、增加流程版本控制、默认提交、发布按钮组 | -- | ffd | 2023/04/13 |
#### 0.0.5
| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 |
| :----- | :--- | :------: | :--: | :------: |
| ------ | ---- | -------- | ---- | -------- |
#### 0.0.4
| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 |
| :------- | :----------------------------- | :------- | :------- | :--------: |
| 按钮权限 | 增加退回、补发、添加分支等按钮 | -- | ffd、szc | 2023/03/30 |
| 组件 | 增加流程办理记录组件 | -- | ffd、szc | 2023/03/30 |
#### 0.0.3
| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 |
| :------- | :------------------------------- | :------- | :------- | :--------: |
| 体积优化 | 移除部分包，优化打包后生成的体积 | -- | ffd、szc | 2023/03/06 |
| 组件 | 增加按钮权限组件 | -- | ffd、szc | 2023/03/06 |
#### 0.0.2
| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 |
| :----- | :-------------------- | :------- | :------- | :--------: |
| 工具类 | 新增流程引擎工具类 js | -- | ffd、szc | 2023/02/27 |
#### 0.0.1
| 新特性 | 描述 | Bug 修复 | 作者 | 更新时间 |
| :----- | :----------------- | :------- | :------- | :--------: |
| 初始化 | 新增流程引擎基础库 | -- | ffd、szc | 2023/01/18 |