cloud-web-corejs 1.0.281 → 1.0.283

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-designer/form-widget/dialog/importDialogMixin.js

@@ -8,6 +8,14 @@ let XLSX = window.XLSX || { read, utils };
 import { getToken } from "../../../../../utils/auth";
 import XEUtils from "xe-utils";
 import { getErrorMsg } from "@base/utils/index.js";
+import {
+  getImportCellText,
+  getImportFileSizeLimit,
+  getImportRowLimit,
+  isImportFileOversize,
+  isImportRowsOverLimit,
+  toFileSizeMb,
+} from "../../../../../utils/importLimit";
 
 let configUtil = {
   baseUrl: process.env.VUE_APP_BASE_API,
@@ -372,6 +380,25 @@ tmixins = {
       let that = this;
       let option = this.option;
 
+      // 业务侧的 importFileLimitSize 允许到 200MB，而这里是整文件 readAsBinaryString +
+      // XLSX.read 同步解析，占用约为文件体积的 5~20 倍 —— 那个量级必然把标签页撑爆，
+      // 且崩在库内部，连提示都给不出来。这里再收一道解析安全上限，可用
+      // importOption.maxFileSize 覆盖（0 表示不限制）。
+      if (isImportFileOversize(file, option)) {
+        this.$baseAlert(
+          this.$t1(
+            "导入文件过大（{size}MB），当前最多支持 {limit}MB，请拆分后分批导入",
+            {
+              size: toFileSizeMb(file.size),
+              limit: toFileSizeMb(getImportFileSizeLimit(option)),
+            }
+          )
+        );
+        // 与上游那道 importFileLimitSize 校验保持一致：只提示、不关弹窗，
+        // 用户可以直接重选一个小文件。
+        return false;
+      }
+
       if (option.importOption.multipleSheet) {
         this.readExcel2(file, callback);
         return;
@@ -403,6 +430,22 @@ tmixins = {
           let range = configUtil.XLSX.utils.decode_range(sheet["!ref"]);
           let dataSize = range.e.r + 1; //行数
           that.dataSize = dataSize - 3 >= 0 ? dataSize - 3 : 0;
+          // 行数闸门：下面逐格取值、建行对象、再整批发包全是同步的，行数失控时主线程会被
+          // 占死甚至 OOM。文件体积不大但行极多（窄表）时只有这一道能拦。
+          if (isImportRowsOverLimit(that.dataSize, option)) {
+            that.clearImportTimer();
+            that.$baseAlert(
+              that.$t1(
+                "导入数据 {size} 行，超过单次上限 {limit} 行，请拆分后分批导入",
+                {
+                  size: that.dataSize,
+                  limit: getImportRowLimit(option),
+                }
+              )
+            );
+            that.handleClose2();
+            return false;
+          }
           let titles = [];
           let fields = [];
 
@@ -428,7 +471,7 @@ tmixins = {
               if (typeof nextCell === "undefined") {
                 row.push(void 0);
               } else {
-                row.push(nextCell.w.trim());
+                row.push(getImportCellText(nextCell));
               }
             }
             if (rowNum === 1) {
@@ -1483,6 +1526,22 @@ tmixins = {
             let range = configUtil.XLSX.utils.decode_range(sheet["!ref"]);
             let dataSize = range.e.r + 1; //行数
             that.dataSize = dataSize - 3 >= 0 ? dataSize - 3 : 0;
+            // 行数闸门：下面逐格取值、建行对象、再整批发包全是同步的，行数失控时主线程会被
+            // 占死甚至 OOM。文件体积不大但行极多（窄表）时只有这一道能拦。
+            if (isImportRowsOverLimit(that.dataSize, option)) {
+              that.clearImportTimer();
+              that.$baseAlert(
+                that.$t1(
+                  "导入数据 {size} 行，超过单次上限 {limit} 行，请拆分后分批导入",
+                  {
+                    size: that.dataSize,
+                    limit: getImportRowLimit(option),
+                  }
+                )
+              );
+              that.handleClose2();
+              return false;
+            }
             let titles = [];
             let fields = [];
 
@@ -1508,7 +1567,7 @@ tmixins = {
                 if (typeof nextCell === "undefined") {
                   row.push(void 0);
                 } else {
-                  row.push(nextCell.w.trim());
+                  row.push(getImportCellText(nextCell));
                 }
               }
               if (rowNum === 1) {

package/src/components/xform/form-designer/form-widget/field-widget/select-export-item-button-widget.vue

@@ -103,6 +103,15 @@ export default {
         targetRef: this.field.options.tableRef || null,
         pageSize: this.field.options.exportPageSize || null,
         showImageAtTable: this.field.options.showImageAtTable || null,
+        // 明细导出的列 / 脚本编码 / 取数参数三项各自独立：按钮上维护了哪项就以哪项为准，
+        // 留空的那项沿用数据表格属性上那套。参数脚本原样下发，由数据表格求值（this 是
+        // 表格组件，与配在表格属性上时同义）
+        exportItemColumns: this.field.options.exportItemColumns || null,
+        exportItemScriptCode: this.field.options.exportItemScriptCode || null,
+        exportItemParam: this.field.options.exportItemParam || null,
+        // 字段勾选记忆按按钮分组存放，组件名是唯一且稳定的分组标识（见 exportColumnMemory.js）。
+        // 同一张表挂多个明细导出按钮时，各按钮的勾选互不覆盖。
+        exportButtonName: this.field.options.name || null,
       };
       let tableExportParam = this.handleCustomEvent(this.field.options.tableExportParam);
       let options = { ...opt, ...tableExportParam, type: type };

package/src/components/xform/form-designer/setting-panel/property-editor/container-data-table/exportItemColumns-dialog.vue

@@ -353,7 +353,13 @@ export default {
           return;
         }
       }
-      this.optionModel.exportItemColumns = this.$baseLodash.cloneDeep(this.tableData);
+      // 用 $set：导出按钮是后加的宿主，历史表单 JSON 里没有 exportItemColumns 这个键，
+      // 直接赋值不会触发「已维护」文案更新
+      this.$set(
+        this.optionModel,
+        "exportItemColumns",
+        this.$baseLodash.cloneDeep(this.tableData)
+      );
       this.closeHandle();
     },
     generateRow() {

package/src/components/xform/form-designer/setting-panel/property-editor/field-table-export-button/select-export-item-button-editor.vue

@@ -34,16 +34,59 @@
         <i class="el-icon-edit"></i>
       </a>
     </el-form-item>
+    <el-form-item label="明细导出脚本编码" class="form-item-label-top">
+      <el-input v-model="optionModel.exportItemScriptCode"></el-input>
+    </el-form-item>
+    <el-form-item label="明细导出查询参数">
+      <a
+        href="javascript:void(0);"
+        class="a-link link-oneLind"
+        @click="editEventHandler('exportItemParam', tableConfigParams)"
+      >
+        <span>{{ optionModel.exportItemParam }}</span>
+        <i class="el-icon-edit"></i>
+      </a>
+    </el-form-item>
+    <el-form-item label="明细导出列维护">
+      <a
+        href="javascript:void(0);"
+        class="a-link link-oneLind"
+        @click="showExportItemColumnsDialog = true"
+      >
+        <span>{{
+          optionModel.exportItemColumns && optionModel.exportItemColumns.length
+            ? "已维护"
+            : null
+        }}</span>
+        <i class="el-icon-edit"></i>
+      </a>
+    </el-form-item>
+    <el-form-item label-width="0">
+      <div class="export-item-columns-tip">
+        脚本编码、查询参数、导出列三项各自独立：留空的那项沿用数据表格属性上配的，维护了就以本按钮为准。
+      </div>
+    </el-form-item>
+    <exportItemColumnsDialog
+      v-if="showExportItemColumnsDialog"
+      :visiable.sync="showExportItemColumnsDialog"
+      :designer="designer"
+      :selectedWidget="selectedWidget"
+      :optionModel="optionModel"
+    />
   </div>
 </template>
 
 <script>
 import i18n from "../../../../utils/i18n";
 import eventMixin from "../event-handler/eventMixin";
+import exportItemColumnsDialog from "../container-data-table/exportItemColumns-dialog.vue";
 
 export default {
   name: "select-export-item-button-editor",
   mixins: [i18n, eventMixin],
+  components: {
+    exportItemColumnsDialog,
+  },
   props: {
     designer: Object,
     selectedWidget: Object,
@@ -52,6 +95,9 @@ export default {
   data() {
     return {
       eventParams: [],
+      // 与数据表格属性面板同一套：脚本里可直接用 dataId / formCode
+      tableConfigParams: ["dataId", "formCode"],
+      showExportItemColumnsDialog: false,
     };
   },
   methods: {
@@ -71,4 +117,9 @@ export default {
 ::v-deep.export-divider .el-divider__text.is-center {
   width: 162px;
 }
+.export-item-columns-tip {
+  line-height: 18px;
+  color: #909399;
+  font-size: 12px;
+}
 </style>

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

@@ -3318,6 +3318,10 @@ export const advancedFields = [
       showImageAtTable: false,
       selectExportItemFlag: 1,
       exportItemConditionEnabled: !1,
+      // 按钮级明细导出配置：三项各自独立，留空的那项沿用数据表格属性上维护的
+      exportItemColumns: [],
+      exportItemScriptCode: null,
+      exportItemParam: "",
 
       onCreated: "",
       onMounted: "",

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

@@ -183,7 +183,10 @@
       <div>
         <template v-for="(fieldWidget, index) in obj.column.params.widgetList">
           <component
-            v-if="!!fieldSchemaMap[obj.row._X_ROW_KEY] && !!obj.row._X_ROW_KEY"
+            v-if="
+              !!obj.row._X_ROW_KEY &&
+              (!!getRowFieldSchema(obj.row) || !!obj.row._X_EXPORT_ROW)
+            "
             :is="getColumnWidgetName(fieldWidget)"
             v-bind="getRowWidgetOption(obj, fieldWidget)"
             :form-model="globalModel.formModel"
@@ -205,15 +208,15 @@
     </template>
     <template #editWidget="obj">
       <component
-        v-if="!!fieldSchemaMap[obj.row._X_ROW_KEY]"
+        v-if="!!getRowFieldSchema(obj.row)"
         :is="getColumnWidgetName(obj.column.params.editWidget)"
-        :field="fieldSchemaMap[obj.row._X_ROW_KEY][obj.column.params.editWidget.id]"
+        :field="getRowFieldSchema(obj.row)[obj.column.params.editWidget.id]"
         :form-model="globalModel.formModel"
         :designer="null"
         :key="
           obj.rowIndex +
           '-' +
-          fieldSchemaMap[obj.row._X_ROW_KEY][obj.column.params.editWidget.id].id
+          getRowFieldSchema(obj.row)[obj.column.params.editWidget.id].id
         "
         :parent-widget="widget"
         :columnConfig="obj.column.params.columnConfig"