cloud-web-corejs 1.0.54-dev.740 → 1.0.54-dev.742

package/src/components/xform/form-designer/widget-panel/widgetsConfig.js

@@ -4297,8 +4297,7 @@ export const compareFields = [
       customClass: "",
       onCreated: "",
       onMounted: "",
-      onClick:
-        "this.getFormRef().getGlobalConfig().enableCompareBySource(this)",
+      onClick: "this.getFormRef().enableCompareBySource()",
       accessType: "1",
       clickBindEvent: null,
       onBeforeClickButton: null,
@@ -4342,7 +4341,7 @@ export const compareFields = [
       customClass: "",
       onCreated: "",
       onMounted: "",
-      onClick: "this.getFormRef().getGlobalConfig().disableCompare(this)",
+      onClick: "this.getFormRef().disableCompare()",
       accessType: "1",
       clickBindEvent: null,
       onBeforeClickButton: null,
@@ -4386,7 +4385,7 @@ export const compareFields = [
       customClass: "",
       onCreated: "",
       onMounted: "",
-      onClick: "this.getFormRef().openCompareDelList('明细表keyName')",
+      onClick: "this.getFormRef().openCompareDelList()",
       accessType: "1",
       clickBindEvent: null,
       onBeforeClickButton: null,

package/src/components/xform/form-render/indexMixin.js

@@ -275,6 +275,8 @@ modules = {
       // sanitize 阶段由 subSourceFields 回填出来的字段（如 f_source_item_id）。
       // 这些字段原单行里没有，参与对比会被误判为"变更"，故自动排除。
       compareAutoExcludeFields: [],
+      // setupChangeCompare(cfg) 配置后缓存的控制器，供 getChangeCompare() 取用
+      changeCompareCtl: null,
       showCompareDelList: false,
       compareDelListOption: {},
     };
@@ -2246,10 +2248,23 @@ modules = {
         this.$set(row, "hData", old ? deepClone(old) : {});
       });
     },
+    /**
+     * 行匹配。a=原单行、b=当前(变更)行。rowKey 支持：
+     *   'f_uuid'                两边同名字段：a.f_uuid === b.f_uuid
+     *   { from:'id', to:'f_source_item_id' }  跨字段名：a.id === b.f_source_item_id
+     *   ['f_a','f_b'] 或 [{from,to},...]      多字段联合，全部满足才算同一行
+     * 每个键的原单侧取值必须非空。
+     */
     matchCompareRowKey: function (a, b, rowKey) {
       rowKey = rowKey || this.compareRowKey;
-      if (!a || !b) return false;
-      return a[rowKey] != null && a[rowKey] === b[rowKey];
+      if (!a || !b || !rowKey) return false;
+      let list = Array.isArray(rowKey) ? rowKey : [rowKey];
+      if (!list.length) return false;
+      return list.every((k) => {
+        let from = k && typeof k === "object" ? k.from : k;
+        let to = k && typeof k === "object" ? k.to || k.from : k;
+        return a[from] != null && a[from] === b[to];
+      });
     },
     /** 关闭对比，复位状态并移除各行 hData */
     disableCompare: function () {
@@ -2272,6 +2287,11 @@ modules = {
       this.compareAutoExcludeFields = [];
       this.showCompareDelList = false;
       this.compareDelListOption = {};
+      // 若配置了 setupChangeCompare：联动按钮显隐 + 触发对比开关钩子
+      if (this._compareToggle) {
+        this._compareToggle(false);
+        if (this._compareFire) this._compareFire("onCompareToggle", false);
+      }
     },
     /**
      * 按「数据属性名称(keyName)」拿到 data-table 实例的实时行数据。
@@ -2553,6 +2573,10 @@ modules = {
     },
     /** 打开"查看删除数据"弹窗。columns 不传时默认取当前数据表格的列。 */
     openCompareDelList: function (subFormName, columns) {
+      // 无参 + 已配置控制器 → 用 cfg.detailName（单明细便捷）
+      if (!subFormName && this._compareDetailName) {
+        subFormName = this._compareDetailName;
+      }
       this.compareDelListOption = {
         subFormName: subFormName,
         columns:
@@ -2563,6 +2587,233 @@ modules = {
       };
       this.showCompareDelList = true;
     },
+    /**
+     * 「订单→变更单」对比场景的通用编排。业务侧在 getGlobalConfig 里一行接入：
+     *   return this.getFormRef().setupChangeCompare({ ...cfg });
+     * 返回的控制器方法直接作为按钮 onClick / 入口脚本调用（内部操作 form-render 自身，
+     * 无需再传 that）。把「按钮显隐联动、原单加载、预置字段、名单派生、提示语」全收进框架，
+     * 业务只需给一份 cfg。
+     *
+     * cfg 字段：
+     *   sourceIdField     变更单里存「原单ID」的字段（必填；自动纳入不覆盖+不对比）
+     *   presetFields      新建时预置的固定字段 { 字段: 值 }（可多个，自动纳入不覆盖+不对比）
+     *   compareRowKey     明细行匹配键。原单行(a)与变更行(b)按它配对。一个字段两用：
+     *                     全局键（对所有明细生效）：
+     *                       '字段'          两边同名：a[字段]===b[字段]
+     *                       { from, to }    两边字段名不同：a[from]===b[to]
+     *                       [ ... ]         多字段联合（元素可为字符串或 {from,to}），全部满足
+     *                     按明细 map（键为明细keyName、无 from/to 键时判定为此形态）：
+     *                       { 明细A: {from,to}, 明细B: 'f_uuid', ... } 每张明细各用各的键
+     *   excludeFields     表头「不对比」的额外字段名数组（与自动派生的合并去重）
+     *   defaultFields     表头「不覆盖」的额外字段名数组（保住新单自身值；与自动派生的合并去重）
+     *   subExcludeFields  明细「不对比」：{ 明细keyName: [字段名] }
+     *   subDefaultFields  明细「不覆盖取列默认值」：{ 明细keyName: [列prop] }
+     *   detailName        【单明细便捷】主明细表属性名(keyName)——openCompareDelList() 默认弹它
+     *   sourceItemIdField 【单明细便捷】该明细里回填「原明细ID」的字段（配合 detailName）
+     *   subSourceFields   【多明细/自定义】完整 { 明细keyName: 回填配置 }，与 detailName 派生的合并
+     *                     （多明细回填用它；openCompareDelList('明细keyName') 传表名弹指定明细）
+     *   compareBtnName / closeBtnName / delBtnNames  三个按钮的唯一名（delBtnNames 数组）
+     *   sourceFormCode    原单≠变更单模板时填原单 formCode
+     *   sourceLabel       原单业务称呼，用于提示语（默认「原单」）
+     *   autoLoadFromParam true=配置后顺带执行 loadSourceFromParam()（合二为一，一行接入；
+     *                     仅在 onMounted/入口脚本调用 setup 时用，勿在 getGlobalConfig 里开）
+     *   extraOptions      透传给 initChangeFromSource/enableCompareBySource 的额外 options（高级）
+     * 业务钩子（可选，this=form-render 实例）。加载前钩子按模式分开，各自独立、无需判 mode：
+     *   onBeforeLoadFromParam(sourceId)  模式A（变更跳转）加载前。在此命令式预置字段（如
+     *                            this.formModel.f_type=1）——比声明式 presetFields 更灵活；但被预置
+     *                            字段仍需在 defaultFields/excludeFields 声明「不覆盖/不对比」。
+     *   onBeforeLoadOnPick(sourceId)     模式B（搜索框选原单）加载前。
+     *   onLoaded(oldData, ctx)   原单加载完成后。ctx={ mode:'param'|'pick'|'compare', sourceId }
+     *   onCompareToggle(isCompare) 对比开/关后（加载即开、点关闭即关）
+     *   onClearSource()          搜索框清空触发 clearCompareSource 时（在此清掉已填数据）
+     */
+    setupChangeCompare: function (cfg) {
+      cfg = cfg || {};
+      let self = this;
+      let presetFields = cfg.presetFields || {};
+      let presetKeys = Object.keys(presetFields);
+      let uniq = function (arr) {
+        return arr.filter(function (v, i) {
+          return v && arr.indexOf(v) === i;
+        });
+      };
+      // 表头「不覆盖」= 原单ID + 预置字段（自动，保住新单自身值）+ 业务额外 defaultFields
+      // 表头「不对比」= 同上基础 + 业务额外 excludeFields
+      let baseNames = (cfg.sourceIdField ? [cfg.sourceIdField] : []).concat(
+        presetKeys
+      );
+      let defaultFields = uniq(baseNames.concat(cfg.defaultFields || []));
+      let excludeFields = uniq(baseNames.concat(cfg.excludeFields || []));
+      // 明细「原明细ID回填」：detailName+sourceItemIdField 是单明细便捷写法；
+      // 多明细直接给 cfg.subSourceFields（完整 { 明细keyName: 配置 } 形态），后者可覆盖前者。
+      let subSourceFields = {};
+      if (cfg.detailName && cfg.sourceItemIdField) {
+        subSourceFields[cfg.detailName] = function (row) {
+          row[cfg.sourceItemIdField] = row.id;
+        };
+      }
+      Object.assign(subSourceFields, cfg.subSourceFields || {});
+      // compareRowKey 一个字段两用：
+      //   全局键   'f_uuid' | {from,to} | [...]           → 底层 compareRowKey
+      //   按明细map { 明细keyName: 键, ... }（无 from/to键） → 底层 subRowKeys
+      // 判定：普通对象且不含 from/to 键 = 按明细 map；其余都是全局键。
+      let crk = cfg.compareRowKey;
+      let isDetailMap =
+        crk &&
+        typeof crk === "object" &&
+        !Array.isArray(crk) &&
+        crk.from === undefined &&
+        crk.to === undefined;
+      let buildOptions = function (extra) {
+        let o = {
+          excludeFields: excludeFields, // 表头不对比
+          defaultFields: defaultFields, // 表头不覆盖
+          subSourceFields: subSourceFields,
+        };
+        if (isDetailMap) {
+          o.subRowKeys = crk; // 按明细 map
+        } else if (crk != null) {
+          o.compareRowKey = crk; // 全局键
+        }
+        // 明细的不对比 / 不覆盖：按「明细keyName」分组，原样透传
+        if (cfg.subExcludeFields) o.subExcludeFields = cfg.subExcludeFields;
+        if (cfg.subDefaultFields) o.subDefaultFields = cfg.subDefaultFields;
+        if (cfg.sourceFormCode) o.sourceFormCode = cfg.sourceFormCode;
+        Object.assign(o, cfg.extraOptions || {});
+        return Object.assign(o, extra || {});
+      };
+      let toggle = function (isCompare) {
+        let hide = function (name, hidden) {
+          if (!name) return;
+          let w = self.getWidgetRef(name);
+          if (w && typeof w.setHidden === "function") w.setHidden(hidden);
+        };
+        hide(cfg.compareBtnName, isCompare); // 对比中→隐藏「对比」
+        hide(cfg.closeBtnName, !isCompare); // 对比中→放出「关闭对比」
+        (cfg.delBtnNames || []).forEach(function (n) {
+          hide(n, !isCompare); // 对比中→放出「查看删除明细」
+        });
+      };
+      // 触发业务钩子：this=form-render 实例，业务钩子里可直接用 form 能力
+      let fire = function (name) {
+        let fn = cfg[name];
+        if (typeof fn !== "function") return;
+        return fn.apply(self, Array.prototype.slice.call(arguments, 1));
+      };
+      // initChangeFromSource/enableCompareBySource 返回 Promise（原单数据）；兼容非 Promise
+      let after = function (ret, cb) {
+        if (ret && typeof ret.then === "function") {
+          return ret.then(function (oldData) {
+            cb(oldData);
+            return oldData;
+          });
+        }
+        cb(ret);
+        return ret;
+      };
+      let controller = {
+        // 模式A：变更跳转，原单ID 来自路由参数，新建页自动加载并开启对比
+        loadSourceFromParam: function () {
+          if (self.dataId) return; // 编辑态跳过
+          let p = self.getFormParam();
+          let sourceId = p && p.sourceId != null && p.sourceId !== ""
+            ? p.sourceId
+            : null;
+          if (sourceId == null) return;
+          self.$set(self.formDataModel, cfg.sourceIdField, sourceId);
+          presetKeys.forEach(function (k) {
+            self.$set(self.formDataModel, k, presetFields[k]);
+          });
+          // 模式A 加载前钩子：业务在此预置字段（如 f_type=1）。被预置字段的“不覆盖/不对比”
+          // 仍需在 defaultFields/excludeFields 声明，否则会被原单值覆盖或误判为变更。
+          fire("onBeforeLoadFromParam", sourceId);
+          let ret = self.initChangeFromSource(sourceId, buildOptions());
+          toggle(true);
+          fire("onCompareToggle", true);
+          return after(ret, function (oldData) {
+            fire("onLoaded", oldData, { mode: "param", sourceId: sourceId });
+          });
+        },
+        // 模式B变体：搜索框选原单，只加载不对比
+        loadSourceOnPick: function (sourceId) {
+          if (sourceId == null || sourceId === "") return;
+          // 模式B 加载前钩子（与模式A 分开，各自独立处理，不用判 mode）
+          fire("onBeforeLoadOnPick", sourceId);
+          let ret = self.initChangeFromSource(sourceId, buildOptions({ compare: false }));
+          toggle(false);
+          return after(ret, function (oldData) {
+            fire("onLoaded", oldData, { mode: "pick", sourceId: sourceId });
+          });
+        },
+        // 点「对比」：重拉原单作基准并开启对比
+        enableCompareBySource: function () {
+          let sourceId = self.formDataModel[cfg.sourceIdField];
+          if (sourceId == null || sourceId === "") {
+            if (self.$message) {
+              self.$message.error("请先选择" + (cfg.sourceLabel || "原单"));
+            }
+            return;
+          }
+          let ret = self.enableCompareBySource(sourceId, buildOptions());
+          toggle(true);
+          fire("onCompareToggle", true);
+          return after(ret, function (oldData) {
+            fire("onLoaded", oldData, { mode: "compare", sourceId: sourceId });
+          });
+        },
+        // 关闭对比（self.disableCompare 内部已联动按钮 + 触发 onCompareToggle）
+        disableCompare: function () {
+          self.disableCompare();
+        },
+        // 搜索框清空 → 关闭对比 + 触发清理钩子（业务可在此清掉已填数据）
+        clearCompareSource: function () {
+          self.disableCompare();
+          fire("onClearSource");
+        },
+        // 「查看删除明细」按钮：不传取 cfg.detailName（单明细）；多明细各按钮传各自表名
+        openCompareDelList: function (detailName) {
+          self.openCompareDelList(detailName || cfg.detailName);
+        },
+        // 需要时手动联动按钮显隐
+        toggleButtons: toggle,
+      };
+      // 缓存到实例：供 getChangeCompare()、以及 form-render 同名方法「控制器感知」用
+      this._compareToggle = toggle;
+      this._compareFire = fire;
+      this._compareDetailName = cfg.detailName;
+      this.changeCompareCtl = controller;
+      // autoLoadFromParam=true：配置后顺带执行模式A加载（内部 if(dataId)return 自守卫，编辑态跳过）。
+      // 注意：仅当 setup 放在 onMounted/入口脚本（formModel/路由参数已就绪）时用；放 getGlobalConfig
+      // （表单初始化即执行）里不要开，否则加载时机过早。
+      if (cfg.autoLoadFromParam) controller.loadSourceFromParam();
+      return controller;
+    },
+    /**
+     * 已配置的对比控制器（setupChangeCompare 缓存的）。配置后，控制器的方法可**直接**在
+     * form-render 上调用（无需经 getGlobalConfig / getChangeCompare）：
+     *   enableCompareBySource() / disableCompare() / openCompareDelList()  —— 同名方法已「控制器感知」
+     *   loadSourceFromParam() / loadSourceOnPick(id) / clearCompareSource() —— 下面的代理
+     * 即 onClick 写 this.getFormRef().enableCompareBySource() 即可。
+     */
+    getChangeCompare: function () {
+      return this.changeCompareCtl || null;
+    },
+    // 以下三个是控制器新名方法在 form-render 上的代理（未配置控制器时返回 undefined）
+    loadSourceFromParam: function () {
+      return this.changeCompareCtl
+        ? this.changeCompareCtl.loadSourceFromParam()
+        : undefined;
+    },
+    loadSourceOnPick: function (sourceId) {
+      return this.changeCompareCtl
+        ? this.changeCompareCtl.loadSourceOnPick(sourceId)
+        : undefined;
+    },
+    clearCompareSource: function () {
+      return this.changeCompareCtl
+        ? this.changeCompareCtl.clearCompareSource()
+        : undefined;
+    },
     /**
      * 枚举需要独立发包获取的子表（data-table 容器）。sub-form/table2 的数组随主表
      * objx 一并返回，无需单独发包。返回 [{ name, scriptCode }]。
@@ -2889,6 +3140,11 @@ modules = {
      * @returns {Promise<Object>} 归一化后的旧数据（对比基准）
      */
     enableCompareBySource: function (sourceId, options) {
+      // 无参 + 已配置控制器 → 走控制器（读 cfg.sourceIdField、联动按钮、触发钩子）。
+      // 控制器内部再调本方法时会带真实 sourceId，走下面的底层分支，不会递归。
+      if ((sourceId == null || sourceId === "") && this.changeCompareCtl) {
+        return this.changeCompareCtl.enableCompareBySource();
+      }
       options = options || {};
       return this.loadOldData(sourceId, options).then((srcData) => {
         let oldData = this.applyCompareSourceTransform(srcData, options);