cloud-web-corejs 1.0.54-dev.800 → 1.0.54-dev.802

package/src/components/xform/form-render/container-item/data-table-mixin.js

@@ -5,6 +5,7 @@ import containerItemMixin from "./containerItemMixin";
 
 import * as formatUtil from "../../../../components/xform/utils/format.js";
 import tableConfig from "../../../../components/table/config.js";
+import { getTableStateValue } from "../../../../components/table/state";
 import { extendDeeply } from "../../../../utils/index.js";
 import {
   assembleAxiosConfig,
@@ -26,6 +27,7 @@ import {
   resolveColumnRequiredFlag,
 } from "../../../../components/xform/utils/tableColumnHelper";
 import { mergeQueryParam } from "../../../../components/xform/utils/queryParamUtil";
+import { isFixedQueryWidget } from "../../../../components/xform/utils/fixedQueryUtil";
 import { isUrlValueColumn } from "../../../../components/xform/utils/attachmentValueUtil";
 import {
   EXPORT_TYPE,
@@ -1280,6 +1282,7 @@ modules = {
               const finish = () => {
                 this.initFieldSchemaData(true);
                 this.afterDynamicColumnsCommonWidget(effectiveColumns);
+                this.emitAfterColumnsCreated(columns);
                 resolve(columns);
               };
               if (reloadResult?.then) {
@@ -1288,6 +1291,7 @@ modules = {
                 finish();
               }
             } else {
+              this.emitAfterColumnsCreated(columns);
               resolve(columns);
             }
           },
@@ -1295,6 +1299,35 @@ modules = {
         );
       });
     },
+    /**
+     * 表头（列）创建完成后的统一出口：首次建表和运行时重建列（setTableColumns /
+     * 动态列加载）两条链路都经这里，脚本拿到的一定是已经写进 VXE 的最终列。
+     *
+     * 脚本签名：function (dataId, formCode, columns, $grid)
+     *   columns —— 应用到 VXE 的列配置数组（含 checkbox 列、分组表头 children）
+     *   $grid   —— vxe-grid 实例，需要活列对象时用 $grid.getTableColumn()
+     *
+     * 注意：每次表头重建都会触发（动态列表单首屏会触发两次：静态列建表一次、
+     * 动态列回来重建一次），脚本必须幂等。
+     * @param {Array} columns 已应用的列配置。
+     */
+    emitAfterColumnsCreated(columns) {
+      const script = this.widget.options.afterColumnsCreated;
+      if (!script) return;
+      // 列刚写进 vxeOption，DOM 表头还没渲染完，等一拍脚本才能操作表头节点
+      this.$nextTick(() => {
+        try {
+          this.handleCustomEvent(
+            script,
+            ["columns", "$grid"],
+            [columns || [], this.getGridTable()]
+          );
+        } catch (error) {
+          // handleCustomEvent 已按配置弹「前端脚本异常」，这里吞掉避免打断建表后续流程
+          console.error("afterColumnsCreated 脚本执行异常", error);
+        }
+      });
+    },
     /**
      * 替换列配置并刷新 VXE 列、行 schema 和组件选项。
      * @param {Array} tableColumns 新列配置。
@@ -1549,17 +1582,21 @@ modules = {
      * @param {Object} options 可覆盖默认重置行为。
      */
     resetForm(options) {
-      let formData = this.formModel;
       let ignoreFields = options?.ignoreFields || [];
-      this.widget.widgetList.forEach((subWidget) => {
-        if (
-          !ignoreFields.length ||
-          !ignoreFields.includes(subWidget.options.name)
-        ) {
-          let widgetRef = this.getWidgetRef(subWidget.options.name);
-          if (widgetRef && widgetRef.setValue) widgetRef.setValue(null);
-          if (this.isVabsearchFlagWidget(subWidget))
-            widgetRef.setShowValue(null);
+      // 与 getSearchFormData 同口径递归各类容器：查询字段放进栅格/标签页等容器后
+      // 一样要被清空，容器节点本身跳过。
+      loopHandleWidget(this.widget.widgetList, (subWidget) => {
+        if (subWidget.category === "container") return;
+        let widgetName = subWidget.options.name;
+        // 固定查询条件与调用方传的 ignoreFields 取并集，一并跳过
+        if (ignoreFields.includes(widgetName) || isFixedQueryWidget(subWidget)) {
+          return;
+        }
+        let widgetRef = this.getWidgetRef(widgetName);
+        if (!widgetRef) return;
+        if (widgetRef.setValue) widgetRef.setValue(null);
+        if (this.isVabsearchFlagWidget(subWidget) && widgetRef.setShowValue) {
+          widgetRef.setShowValue(null);
         }
       });
     },
@@ -1651,17 +1688,22 @@ modules = {
     getSearchCondition: function () {
       let extraAccessData = this.extraAccessData || {};
       let searchFormData = this.getSearchFormData();
-      let defaultData = {};
 
       // let globalReqData = baseRefUtil.getReportGlobalMap();//全局请求参数
-      let tableCondition = this.getTableCondition();
+      let tableCondition = this.getTableCondition() || {};
       let conditions = {
-        ...defaultData,
         ...tableCondition,
         ...searchFormData,
         ...extraAccessData,
         // ...globalReqData
       };
+      // tableCondition 的 condition 此前恒被 searchFormData 顶掉（getSearchFormData
+      // 一定返回 condition 数组），等于这个通道只能传平铺参数。改为与宿主 queryParam
+      // 同一套追加合并规则：同 field 以 tableCondition 为准。整体优先级
+      // 查询区用户输入 < tableCondition < 宿主 queryParam（后者在 ajax.query 里合并）。
+      if (tableCondition.condition) {
+        mergeQueryParam(conditions, { condition: tableCondition.condition });
+      }
       return conditions;
     },
     /**
@@ -2017,7 +2059,7 @@ modules = {
           if (this.widget.options.showPagination) {
             let proxyInfo = $grid.getProxyInfo();
             let searchCount = true;
-            let isQueryAllPage = $grid.isQueryAllPage;
+            let isQueryAllPage = getTableStateValue($grid, "isQueryAllPage");
             if (isQueryAllPage === false) {
               searchCount = false;
             }
@@ -2088,6 +2130,10 @@ modules = {
             let type = item.type ?? null;
             // let widgetType = item.widgetType ?? widgetType;
             // let isRange = item.isRange || false;
+            // 固定查询条件：lockValue 让公共表格层跳过写值(刷新/还原/确定都不清它)，
+            // fixed 复用公共层已有语义，让个性化 json 回灌时不挪位置、不改常用。
+            // 两者分开的原因见 utils/fixedQueryUtil.js 文件头。
+            let fixedQuery = isFixedQueryWidget(widget);
             searchColumns.push({
               title: this.getI18nLabel(options.label),
               field: this.getFieldKeyName(widget),
@@ -2096,6 +2142,11 @@ modules = {
               // isRange,
               common: true,
               disabled: options.disabled,
+              // hidden 的字段仍要留在 searchColumns(它照样往上送条件)，
+              // 只是不进「查询条件设置」弹框的列表，见 table/tableFormMixin.js
+              hidden: !!options.hidden,
+              lockValue: fixedQuery,
+              fixed: fixedQuery,
               defaultValueEnabled: !!type,
               slot: options.name,
               widget: widget,
@@ -2576,67 +2627,72 @@ modules = {
               let scriptCode = this.getScriptCode();
               let $grid = this.getGridTable();
               let originOption = $grid.params.originOption;
-              let formData = {};
+              // 组装请求参数。必须等 tableFormStop 闸门放开后才求值，所以整体包成
+              // 函数、由 toDo 调用：查询区默认值的写入(tableForm 的 handleSyncFun)
+              // 与搜索控件实例化都发生在闸门释放之后，提前取参只会拿到一份空条件——
+              // 「查询条件设置」存的默认值、控件 options.defaultValue、控件 created
+              // 里赋的值，首查一律带不上。口径与 components/table/index.js 的通用表格
+              // 一致（那边 param() 本就写在 toDo 内）。
+              const buildReqData = () => {
+                let formData = {};
+
+                // 明细·选择导出已按勾选行 id 精确定位，再叠加主表搜索条件既无意义、又可能
+                // 与明细口径的字段名冲突造成双重过滤，故只有它排除搜索条件；
+                // 明细·条件导出与主表条件导出一样，必须带上搜索条件。
+                if (
+                  customParam?.exportParam?.type !== EXPORT_TYPE.ITEM_SELECTED
+                ) {
+                  formData = tableOption.param ? tableOption.param() || {} : {};
+                }
+                const queryParams = Object.assign({}, formData);
+
+                // 处理排序条件
+                /*if (sorts) {
+                  const firstSort = sorts[0];
+                  if (firstSort) {
+                    queryParams.sort = firstSort.property;
+                    queryParams.order = firstSort.order;
+                  }
+                }*/
 
-              // 明细·选择导出已按勾选行 id 精确定位，再叠加主表搜索条件既无意义、又可能
-              // 与明细口径的字段名冲突造成双重过滤，故只有它排除搜索条件；
-              // 明细·条件导出与主表条件导出一样，必须带上搜索条件。
-              if (
-                customParam?.exportParam?.type !== EXPORT_TYPE.ITEM_SELECTED
-              ) {
-                formData = tableOption.param ? tableOption.param() || {} : {};
-              }
-              const queryParams = Object.assign({}, formData);
-
-              // 处理排序条件
-              /*if (sorts) {
-                const firstSort = sorts[0];
-                if (firstSort) {
-                  queryParams.sort = firstSort.property;
-                  queryParams.order = firstSort.order;
+                // 处理筛选条件
+                if (filters) {
+                  filters.forEach(({ property, values }) => {
+                    queryParams[property] = values.join(",");
+                  });
                 }
-              }*/
 
-              // 处理筛选条件
-              if (filters) {
-                filters.forEach(({ property, values }) => {
-                  queryParams[property] = values.join(",");
-                });
-              }
+                if (page.pageSize !== undefined) {
+                  queryParams["size"] = page.pageSize;
+                  queryParams["current"] = page.currentPage;
+                }
 
-              if (page.pageSize !== undefined) {
-                queryParams["size"] = page.pageSize;
-                queryParams["current"] = page.currentPage;
-              }
+                let isQueryAllPage = getTableStateValue($grid, "isQueryAllPage");
+                /* if (isQueryAllPage === false) {
+                  queryParams.searchCount = false;
+                } */
+                queryParams.searchCount = isQueryAllPage !== false;
+                Object.assign(queryParams, param);
+
+                // 宿主（选择弹框/表单弹框/表单抽屉）注入的查询参数：condition 追加合并，
+                // 其余键平铺覆盖，见 utils/queryParamUtil.js
+                if (that.dataTableConfig.queryParam) {
+                  mergeQueryParam(queryParams, that.dataTableConfig.queryParam);
+                }
 
-              // let $grid = this.getGridTable();
-              let isQueryAllPage = $grid.isQueryAllPage;
-              let pathStr1 = "";
-              /* if (isQueryAllPage === false) {
-                queryParams.searchCount = false;
-              } */
-              queryParams.searchCount = isQueryAllPage !== false;
-              Object.assign(queryParams, param);
-
-              // let formRef = that.getFormRef();
-              // let dataTableConfig = formRef.$attrs.dataTableOption || {};
-              // 宿主（选择弹框/表单弹框/表单抽屉）注入的查询参数：condition 追加合并，
-              // 其余键平铺覆盖，见 utils/queryParamUtil.js
-              if (that.dataTableConfig.queryParam) {
-                mergeQueryParam(queryParams, that.dataTableConfig.queryParam);
-              }
+                return {
+                  ...queryParams,
+                };
+              };
 
               let reqPath = typeof path === "function" ? path() : path;
               let accessReturnType =
                 this.widget.options.accessReturnType || "2";
 
               return new Promise((resolve, reject) => {
-                let reqData = {
-                  ...queryParams,
-                };
                 if (scriptCode) {
-                  let index = 0;
                   let toDo = () => {
+                    let reqData = buildReqData();
                     // let f = new Function("dataId", "formCode", "param", "done", accessScript);
                     let done = (res) => {
                       // this.clearRowWidgets();
@@ -2750,19 +2806,7 @@ modules = {
                     };
                     this.loadDefaultQueryList(reqData, done, customParam);
                   };
-                  let loopHandle = () => {
-                    if (index < 500 && $grid.tableFormStop === true) {
-                      //阻塞列表查询，或者次数达到500时，自动释放
-                      index++;
-                      setTimeout(() => {
-                        loopHandle();
-                      }, 10);
-                    } else {
-                      if ($grid.tableFormStop) $grid.tableFormStop = false;
-                      toDo();
-                    }
-                  };
-                  loopHandle();
+                  this.runAfterTableFormReady($grid, toDo);
                 } else {
                   resolve();
                 }
@@ -2894,6 +2938,7 @@ modules = {
         }
         // 列已就绪，补建 created 阶段被延后的行 schema
         this.flushPendingSchemaInit();
+        this.emitAfterColumnsCreated(opts?.columns || columns);
         this.tryAutoLoadDynamicColumns().finally(() => {
           if (!isQueryTable) {
             setTimeout(() => {
@@ -2903,6 +2948,36 @@ modules = {
         });
       });
     },
+    /**
+     * 等查询区就绪后再执行 fn。
+     *
+     * tableForm 挂载时立刻把 $grid.tableFormStop 置 true 把列表查询拦下，直到它
+     * 把查询条件的默认值写进 formModel、并渲染出查询控件后才释放（见
+     * components/table/tableFormMixin.js 的 mounted / handleSyncFun）。
+     *
+     * 调用方必须把「取查询条件」也放进 fn 里：闸门只推迟 fn 的执行时机，在闸门
+     * 之外提前求值的参数拿到的是查询区还没初始化时的空条件。
+     *
+     * 兜底：最多等 500×10ms（5s），超时强制放行，避免查询区异常时列表空转。
+     * @param {Object} $grid VXE Grid 实例。
+     * @param {Function} fn 放行后执行的回调。
+     */
+    runAfterTableFormReady($grid, fn) {
+      let index = 0;
+      let loopHandle = () => {
+        if (index < 500 && $grid.tableFormStop === true) {
+          //阻塞列表查询，或者次数达到500时，自动释放
+          index++;
+          setTimeout(() => {
+            loopHandle();
+          }, 10);
+        } else {
+          if ($grid.tableFormStop) $grid.tableFormStop = false;
+          fn();
+        }
+      };
+      loopHandle();
+    },
     /**
      * 深度遍历分组列和叶子列。
      * @param {Array} columns 列配置。

package/src/components/xform/form-render/container-item/detail-item.vue

@@ -175,6 +175,8 @@ import {
   DEFAULT_SUBMIT_BTN,
   DEFAULT_SAVE_SUBMIT_BTN,
 } from "../../../../components/wf/wfButtonName";
+import { loadWfAutoConfirm } from "../../../../components/wf/wfAutoConfirm";
+import { loadWfUserRange } from "../../../../components/wf/wfUserRange";
 import settingConfig from "@/settings.js";
 
 export default {
@@ -193,9 +195,11 @@ export default {
   created() {
     this.initRefList();
     this.handleOnCreated();
-    //只有流程表单才需要按钮名，避免给普通详情页平白多一次请求(模块内全局只发一次)
+    //只有流程表单才需要按钮名/自动确认开关，避免给普通详情页平白多一次请求(模块内全局只发一次)
     if (this.getFormRef()?.formConfig?.wfEnabled) {
       loadWfButtonNames(this);
+      loadWfAutoConfirm(this);
+      loadWfUserRange(this);
     }
   },
   mounted() {
@@ -349,12 +353,9 @@ export default {
     startWf() {
       let ws = this.wfStart();
       if (!ws || !ws.option || !ws.ctx) return;
-      // 启动确认提示语跟随「提交流程按钮名」:包一层现成的 startConfirmText 钩子,
-      // 既保住模板脚本 wfStartConfirmText 的最高优先级,又不必改公共的 wf.js
-      // (wf.js 默认分支走 $t2(文案, key),i18n 命中 key 会把自定义按钮名吞掉)。
-      let inner = ws.option.startConfirmText;
-      //只有后台真配了按钮名才改提示语；没配就返空，让 wf.js 走它自己的默认链
-      let btnName = getWfButtonNames().submitBtn;
+      // startConfirmText 原样透传:它只承载模板脚本 wfStartConfirmText 的文案(见 indexMixin
+      // 的 option 构造)。按钮名拼接与「后台 param19 自动确认」都由 wf.js 统一处理——
+      // 在这里替它拼默认文案的话,wf.js 会把它当成脚本自定义的告警,自动确认就失效了。
       let innerOnStart = ws.option.onStart;
       let formRef = this.getFormRef && this.getFormRef();
       openStartWfDialog(ws.ctx, {
@@ -377,11 +378,6 @@ export default {
             runBefore();
           }
         },
-        startConfirmText: async (ctx) => {
-          let text = typeof inner === "function" ? await inner.call(this, ctx) : inner;
-          if (typeof text === "string" && text.trim()) return text; //模板脚本优先
-          return btnName ? `您确定要${btnName}吗？` : ""; //返空 → wf.js 走自身默认
-        },
       });
     },
     // 触发宿主翻单：step = -1 上一单 / +1 下一单

package/src/components/xform/lang/en-US.js

@@ -190,6 +190,9 @@ export default {
           readonly: "Readonly",
           disabled: "Disabled",
           hidden: "Hidden",
+          fixedQuery: "Fixed Query Condition",
+          fixedQueryHelp:
+            "Keeps its value when Refresh / Revert / Confirm runs, and is read-only in Query Condition Setting",
           textContent: "Text",
           htmlContent: "HTML",
           clearable: "Clearable",

package/src/components/xform/lang/zh-CN.js

@@ -344,6 +344,9 @@ export default {
       readonly: "只读",
       disabled: "禁用",
       hidden: "隐藏",
+      fixedQuery: "固定查询条件",
+      fixedQueryHelp:
+        "开启后该条件不被刷新、查询条件设置的还原/确定清空，且在查询条件设置里只读",
       textContent: "静态文字",
       preWrap: "自动换行",
       htmlContent: "HTML",

package/src/components/xform/mixins/defaultHandle.js

@@ -3,6 +3,14 @@ import { saveUserLog } from "@base/api/user";
 import settingConfig from "@/settings";
 import { openStartWfDialog } from "../../../components/wf/wfUtil";
 import { getWfButtonNames } from "../../../components/wf/wfButtonName";
+import {
+  isWfAutoConfirm,
+  loadWfAutoConfirm,
+} from "../../../components/wf/wfAutoConfirm";
+import {
+  isWfUserRangeEnabled,
+  loadWfUserRange,
+} from "../../../components/wf/wfUserRange";
 
 let modules = {};
 modules = {
@@ -134,7 +142,7 @@ modules = {
         });
       }
     },
-    saveAndSubmitWfHandle(option) {
+    async saveAndSubmitWfHandle(option) {
       let formRef = this.getFormRef ? this.getFormRef() : this;
       let formConfig = formRef.formConfig;
       let reportTemplate = formRef.reportTemplate;
@@ -159,12 +167,18 @@ modules = {
           ? this.$t1(`您确定要${btnName}吗？`)
           : this.$t1("您确定要保存并提交流程吗？"));
 
+      // param19 + param12 都开：这道「保存前」的确认框不弹，把确认交给 wfStartDialog——
+      // 它在保存之后才探 preStart，探到候选人就由「修改候选人」弹框顶替，探不到才弹确认框。
+      // 任一为 false 都当场弹：param12 关着后面不可能有候选人弹框，延后没有意义。
+      await Promise.all([loadWfAutoConfirm(this), loadWfUserRange(this)]);
+      let autoConfirm = isWfAutoConfirm() && isWfUserRangeEnabled();
+
       return this.saveDefaultHandle({
         ...option,
         config: {
           ...option?.config,
           successMsg: option?.config?.successMsg ?? true,
-          isConfirm: option?.config?.isConfirm ?? true,
+          isConfirm: option?.config?.isConfirm ?? !autoConfirm,
           confirmText: option?.config?.confirmText || confirmText,
           skipHostReloadAfterSave: true,
           //提交前置处理(与「提交流程」按钮共用同一个表单脚本)
@@ -187,7 +201,8 @@ modules = {
               wfCode: reportTemplate.objTypeCode,
               formCode: reportTemplate.formCode,
               serviceId: reportTemplate.serviceName,
-              skipStartConfirm: true,
+              // 上面确认过就不再弹第二次；上面因 param19 跳过了，就得让弹框自己去确认
+              skipStartConfirm: !autoConfirm,
               // 提交后行为复用 xform 侧统一方法：
               //  成功 → onWfStartSuccess（关页签/刷新本页）；失败/取消 → onWfStartAbort（刷新到编辑态）
               onStartSuccess: () =>

package/src/components/xform/utils/fixedQueryUtil.js

@@ -0,0 +1,93 @@
+/**
+ * 「固定查询条件」判定工具。
+ *
+ * 数据表格查询区的字段值存在整张表单的 formModel 上，三条通道会把它清掉：
+ *   1. 刷新按钮 → resetForm 逐个 setValue(null)
+ *   2. 「查询条件设置」的「确定」→ tableFormMixin.dialogPrimary 按列写默认值
+ *   3. 「查询条件设置」的「还原」→ 走的就是 dialogPrimary
+ * 字段勾上 options.fixedQuery 之后，这三条通道一律跳过它，值保持原样
+ * (值本身仍由树点选/脚本 setValue 等业务通道注入，本开关只管「不被清掉」)。
+ *
+ * 组装 searchColumns 时(见 container-item/data-table-mixin.js)由 fixedQuery
+ * 派生出两个列级标记：
+ *   - lockValue：公共表格层(components/table)据此跳过写值，语义是「值锁定」
+ *   - fixed：复用公共层已有语义，让个性化 json 回灌时不挪位置、不改常用
+ * 两者必须分开：手写页面的固定列(如 branchSearchPage 的分支)只打 fixed，
+ * 它**依赖** dialogPrimary 按 defaultValue 回填，不能被 lockValue 一起跳过。
+ */
+
+/* 能承载子组件的字段名，覆盖各类容器(含 vf-dialog/vf-drawer，loopHandleWidget 不进这两个) */
+const CHILD_KEYS = [
+  "widgetList",
+  "cols",
+  "rows",
+  "tabs",
+  "panes",
+  "buttons",
+  "buttonWidgetList",
+  "leftWidgetList",
+];
+
+/**
+ * 深度遍历组件树节点（含 rows 这类只有 cols 的中间层对象）。
+ * @param {Object} node 起始节点
+ * @param {Function} callback 每个节点回调
+ */
+function walkWidget(node, callback) {
+  if (!node || typeof node !== "object") return;
+  callback(node);
+  CHILD_KEYS.forEach((key) => {
+    let children = node[key];
+    if (Array.isArray(children)) {
+      children.forEach((child) => walkWidget(child, callback));
+    }
+  });
+}
+
+/**
+ * 该字段是否勾选了「固定查询条件」。
+ * @param {Object} widget 字段组件 schema
+ * @returns {Boolean}
+ */
+export function isFixedQueryWidget(widget) {
+  return !!(widget && widget.options && widget.options.fixedQuery);
+}
+
+/**
+ * 该列是否为「值锁定」列（公共表格层的口径，见文件头注释）。
+ * @param {Object} column searchColumns 的列配置
+ * @returns {Boolean}
+ */
+export function isLockedSearchColumn(column) {
+  return !!(column && column.lockValue);
+}
+
+/**
+ * 组件是否位于某个数据表格的查询区（data-table 的 widgetList 分支，不含 buttons、
+ * 不含表格列组件）。属性面板据此决定要不要显示「固定查询条件」开关。
+ * @param {Array} widgetList 表单顶层组件列表（designer.widgetList）
+ * @param {Object} widget 待判定的字段组件
+ * @returns {Boolean}
+ */
+export function isQueryAreaWidget(widgetList, widget) {
+  if (!widget || !widget.id || !Array.isArray(widgetList)) return false;
+  let inQueryArea = false;
+  widgetList.forEach((item) => {
+    walkWidget(item, (node) => {
+      if (inQueryArea) return;
+      if (
+        node.category !== "container"
+        || node.type !== "data-table"
+        || !Array.isArray(node.widgetList)
+      ) {
+        return;
+      }
+      node.widgetList.forEach((child) => {
+        walkWidget(child, (sub) => {
+          if (sub.id === widget.id) inQueryArea = true;
+        });
+      });
+    });
+  });
+  return inQueryArea;
+}