@leadal/flowstream-ui-plus 0.0.3 → 0.0.5

package/docs//346/216/245/345/205/245/346/226/207/346/241/243.md

@@ -179,6 +179,10 @@ const diagramRef = ref<InstanceType<typeof FlowDiagram>>()
   :process-definition-id="task.processDefinitionId"
   :deal-user-id="loginUser.id"
   :deal-user-name="loginUser.name"
+  :assignment-query-params="{
+    projectId: currentProject.id,
+    tenantId: currentTenant.id,
+  }"
   force-single-assignee
   :before-action="validateBeforeAction"
   :after-action="reloadAfterAction"
@@ -206,6 +210,10 @@ import { ref } from 'vue'
 import { FlowSend } from '@leadal/flowstream-ui-plus'
 
 const sendVisible = ref(false)
+const assignmentQueryParams = {
+  projectId: currentProject.id,
+  tenantId: currentTenant.id,
+}
 
 function handleAction(action: string) {
   if (action === 'taskSend') sendVisible.value = true
@@ -222,6 +230,7 @@ function handleAction(action: string) {
     :deal-user="currentUser"
     :show-trigger="false"
     :variables="variables"
+    :assignment-query-params="assignmentQueryParams"
     @before-send="handleBeforeSend"
     @after-send="handleAfterSend"
     @error="handleError"
@@ -231,6 +240,8 @@ function handleAction(action: string) {
 
 推荐通过 `v-model` 控制弹窗，避免宿主依赖组件实例；实例仍公开 `open()`、`close()`、`getNextNode()`、`assembleData()` 和 `send()`。组件通过 `nodeAssistant` 请求 `POST /flowstream/server/assignment/event/query` 加载下一节点候选人，并在确认时直接提交 `/flowstream/server/task/event/send`。
 
+`assignmentQueryParams` 是可选的扩展路由参数对象，可以传一个、多个字段或不传。组件会在每次候选办理人查询（包括组织树懒加载）中将其整体放入 `extendParams`；请求根对象中的 `processDefinitionId`、`activityId`、`userId`、`parentId` 和 `ntype` 由组件维护。使用 `FlowButtons` 内置发送/跳转弹窗或 `getRuntimeService().start()` 时也可传入同名参数。
+
 ## 10. ui-flow-jump
 
 `FlowJump` 内置“开始节点 + 办理人”选择弹窗。办理人支持组织树懒加载；如果节点没有配置办理人，组件会回填当前用户。跳转不编辑业务变量，请求中固定提交 `variables: {}`。
@@ -241,6 +252,7 @@ import { ref } from 'vue'
 import { FlowJump } from '@leadal/flowstream-ui-plus'
 
 const jumpVisible = ref(false)
+const assignmentQueryParams = { deptCode: 'D1001' }
 </script>
 
 <template>
@@ -250,6 +262,7 @@ const jumpVisible = ref(false)
     :process-instance-id="task.processInstanceId"
     :work-id="task.workId"
     :deal-user="{ id: currentUserId, name: currentUserName }"
+    :assignment-query-params="assignmentQueryParams"
     :show-trigger="false"
     @before-jump="handleBeforeJump"
     @after-jump="handleAfterJump"
@@ -298,6 +311,10 @@ async function submit() {
     draftUserName: currentUser.name,
     business: { key: businessId, name: businessName },
     variables,
+    assignmentQueryParams: {
+      projectId: currentProject.id,
+      tenantId: currentTenant.id,
+    },
     async onBeforeStart(startArgs) {
       const formData = await openBusinessForm()
       if (!formData) return false
@@ -331,6 +348,7 @@ async function submit() {
 - 条件稍后满足时调用 `await flowstream.getRuntimeService().open()`，组件会重新执行 `onBeforeSend`；决定放弃时调用 `close()` 撤销实例并释放会话。
 - 调用成功后直接打开选择弹窗，业务模板不需要挂载隐藏组件。
 - 候选办理人可以有多个；`singleAssignee` 默认开启，每个下一节点只能选择一人。
+- 自定义业务路由参数通过 `assignmentQueryParams` 传入，并作为候选办理人查询请求的 `extendParams` 字段发送。
 - 用户确认后由内部发送组件调用 `sendTask()`；`onAfterSend` 参数中的 `sendData.flowNodeAssignees` 是实际发送的下一节点和办理人。
 - 用户未发送就关闭弹窗时会撤销刚创建的流程实例并释放会话；只有 `onBeforeSend` 返回 `false`、弹窗尚未打开时，才能调用 `open()` 在条件满足后继续。
 - `processDefinitionId`、`draftUserId`、`draftUserName` 均为必填；快速启动不支持多个首办节点或多个起草人待办。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leadal/flowstream-ui-plus",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "FlowStream workflow components for Vue 3",
   "type": "module",
   "main": "dist/flowstream-ui-plus.umd.cjs",