cloud-web-corejs 1.0.54-dev.801 → 1.0.54-dev.803

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

@@ -27,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,
@@ -1581,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);
         }
       });
     },
@@ -1683,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;
     },
     /**
@@ -2120,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),
@@ -2128,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,
@@ -2608,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 = getTableStateValue($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();
@@ -2782,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();
                 }
@@ -2936,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/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/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;
+}