cloud-web-corejs 1.1.0-dev.13 → 1.1.0-dev.15

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "cloud-web-corejs",
   "private": false,
-  "version": "1.1.0-dev.13",
+  "version": "1.1.0-dev.15",
   "scripts": {
     "dev": "vue-cli-service serve",
     "dev:micro": "vue-cli-service serve --port 17527",

package/src/components/excelExport/mixins.js

@@ -82,6 +82,8 @@ function getGrid(that, tableRef) {
         CURRENT_PREFIX: "",
         option: {},
         uuid: "",
+        // createExcelTemplate 返回的本次导出时间快照，随每页取数请求下发（见 loopToDo）
+        nowDate: null,
         fileRows: [],
         title: this.$t2("导出", "components.excelExport.title"),
         tableTarget: null,
@@ -609,7 +611,17 @@ function getGrid(that, tableRef) {
           // 取消后不再发起新页，也不再重试（重试是从 .catch 里递归回来的）
           if (that.isExportStopped()) return;
           let maxWaitNum = limitThreadNum;
-          let nowDate = options.nowDate;
+          // 分页取数的时间快照：createExcelTemplate 返回后存在 this.nowDate（见
+          // startProcess），此前这里读的是 options.nowDate —— 那是调用方入参，全库
+          // 没有任何调用方维护它，于是每页请求的 nowDate 恒为 undefined、被
+          // JSON.stringify 丢掉，后端拿不到快照点。导出期间数据发生增删时，分页会
+          // 整体前后错位，合出来的文件既漏行又重行，且全程不报错。
+          // 仍保留 options.nowDate 兜底：服务端未返回快照时，调用方若显式指定了一个，
+          // 用它总好过不带。
+          // 两条取数通道都要带：通用表格随请求体平铺下发；xform 走 exportAjax，快照
+          // 顺 aParam 进去后由 data-table-mixin.loadDefaultQueryList 提到信封层（与
+          // formCode 同级），不能留在内层 data —— 那是业务查询条件的地盘。
+          let nowDate = that.nowDate ?? options.nowDate;
           if (flag === 1) {
             /*if (num > that.tTotalPage) {
               let size = page.records.length;

package/src/components/xform/docs/2026-09 /347/274/226/350/276/221/350/241/250/350/241/214/345/206/205/344/277/235/345/255/230/346/240/241/351/252/214/350/214/203/345/233/264/344/270/216/345/210/227/345/277/205/345/241/253/350/247/243/346/236/220/344/277/256/345/244/215.md"

@@ -0,0 +1,233 @@
+# 编辑表行内保存的校验范围 & 列必填解析 —— 修复文档（2026-09-03）
+
+> 状态：**两项均已编码 + 单测过，待联调**。
+> 改动文件：`src/components/xform/form-render/container-item/data-table-mixin.js`、
+> `src/components/xform/utils/tableColumnHelper.js`。
+> 新增单测：`tests/unit/components/xform/editRowValidateScope.spec.js`（6 条）、
+> `tests/unit/components/xform/columnRequiredFlag.spec.js`（7 条）。
+> 行号均为 2026-09-03 工作区快照，后续会漂移，以函数名为准。
+> 同步：dev 与 stdxx 两分支均**未搬**。
+
+---
+
+## 一、两个问题
+
+| # | 现象 | 根因一句话 |
+|---|------|-----------|
+| A | 编辑（树）表点行内保存 ✓，别的行缺必填、甚至表格外的字段没填，都会把这一行的保存拦住 | `saveEditRow` 走的是整表 + 全表单的 `formRef.validate` |
+| B | 某列 `required` 与 `editWidget.options.required` 都是 `false`，运行起来却必填（表头星号 + 拦保存） | 列在设计器里配过展示组件后又改回空，残留的 `columnOption.required` 仍被 `resolveColumnRequiredFlag` 无条件读取 |
+
+两者独立，但都落在"必填校验"这条线上，一起记。
+
+---
+
+## 二、问题 A：行内保存跑了全表校验
+
+### 2.1 原链路
+
+```
+data-table-item.vue  #editTreeButtonGroup 插槽的「保存」a-link
+  → saveEditRow(obj)                                   [data-table-mixin.js:4469]
+      → formRef.validate(resolve)                      ← 整表 + 表外字段
+          → el-form.$baseValidate                      原生规则（只覆盖已渲染的 form-item）
+          → runExtraFormValidations()                  [indexMixin.js:3862]
+              ├─ validateArrayValueFieldsRequired()    全表单数组类值字段
+              ├─ validateDataTableCellsRequired()      **每个数据表格逐行**必填
+              └─ validateDataTableDatasetRequired()    数据表整体必填
+      → $baseConfirm → clearActived/setActiveRow → formHttp（只发当前行）
+```
+
+保存粒度是**行**（`requestRow = obj.row`，报文里只有这一行），校验粒度却是**整表单**。
+
+### 2.2 改动
+
+`validateCellsRequired` 抽出核心循环，让"校验哪些行"与"prop 里的行下标"分离：
+
+```js
+// data-table-mixin.js:1045
+validateCellsRequired() {
+  ...
+  return this.runCellsRequiredCheck(rows, rows);   // 整体保存：全表逐行
+},
+// data-table-mixin.js:1063
+runCellsRequiredCheck(targetRows, indexRows) { ... }
+```
+
+- `targetRows` —— 本次要校验的行；
+- `indexRows` —— 求行下标用的**完整数据集**。
+  单行校验时**必须**传全量数据集，否则 `getValidationRowIndex` 拿到的是 0，
+  拼出来的 `items.0.f_code` 会定位到错误的行。
+
+新增三个方法：
+
+| 方法 | 位置 | 职责 |
+|------|------|------|
+| `validateEditRowRequired(row)` | `data-table-mixin.js:1130` | 只对该行跑必填（内部 `runCellsRequiredCheck([row], 全量)`） |
+| `collectRowValidateProps(row)` | `data-table-mixin.js:1141` | 收该行的单元格 prop，按真实行下标拼，并**按 `renderForm.fields` 过滤掉未注册的** |
+| `validateEditRow(row)` | `data-table-mixin.js:1184` | 入口：原生规则 → 必填兜底，任一失败弹消息返回 false |
+
+`saveEditRow` 的第一步随之改为：
+
+```js
+// 行内保存只提交当前行，校验范围同步收敛到当前行：其他行与表外字段
+// 的必填不该拦住单行保存（整体保存仍走 formRef.validate 的全量校验）
+if (!this.validateEditRow(obj.row)) return false;
+```
+
+### 2.3 行为对照
+
+| 通道 | 原生规则（正则 / 自定义 validator） | 必填 |
+|------|--------------------------------|------|
+| 整体保存（`formRef.validate`） | 全表单已渲染的 form-item | 全表逐行 + 数据集必填 + 数组类字段 |
+| 行内保存（`validateEditRow`） | **仅当前行**已注册的 prop | **仅当前行** |
+
+### 2.4 两个坑（已在实现里处理）
+
+1. **prop 必须先按 `renderForm.fields` 过滤**。element 的 `validateField(props, cb)` 在传入的 prop
+   一个都没注册时会打 `[Element Warn] please pass correct props!`。编辑表用的是
+   vxe `editConfig: { trigger: "manual", mode: "row" }`，`edit` 插槽只在**正在编辑的那一行**渲染，
+   未编辑行的 prop 本就不在 `fields` 里。
+2. **`getValidationRows` 读的是 computed `fieldKeyName`**，不是 `getFieldKeyName(this.widget)`。
+   写单测造上下文时必须直给 `fieldKeyName`，否则会掉进 `$grid.getTableData()` 兜底分支。
+
+---
+
+## 三、问题 B：残留 `columnOption` 让列凭空必填
+
+### 3.1 判据
+
+问题列的模板 JSON（节选）：
+
+| 位置 | 值 |
+|------|-----|
+| 列级 `required` | `false` |
+| `formatS` / `widget` | `""` / `null` ← 展示组件已改回空 |
+| `editFormatS` / `editWidget.options.required` | `"editInput"` / `false` |
+| **`columnOption.required`** | **`true`** ← 残留快照 |
+
+### 3.2 根因：两条读取路径口径不一致
+
+| 路径 | 读什么 | 结果 |
+|------|--------|------|
+| 加载时 `applyColumnMetaToFieldWidget`（`util.js:919`，由 `handleTableColumnWidget`（`indexMixin.js:674`）调用） | **只读对应侧**：编辑侧读 `editWidgetOptions ?? editColumnOption` | `editWidget.options.required` = `false` ✅ |
+| 运行时 `resolveColumnRequiredFlag`（`tableColumnHelper.js:90`） | 改动前**两侧都读、且不看 `formatS`**：`widgetOptions ?? columnOption` | `true` ❌ |
+
+该 flag 有**两个出口**，所以现象是"星号 + 拦保存"一起来：
+
+- `applyColumnLabelIcon`（`tableColumnHelper.js:126`）→ 表头画 `vxe-cell--required-icon`；
+- `isCellFieldRequired`（`tableCellValidateUtil.js:52`）→ 组件自身 `required` 为 false 时**落到**该 flag → 进必填校验。
+
+### 3.3 改动
+
+新增两个内部函数，给静态列的列级 option 加门控：
+
+```js
+// tableColumnHelper.js:12
+function hasColumnWidgetSide(columnConfig, isEdit) {
+  if (isEdit) {
+    return !!(columnConfig.editWidget || columnFormatMap[columnConfig.editFormatS]);
+  }
+  return !!(columnConfig.widget || columnFormatMap[columnConfig.formatS]);
+}
+// tableColumnHelper.js:32
+function getEffectiveColumnOptions(columnConfig, isEdit) { ... }
+```
+
+`resolveColumnRequiredFlag` 的兜底改为：
+
+```js
+const widgetOptions = getEffectiveColumnOptions(columnConfig, false);
+const editWidgetOptions = getEffectiveColumnOptions(columnConfig, true);
+return !!(widgetOptions?.required || editWidgetOptions?.required);
+```
+
+口径：
+
+- **动态列**的 `widgetOptions` / `editWidgetOptions` 直接生效（它们本就没有 `formatS`，不门控）；
+- **设计器静态列**的 `columnOption` / `editColumnOption` 只在该侧
+  `columnFormatMap[formatS]` 能映射出组件类型（或 widget 已实例化）时才读。
+
+**门控判据必须用 `columnFormatMap`，不能用"`formatS` 非空"** —— 纯格式化列（`formatS: "d1"` 这类格式码）
+同样不建 widget，那份残留 option 也不该作数；用 `columnFormatMap` 才与加载时的实例化口径完全一致。
+
+### 3.4 排除项：展示态不会被误渲染成组件
+
+展示侧组件的实例化在三条路径上都以 `columnFormatMap[formatS]` 为门：
+
+| 路径 | 位置 |
+|------|------|
+| 运行态 | `form-render/indexMixin.js:690` |
+| 设计器 | `form-designer/form-widget/container-widget/data-table-mixin.js:220` |
+| H5 列表 | `form-render/container-item/list-h5-item.vue:1692` |
+
+`formatS` 为空 → widget 保持 null → `createColumn` 的展示插槽 if 链（`data-table-mixin.js:2158`）
+一条都不命中 → 单元格走 `formatter: formatterValue` 纯文本。
+`addColumProperty`（`data-table-mixin.js:2011`）展开的 `columnOption` 取自 **widget 实例**的 options，
+不是 JSON 里那份残留。
+
+所以残留 `columnOption` 在改动前唯一漏出来的地方就是 `resolveColumnRequiredFlag` ——
+全仓读 `columnOption` 的点里只有它不看 `formatS`。
+
+### 3.5 老数据不做清理
+
+渲染路径对这类残留**只有补齐、没有校验、也没有清理**：`handleTableColumnWidget` 是单向的
+（`formatS` 映射得出组件才建 widget），不会比对"widget 不存在但 columnOption 还在"，
+全仓也没有任何删除 `columnOption` 的写法；设计器侧 `cloneTableColumnsForEdit`
+（`table-column-dialog.vue:1107`）还会在 `!row.widget` 时把它深拷贝带进编辑态再写回模板。
+
+结论：**DB 里的残留不必清** —— 代码侧已经兜住，清理反而要动存量模板。
+若要早发现，最轻的一档是在 `handleTableColumnWidget` 里对
+"该侧无组件却带着 columnOption"仅开发环境 `console.warn`（未实施）。
+
+---
+
+## 四、改动清单
+
+| 文件 | 改动 |
+|------|------|
+| `form-render/container-item/data-table-mixin.js` | `validateCellsRequired` 抽出 `runCellsRequiredCheck(targetRows, indexRows)`；新增 `validateEditRowRequired` / `collectRowValidateProps` / `validateEditRow`；`saveEditRow` 首步由 `formRef.validate` 换成 `validateEditRow(obj.row)` |
+| `utils/tableColumnHelper.js` | 新增 `hasColumnWidgetSide` / `getEffectiveColumnOptions`（并 `import { columnFormatMap } from "./util"`）；`resolveColumnRequiredFlag` 兜底改走门控 |
+| `tests/unit/components/xform/editRowValidateScope.spec.js` | 新增，6 条 |
+| `tests/unit/components/xform/columnRequiredFlag.spec.js` | 新增，7 条 |
+
+未改动、行为保持不变：`validateForm` / `validate` / `runExtraFormValidations` 三个整体保存入口，
+`validateCheckRow`（勾选行操作的行级校验），H5 列表的必填口径（只读列级 `t.required`）。
+
+---
+
+## 五、验证
+
+- `npx jest tests/unit/components/xform` —— 28 套全过（含两个新增 spec）。
+- `npx jest tests/unit/components` —— 49 套 712 条，711 通过；唯一失败
+  `mobile/h5PopDialog.spec.js`（`selectUserDialog.vue` 缺 `custom-class="h5-pop-dialog"`）
+  属 H5 wf 弹层那条线的既有状态，**与本次改动无关**。
+- eslint：`data-table-mixin.js` 无新增报错（51 条 operator-linebreak 均为既有欠账，
+  行号不落在新增段）；`tableColumnHelper.js` 由 4 条降至 2 条。
+
+单测覆盖点：
+
+| spec | 覆盖 |
+|------|------|
+| editRowValidateScope | 整体保存仍全表拦 / 别的行缺必填不拦当前行 / 当前行自己缺必填仍拦 / prop 带真实行下标且只发当前行 / 未注册 prop 不下发 / 原生错优先于必填兜底 |
+| columnRequiredFlag | 残留 columnOption 不再必填 / 老数据（formatS 有值、widget 未实例化）仍必填 / 纯格式化列不读 / editColumnOption 按 editFormatS 门控 / 动态列不受门控 / 列级与实例 required 照旧 / 空配置 |
+
+---
+
+## 六、影响面与联调点
+
+| 变更 | 影响面 | 联调重点 |
+|------|--------|----------|
+| A | 仅编辑树表的 `editTreeButtonGroup` 行内保存 | 当前行必填仍拦、错误能定位到该行；他行/表外字段缺失不再误拦；原生正则规则在当前行仍生效 |
+| B | 全量表格的必填标记（表头星号）与单元格必填校验 | 抽查若干正常配置的必填列，星号与校验都还在；问题列星号消失、不再拦保存 |
+
+B 的潜在风险：若有表单**依赖**这份残留 `columnOption.required` 来实现必填（即列级和组件级都没配、
+全靠残留生效），改后会变成非必填。属于"配置本就不合规"的情况，联调时留意用户反馈的
+"某列突然不必填了"，正解是去列配置或组件上把 required 补回。
+
+---
+
+## 七、待办
+
+1. 真机联调（两项均未联调）。
+2. **同步 dev 与 stdxx 两分支**（按既有同步规则：JS 可整体覆盖、样式不覆盖）。
+3. 可选：`handleTableColumnWidget` 的 dev-only `console.warn`（残留列级 option 早发现），未实施。

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

@@ -1052,6 +1052,16 @@ modules = {
         return null;
       }
 
+      return this.runCellsRequiredCheck(rows, rows);
+    },
+    /**
+     * 逐单元格必填校验的核心循环。
+     * @param {Array} targetRows 本次要校验的行。
+     * @param {Array} indexRows 求行下标用的完整数据集（决定校验 prop 里的行下标）。
+     * @returns {String|null} 首个错误提示，全部通过返回 null。
+     */
+    runCellsRequiredCheck(targetRows, indexRows) {
+      const rows = indexRows || [];
       const isEditTable = this.widget.options.isEditTable || false;
       const tableColumns = this.widget.options.tableColumns || [];
       const tableFieldKeyName = this.getFieldKeyName(this.widget);
@@ -1061,8 +1071,8 @@ modules = {
         this.collectColumnValidateEntries(column, isEditTable, columnEntries);
       });
 
-      for (let rowIndex = 0; rowIndex < rows.length; rowIndex++) {
-        const row = rows[rowIndex];
+      for (let rowIndex = 0; rowIndex < targetRows.length; rowIndex++) {
+        const row = targetRows[rowIndex];
         if (!row) {
           continue;
         }
@@ -1113,6 +1123,87 @@ modules = {
 
       return null;
     },
+    /**
+     * 行内保存用：只校验当前行的必填，不牵动其他行。
+     * @param {Object} row 当前行。@returns {String|null} 错误提示，通过为 null。
+     */
+    validateEditRowRequired(row) {
+      if (!row || this.widget.options.hidden || this.designState) {
+        return null;
+      }
+      const rows = this.getValidationRows();
+      return this.runCellsRequiredCheck([row], rows.length ? rows : [row]);
+    },
+    /**
+     * 收集当前行所有参与校验的单元格 prop（用于原生规则的行级校验）。
+     * @param {Object} row 当前行。@returns {Array<String>} 已在表单里注册的 prop 列表。
+     */
+    collectRowValidateProps(row) {
+      const formRef = this.getFormRef?.();
+      const renderForm = formRef?.$refs?.renderForm;
+      if (!row || !renderForm) {
+        return [];
+      }
+      const isEditTable = this.widget.options.isEditTable || false;
+      const tableColumns = this.widget.options.tableColumns || [];
+      const tableFieldKeyName = this.getFieldKeyName(this.widget);
+      const rows = this.getValidationRows();
+      const rowIndex = this.getValidationRowIndex(row, rows, 0);
+      const columnEntries = [];
+      this.loodHandleColumns(tableColumns, (column) => {
+        this.collectColumnValidateEntries(column, isEditTable, columnEntries);
+      });
+
+      // 只保留真正注册进 el-form 的 prop：validateField 传入全部未注册的 prop 会打警告
+      const registered = new Set(
+        (renderForm.fields || []).map((item) => item.prop)
+      );
+      const props = [];
+      columnEntries.forEach(({ column, templateWidget }) => {
+        const fieldWidget = this.resolveRowFieldWidget(row, templateWidget);
+        if (shouldSkipCellValidation(fieldWidget)) {
+          return;
+        }
+        const property = getCellFieldKey(fieldWidget, column);
+        const propName = buildTableCellFormProp(
+          tableFieldKeyName,
+          rowIndex,
+          property
+        );
+        if (propName && registered.has(propName) && !props.includes(propName)) {
+          props.push(propName);
+        }
+      });
+      return props;
+    },
+    /**
+     * 行内保存的校验入口：范围收敛到当前行（原生规则 + 必填兜底），
+     * 不校验其他行、也不校验表格外的表单字段。
+     * @param {Object} row 当前行。@returns {Boolean} 通过为 true。
+     */
+    validateEditRow(row) {
+      const formRef = this.getFormRef?.();
+      const renderForm = formRef?.$refs?.renderForm;
+      const props = this.collectRowValidateProps(row);
+      let nativeError = null;
+      if (renderForm && props.length) {
+        renderForm.validateField(props, (errorMsg) => {
+          if (!nativeError && errorMsg) {
+            nativeError = errorMsg;
+          }
+        });
+      }
+      if (nativeError) {
+        this.$message.error(nativeError);
+        return false;
+      }
+      const requiredError = this.validateEditRowRequired(row);
+      if (requiredError) {
+        this.$message.error(requiredError);
+        return false;
+      }
+      return true;
+    },
     /** @param {Boolean} required 是否将整个数据表设为必填。 */
     setRequired(required) {
       this.$set(this.widget.options, "required", !!required);
@@ -3366,6 +3457,16 @@ modules = {
       };
       requestData = extendDeeply(requestData, accessParam);
 
+      // 导出时间快照按 xform 协议放在**信封层**（与 formCode/taBm 同级），不能留在
+      // data 里 —— 那一层是业务查询条件的地盘，后端按字段名当条件解析。它由
+      // excelExport 的分页调度器塞进取数参数（mixins.js loopToDo 的 aParam），一路
+      // 并进 requestData，到这里统一提上来。只有导出通道会带它。
+      let nowDate;
+      if (customParam?.export && requestData.nowDate !== undefined) {
+        nowDate = requestData.nowDate;
+        delete requestData.nowDate;
+      }
+
       return this.formHttp({
         // url: prefix + "/form_ins/getPage",
         scriptCode: scriptCode,
@@ -3373,6 +3474,7 @@ modules = {
           formCode: formCode,
           formVersion: reportTemplate.formVersion,
           taBm: this.fieldKeyName,
+          ...(nowDate !== undefined ? { nowDate } : {}),
           data: requestData,
         },
         isLoading: false,
@@ -4418,14 +4520,9 @@ modules = {
       let logicalRowKey = obj.row?._X_ROW_KEY || null;
       let originalPhysicalId = null;
       try {
-        let valid = await new Promise((resolve, reject) => {
-          try {
-            formRef.validate(resolve);
-          } catch (error) {
-            reject(error);
-          }
-        });
-        if (!valid) return false;
+        // 行内保存只提交当前行，校验范围同步收敛到当前行：其他行与表外字段
+        // 的必填不该拦住单行保存（整体保存仍走 formRef.validate 的全量校验）
+        if (!this.validateEditRow(obj.row)) return false;
 
         let requestRow = obj.row;
         if (treeContext) {

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

@@ -1,3 +1,47 @@
+import { columnFormatMap } from "./util";
+
+/**
+ * 列的某一侧（展示 / 编辑）是否真的配了组件。
+ *
+ * 判据与表单加载时的实例化口径一致（见 form-render/indexMixin 的 columnLoopDo）：
+ * 只有 formatS / editFormatS 能映射出组件类型时该侧才会建 widget。纯格式化列
+ * （formatS 是 d1 这类格式码）与被改回空的列都不算。
+ * @param {Object} columnConfig 列配置。@param {Boolean} isEdit 是否编辑侧。
+ * @returns {Boolean}
+ */
+function hasColumnWidgetSide(columnConfig, isEdit) {
+  if (isEdit) {
+    return !!(
+      columnConfig.editWidget || columnFormatMap[columnConfig.editFormatS]
+    );
+  }
+  return !!(columnConfig.widget || columnFormatMap[columnConfig.formatS]);
+}
+
+/**
+ * 取该侧生效的列级组件配置。
+ *
+ * 动态列走 widgetOptions / editWidgetOptions（本来就没有 formatS），直接生效；
+ * 设计器静态列的 columnOption / editColumnOption 必须门控：展示组件被改回空
+ * 之后那份 columnOption 仍会留在模板 JSON 里，无条件读会让这列凭空变必填
+ * （表头星号 + 拦保存），而加载时的 applyColumnMetaToFieldWidget 只读对应侧，
+ * 两边口径不一致正是该现象的根因。
+ * @param {Object} columnConfig 列配置。@param {Boolean} isEdit 是否编辑侧。
+ * @returns {Object|null}
+ */
+function getEffectiveColumnOptions(columnConfig, isEdit) {
+  const dynamicOptions = isEdit
+    ? columnConfig.editWidgetOptions
+    : columnConfig.widgetOptions;
+  if (dynamicOptions) {
+    return dynamicOptions;
+  }
+  if (!hasColumnWidgetSide(columnConfig, isEdit)) {
+    return null;
+  }
+  return isEdit ? columnConfig.editColumnOption : columnConfig.columnOption;
+}
+
 function buildColumnConfigMap(tableColumns, map = {}) {
   if (!tableColumns || !tableColumns.length) {
     return map;
@@ -56,10 +100,8 @@ export function resolveColumnRequiredFlag(columnConfig) {
   if (columnConfig.widget?.options?.required) {
     return true;
   }
-  const widgetOptions =
-    columnConfig.widgetOptions ?? columnConfig.columnOption;
-  const editWidgetOptions =
-    columnConfig.editWidgetOptions ?? columnConfig.editColumnOption;
+  const widgetOptions = getEffectiveColumnOptions(columnConfig, false);
+  const editWidgetOptions = getEffectiveColumnOptions(columnConfig, true);
   return !!(widgetOptions?.required || editWidgetOptions?.required);
 }