@leadal/flowstream-ui-plus 0.0.11 → 0.0.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +10 -5
- package/dist/flowstream-ui-plus.js +4888 -4450
- package/dist/flowstream-ui-plus.umd.cjs +15 -15
- package/dist/index.d.ts +46 -57
- package/dist/style.css +1 -1
- package/docs//346/216/245/345/205/245/346/226/207/346/241/243.md +3 -3
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -350,14 +350,18 @@ function handleWork({ action, workData }: {
|
|
|
350
350
|
|
|
351
351
|
`ui-flow-send` 是完整的任务发送弹窗，不只是一个“发送”按钮。组件内置以下交互：
|
|
352
352
|
|
|
353
|
+
- 发送前调用 `checkSend`，完全按后端 `matched` 判断是否需要选择办理人；
|
|
354
|
+
- `matched=true` 时展示下一节点、办理人确认框，用户确认后直接发送；
|
|
355
|
+
- `matched=false` 时打开完整发送弹窗；
|
|
353
356
|
- 根据当前流程定义、节点、工作项和变量计算下一环节；
|
|
354
357
|
- 按下一环节加载候选办理人，支持列表和懒加载树；
|
|
355
358
|
- 选择各下一环节的办理人；
|
|
356
359
|
- 新增、删除和转换流程变量，并重新计算下一环节；
|
|
360
|
+
- 通过普通页签维护扩展参数，按“参数名称、参数类型、参数值”组装后传入办理人查询；
|
|
357
361
|
- 填写审批意见；
|
|
358
362
|
- 确认后调用任务发送接口，成功后关闭弹窗并提示“发送成功”。
|
|
359
363
|
|
|
360
|
-
办理人候选数据通过 `POST /flowstream/server/assignment/event/query` 加载。业务路由需要额外上下文时，可通过 `assignmentQueryParams`
|
|
364
|
+
办理人候选数据通过 `POST /flowstream/server/assignment/event/query` 加载。业务路由需要额外上下文时，可通过 `assignmentQueryParams` 传入任意数量的扩展参数，也可以不传；用户还能在“扩展参数”页签继续编辑。组件校验参数名称、类型和值后将其整体放入请求体的 `extendParams`，参数变化时会清空旧办理人并重新加载候选人。请求根对象中的 `processDefinitionId`、`processInstanceId`、`activityId`、`userId`、`parentId` 和 `ntype` 始终由组件维护。动态路由配置为“流程启动者”时，后端通过 `processInstanceId` 读取该实例的起草人。
|
|
361
365
|
|
|
362
366
|
#### 1) 属性定义（Properties）
|
|
363
367
|
|
|
@@ -367,7 +371,7 @@ function handleWork({ action, workData }: {
|
|
|
367
371
|
| `processDefinitionId` | 流程定义 ID | `string \| number` | 是 | — |
|
|
368
372
|
| `activity` | 当前节点，至少包含 `activityId`，可带 `activityName` | `object` | 是 | — |
|
|
369
373
|
| `workId` | 当前工作项 ID | `string \| number` | 是 | — |
|
|
370
|
-
| `processInstanceId` | 流程实例 ID
|
|
374
|
+
| `processInstanceId` | 流程实例 ID；动态路由以流程启动者为基准时必需 | `string \| number` | 条件 | `''` |
|
|
371
375
|
| `variables` | 当前业务流程变量 | `Record<string, unknown>` | 否 | `{}` |
|
|
372
376
|
| `assignmentQueryParams` | 通过 `extendParams` 转发给扩展路由的查询参数 | `Record<string, unknown>` | 否 | `{}` |
|
|
373
377
|
| `dealUser` | 当前用户，可传 `id` 或 `userId` | `object` | 否 | `{}` |
|
|
@@ -385,7 +389,7 @@ function handleWork({ action, workData }: {
|
|
|
385
389
|
| --------------------- | --------------------- | -------------------------------------------------- |
|
|
386
390
|
| `update:modelValue` | `visible: boolean` | `v-model` 更新 |
|
|
387
391
|
| `click` | — | 点击组件自身发送按钮时触发，随后组件会自行打开弹窗 |
|
|
388
|
-
| `open` | — |
|
|
392
|
+
| `open` | — | 开始执行发送前检查；未命中时继续打开完整弹窗 |
|
|
389
393
|
| `close` | — | 弹窗完成关闭 |
|
|
390
394
|
| `next-nodes-resolved` | `nodes: FlowNode[]` | 下一环节解析成功 |
|
|
391
395
|
| `before-send` | `data` | 请求发送前触发，参数是即将提交的数据 |
|
|
@@ -396,13 +400,14 @@ function handleWork({ action, workData }: {
|
|
|
396
400
|
|
|
397
401
|
| 名称 | 类型 | 说明 |
|
|
398
402
|
| ------------------------- | ------ | -------------------------------------------------------- |
|
|
399
|
-
| `open()` | Method |
|
|
403
|
+
| `open()` | Method | 执行发送前检查；未命中时打开弹窗并解析下一环节 |
|
|
400
404
|
| `close()` | Method | 关闭弹窗 |
|
|
401
405
|
| `getNextNode(variables?)` | Method | 根据变量重新解析下一环节 |
|
|
402
406
|
| `assembleData()` | Method | 组装 `{ workId, flowNodeAssignees, variables, opinion }` |
|
|
403
407
|
| `send(formData?)` | Method | 提交发送；不传参数时使用 `assembleData()` |
|
|
404
408
|
| `visible` | Ref | 内部弹窗状态 |
|
|
405
409
|
| `loading` | Ref | 发送状态 |
|
|
410
|
+
| `checkingSend` | Ref | 发送前检查状态 |
|
|
406
411
|
| `nodeLoading` | Ref | 下一环节计算状态 |
|
|
407
412
|
| `nodeResolved` | Ref | 下一环节是否已完成计算 |
|
|
408
413
|
| `nextNodes` | Ref | 下一环节列表 |
|
|
@@ -474,7 +479,7 @@ function handleAfterSend() {
|
|
|
474
479
|
| --------------------- | ------------------------------------- | ------------------ | ------------ |
|
|
475
480
|
| `processDefinitionId` | 流程定义 ID | `string \| number` | 是 |
|
|
476
481
|
| `workId` | 当前待办工作项 ID | `string \| number` | 确认跳转时是 |
|
|
477
|
-
| `processInstanceId` | 流程实例 ID
|
|
482
|
+
| `processInstanceId` | 流程实例 ID；动态路由以流程启动者为基准时必需 | `string \| number` | 条件 |
|
|
478
483
|
| `dealUser` | 当前用户，支持 `{ id, userId, name }` | `object` | 否 |
|
|
479
484
|
| `assignmentQueryParams` | 通过 `extendParams` 转发给扩展路由的查询参数 | `Record<string, unknown>` | 否 |
|
|
480
485
|
| `modelValue` | 弹窗显示状态，支持 `v-model` | `boolean` | 否 |
|