@leadal/flowstream-ui-plus 0.0.3 → 0.0.5

package/README.md

@@ -146,6 +146,7 @@ configureWorkflow({
 | `dealUserId`          | 当前用户 ID；自动解析待办和拾取任务时使用        | `string`                                          | 条件 | —      |
 | `dealUserName`        | 当前用户名称                                     | `string`                                          | 否   | —      |
 | `variables`           | 发送、办毕时提交的流程变量                       | `Record<string, unknown>`                         | 否   | `{}`   |
+| `assignmentQueryParams` | 通过 `extendParams` 转发给扩展路由的查询参数   | `Record<string, unknown>`                       | 否   | `{}`   |
 | `autoResolveWork`     | 未传 `workId` 时自动查询当前用户待办             | `boolean`                                         | 否   | `true` |
 | `autoHandleDialogs`   | 在组件内部处理发送和跳转弹窗                     | `boolean`                                         | 否   | `true` |
 | `forceSingleAssignee` | 每个下一节点仅允许选择一名办理人                 | `boolean`                                         | 否   | `false`|
@@ -347,7 +348,7 @@ function handleWork({ action, workData }: {
 - 填写审批意见；
 - 确认后调用任务发送接口，成功后关闭弹窗并提示“发送成功”。
 
-办理人候选数据通过 `POST /flowstream/server/assignment/event/query` 加载。
+办理人候选数据通过 `POST /flowstream/server/assignment/event/query` 加载。业务路由需要额外上下文时，可通过 `assignmentQueryParams` 传入任意数量的扩展参数，也可以不传；组件会将其整体放入请求体的 `extendParams`。请求根对象中的 `processDefinitionId`、`activityId`、`userId`、`parentId` 和 `ntype` 始终由组件维护。
 
 #### 1) 属性定义（Properties）
 
@@ -359,6 +360,7 @@ function handleWork({ action, workData }: {
 | `workId`              | 当前工作项 ID                                        | `string \| number`        | 是   | —          |
 | `processInstanceId`   | 流程实例 ID                                          | `string \| number`        | 否   | `''`       |
 | `variables`           | 当前业务流程变量                                     | `Record<string, unknown>` | 否   | `{}`       |
+| `assignmentQueryParams` | 通过 `extendParams` 转发给扩展路由的查询参数       | `Record<string, unknown>` | 否   | `{}`       |
 | `dealUser`            | 当前用户，可传 `id` 或 `userId`                      | `object`                  | 否   | `{}`       |
 | `bpmnXml`             | BPMN XML；用于辅助判断下一节点是单人还是多人办理     | `string`                  | 否   | `''`       |
 | `showTrigger`         | 是否显示组件自身的发送按钮                           | `boolean`                 | 否   | `true`     |
@@ -406,6 +408,10 @@ import { ref } from 'vue'
 import { FlowButtons, FlowSend } from '@leadal/flowstream-ui-plus'
 
 const sendVisible = ref(false)
+const assignmentQueryParams = {
+  projectId: currentProject.id,
+  tenantId: currentTenant.id,
+}
 
 function handleFlowAction(action: string) {
   if (action === 'taskSend') sendVisible.value = true
@@ -436,6 +442,7 @@ function handleAfterSend() {
     :work-id="task.workId"
     :deal-user="currentUser"
     :variables="variables"
+    :assignment-query-params="assignmentQueryParams"
     :show-trigger="false"
     default-opinion="同意"
     @after-send="handleAfterSend"
@@ -460,6 +467,7 @@ function handleAfterSend() {
 | `workId`              | 当前待办工作项 ID                     | `string \| number` | 确认跳转时是 |
 | `processInstanceId`   | 流程实例 ID（预留上下文）             | `string \| number` | 否           |
 | `dealUser`            | 当前用户，支持 `{ id, userId, name }` | `object`           | 否           |
+| `assignmentQueryParams` | 通过 `extendParams` 转发给扩展路由的查询参数 | `Record<string, unknown>` | 否 |
 | `modelValue`          | 弹窗显示状态，支持 `v-model`          | `boolean`          | 否           |
 | `showTrigger`         | 是否显示组件自带跳转按钮，默认 `true` | `boolean`          | 否           |
 | `dialogTitle`         | 弹窗标题，默认“跳转”                  | `string`           | 否           |
@@ -497,6 +505,7 @@ import { ref } from 'vue'
 import { FlowJump } from '@leadal/flowstream-ui-plus'
 
 const jumpVisible = ref(false)
+const assignmentQueryParams = { deptCode: 'D1001' }
 </script>
 
 <template>
@@ -506,6 +515,7 @@ const jumpVisible = ref(false)
     :process-instance-id="task.processInstanceId"
     :work-id="task.workId"
     :deal-user="currentUser"
+    :assignment-query-params="assignmentQueryParams"
     :show-trigger="false"
     @before-jump="handleBeforeJump"
     @after-jump="handleAfterJump"
@@ -679,6 +689,10 @@ async function submitBusiness() {
       name: borrowTitle,
     },
     variables,
+    assignmentQueryParams: {
+      projectId: currentProject.id,
+      tenantId: currentTenant.id,
+    },
     async onBeforeStart(startArgs) {
       // 可执行同步校验，也可以 await 业务项目自己的表单弹窗。
       const formData = await openBusinessForm()
@@ -744,6 +758,6 @@ await flowstream.getRuntimeService().start({
 })
 ```
 
-业务弹窗通过右上角关闭、路由离开或组件卸载时也必须 `resolve(false)`，避免 `start()` 一直处于等待状态。`singleAssignee` 默认为 `true`，也可在启动参数中传入 `dialogTitle`、`dialogWidth`、`defaultOpinion` 和 `bpmnXml`。
+业务弹窗通过右上角关闭、路由离开或组件卸载时也必须 `resolve(false)`，避免 `start()` 一直处于等待状态。`singleAssignee` 默认为 `true`，也可在启动参数中传入 `dialogTitle`、`dialogWidth`、`defaultOpinion`、`bpmnXml` 和 `assignmentQueryParams`。
 
 `quickStart()`、`getFirstHandleNodes()`、`nextSendNode()`、`nodeAssistant()` 和 `sendTask()` 仍作为底层 API 导出，供组件内部及高级扩展使用；普通业务项目应优先调用 `flowstream.getRuntimeService().start()`，不要自行复制流程编排。