ocpview-pro 0.1.30 → 0.1.33

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ocpview-pro",
-  "version": "0.1.30",
+  "version": "0.1.33",
   "title": "ocpviewPlus",
   "description": "A high quality Service UI components Library with Vue.js",
   "homepage": "",

package/src/components/grid/editgridbase.vue

@@ -40,7 +40,7 @@ export default {
             rowAction: [{
                 iconcls: 'row',
                 name: 'editRowForm',
-                text: '编辑',
+                text: this.$t('编辑'),
             }, ],
             openChange: false,
             focusIndex: null,
@@ -54,7 +54,6 @@ export default {
         this.myConfig.cancelBtnName = this.$t('放弃');
         this.delBatchBtnName = this.$t('删除');
         this.addBtnName = this.$t('新增');
-        this.rowAction[0].text = this.$t('编辑');
     },
     computed: {
         colKeys() {

package/src/components/grid/viewgridbase.vue

@@ -3,6 +3,14 @@ import { deepCopy } from '../../utils/assist';
 import Base from './basegrid.vue';
 import elementResizeDetectorMaker from 'element-resize-detector';
 import {gzip} from 'pako';
+import {
+    buildExportSearchParam,
+    buildSummaryRow,
+    buildSummaryMap,
+    collectSummaryFields,
+    translateDictValues,
+    DEFAULT_EXPORT_PAGE_SIZE
+} from '@/method/listexport';
 export default {
     name: 'viewgridbase',
     extends: Base,
@@ -51,7 +59,13 @@ export default {
             dynamicColumnItems:[],
             tempMultiSelectData:[],
             multiSoltTableColumns:[],
-            showHelpBtn:false
+            showHelpBtn:false,
+            /**
+             * 业务侧显式配置的 showSummary（undefined 表示"没配"）。
+             * 用于区分"没配"与"显式关闭"：没配时由列上的 sum: true 自动开启合计行，
+             * 显式 false 时即使有 sum 列也不显示合计。
+             */
+            userShowSummary: undefined
         };
     },
     computed:{
@@ -271,17 +285,65 @@ export default {
             if (this.dynamicInitData.total_results !== undefined) {
                 this.myConfig.pageConfig.total_results= Number(this.dynamicInitData.total_results);
             }
+            // 合计行显示与否统一在这里裁决：业务侧只需在列上写 sum: true，
+            // 不必再配 showSummary（显式 showSummary: false 可强制关闭）。
             if (this.dynamicInitData.total_summary !== undefined) {
+                // 后端合计（报表链路）：后端给了合计就是权威，直接展示
                 this.total_summary = Object.assign({}, {}, this.dynamicInitData.total_summary);
-                if (!this.myConfig.showSummary) {
-                    Object.assign(this.myConfig,{'showSummary':true});
-                }
+                Object.assign(this.myConfig,{'showSummary':true});
             } else {
-                if (this.myConfig.showSummary) {
+                // 前端合计：列上用 sum: true 标记时，合计由前端从当前页数据计算，
+                // 既不依赖后端 total_summary，也不把字段塞进查询参数
+                // （见 getFrontendSummaryFields / buildFrontendSummary）。
+                let frontendSummary = this.calcFrontendSummary();
+                let userShowSummary = this.getUserShowSummary();
+                if (frontendSummary && userShowSummary !== false) {
+                    this.total_summary = frontendSummary;
+                    Object.assign(this.myConfig,{'showSummary':true});
+                } else if (userShowSummary === false) {
+                    // 业务显式关闭合计：清掉可能残留的合计值并隐藏合计行
+                    this.total_summary = {};
+                    Object.assign(this.myConfig,{'showSummary':false});
+                } else if (this.myConfig.showSummary && this.myConfig.customSummary) {
+                    // 纯自定义合计：没有 sum 列时也保留合计行，由 customSummary 自行填值
+                    this.total_summary = {};
+                } else if (this.myConfig.showSummary) {
+                    this.total_summary = {};
                     Object.assign(this.myConfig,{'showSummary':false});
                 }
             }
         },
+        /**
+         * 业务侧显式配置的 showSummary：undefined 表示"没配"。
+         * 只有显式 false 才阻止 sum 列自动开启合计行。
+         */
+        getUserShowSummary() {
+            if (this.userShowSummary !== undefined) {
+                return this.userShowSummary;
+            }
+            if (this.config && this.config.showSummary !== undefined) {
+                return this.config.showSummary;
+            }
+            return undefined;
+        },
+        /**
+         * 前端合计计算兜底：合计只是锦上添花，任何异常都不允许影响列表正常
+         * 加载（refurbishSucceedDefault 在请求回调里执行，抛错会导致 loading
+         * 卡住、数据不渲染）。最坏表现 = 没有合计行。
+         */
+        calcFrontendSummary() {
+            try {
+                if (this.dynamicInitData.sumgroups) {
+                    // 小计链路里 tempData 混有分组小计行，前端再求和会重复计数，
+                    // 该链路的合计仍由后端 total_summary 提供
+                    return null;
+                }
+                return this.buildFrontendSummary();
+            } catch (e) {
+                console.warn('[ocpview-pro] 前端合计计算失败，本次查询已跳过合计行:', e);
+                return null;
+            }
+        },
         callBackChangePage(flag ,newvalue, oldvale)  {
             if (!flag) {
                 this.$nextTick(() => {
@@ -537,6 +599,98 @@ export default {
                 this.doExportExcel(_baseUrl, this.myConfig.method, _param,this.myConfig.exportType, _self);
             }
         },
+        /**
+         * 收集列上标记 sum: true 的字段（前端合计标记，支持多级表头的 children）。
+         *
+         * 与后端合计标记 summary: true 严格区分：summary 会让 basegrid 把字段塞进
+         * summaryColumn，进而被 getSearchParam 拼成 summary_fld 发给后端 —— 而后端
+         * StorageUtils 的豁免名单不含 summary_fld，会被当成 WHERE 条件拼进 SQL 而报错。
+         * sum 不进查询参数，合计一律由前端从当前页数据计算。
+         *
+         * 列上写了 sum: true 即视为业务要合计，合计行由 refurbishSucceedDefault 自动开启，
+         * 业务侧无需再配 showSummary。
+         */
+        getFrontendSummaryFields() {
+            return collectSummaryFields(this.myConfig.items);
+        },
+        /**
+         * 前端合计：从当前页数据（tempData）求和，返回 { field: number }。
+         * 无 sum 列时返回 null，表示"未配置前端合计"。
+         */
+        buildFrontendSummary() {
+            const fields = this.getFrontendSummaryFields();
+            if (fields.length === 0) {
+                return null;
+            }
+            return buildSummaryMap(this.tempData, fields);
+        },
+        /**
+         * 单据列表导出（通用）：按配置的分页大小全量取数，前端生成 Excel 并附合计行。
+         * 与报表导出 export()（走 /exportExcel 后端接口）完全独立，互不影响。
+         * 与单据明细导出（detailExport，本期未实现）共用同一套纯逻辑。
+         */
+        listExport() {
+            const exportConfig = this.myConfig.exportConfig || {};
+            if (exportConfig.enabled === false) {
+                return;
+            }
+            if (this.data.length === 0) {
+                this.alert(this.$t('请先查询数据'));
+                return;
+            }
+            // 参数清洗（剔除 summary_fld/sumgroups）在 buildExportSearchParam 内完成
+            const param = buildExportSearchParam(
+                this.getSearchParam(),
+                exportConfig.pageSize || DEFAULT_EXPORT_PAGE_SIZE
+            );
+            this.loading = true;
+            const self = this;
+            this.asyncPost(this.myConfig.resources, this.myConfig.method, param, function (data) {
+                self.loading = false;
+                self.doListExport(data, exportConfig);
+            }, function (e) {
+                self.loading = false;
+                self.alert(e, null, 2);
+            });
+        },
+        doListExport(data, exportConfig) {
+            const tableKey = this.myConfig.response;
+            const rows = (data && data[tableKey]) || [];
+            // 刻意不调用 this.myConfig.overrideData：
+            //   1) 在 ListDetails 全族里，容器的 created() 会无条件把它覆盖成
+            //      billquerygrid.gridOverrideData（billquerygrid.vue:146），
+            //      而该函数对数据是恒等变换（只 return data），调与不调结果相同；
+            //   2) 但它有副作用：会用**全量结果集**的索引去 findIndex，
+            //      再 setRowHighlight(index) 对**当前页**做 data.splice(index,1,...)。
+            //      索引越界时会往可见列表里追加一行空行（basegrid.vue setRowHighlight）。
+            // 另外也不施加 showAll/rowAll 的合成"全部"行 —— 它是纯 UI 行，不该出现在导出里。
+            // 后端 page_size 硬上限 99999，超出会静默截断，这里显式告知
+            const total = data && data.total_results !== undefined ? Number(data.total_results) : 0;
+            if (total > rows.length) {
+                this.alert(this.$t('共{total}条，已导出前{count}条', { total: total, count: rows.length }));
+            }
+            const exportColumns = [];
+            this.initAsynExportConfig(this.myConfig.items, '', exportColumns);
+            const summaryFields = exportConfig.summaryFields || [];
+            // translateDictValues 自带深拷贝（返回新数组+新行对象），故无需再 copy
+            let exportData = translateDictValues(rows, exportColumns, this.dictData);
+            if (summaryFields.length > 0 && exportColumns.length > 0) {
+                exportData.push(
+                    buildSummaryRow(exportData, summaryFields, exportColumns[0].name, this.$t('合计'))
+                );
+            }
+            // initAsynExportConfig 已把子列扁平化并给标签加"父(子)"前缀，故表头只有 1 层
+            this.$Method.exportExcelStyle(exportColumns, exportData, 1, this.buildListExportFileName(rows.length));
+        },
+        buildListExportFileName(count) {
+            let fileName = this.$Method.formatDate(new Date(), 'yyyyMMddhhmmss')
+                + this.$t('({count}条).xlsx', { count: count });
+            const modulecode = this.getModulecode();
+            if (modulecode) {
+                fileName = modulecode + '_' + fileName;
+            }
+            return fileName;
+        },
         zip (str) {
             let  binaryString = gzip(str, { to: 'string' });
             return btoa(binaryString);
@@ -1040,7 +1194,9 @@ export default {
             if (this.myConfig.dynamicColumnFlag) {
                 items = this.dynamicColumnItems;
             } else {
-                items  = this.config.items;
+                // 与 getFrontendSummaryFields 取同一份列配置（myConfig.items），
+                // 保证合计值一定能在列上找到 format 并正确格式化
+                items  = this.myConfig.items || (this.config && this.config.items);
             }
             for (let pro in this.total_summary) {
                 let configItems = {};

package/src/components/masterplate/billdetailform.vue

@@ -10,17 +10,16 @@
     </div>
     <Card  :padding="0" :bordered="false"  style="padding-top:0px;padding-left:16px;padding-right:16px;padding-bottom:14px;"  dis-hover>
         <div :id="headid" :style="style2" @scroll="handleScroll">
-            <div v-for="(item,index) in myConfig.formsConfig.items"  :id="item.divId"  :key="item.divId"   v-show="headVisible[index].visible">
-                <Formcard  :ref="item.name"   :config="item" :dictData="dictData"  @doAction="doAction" >
+            <div v-for="temp in renderItems" :key="temp.el.divId" :id="temp.el.divId" v-show="temp.isHead ? headVisible[temp.index].visible : detailVisible[temp.index].visible" >
+                <Formcard  v-if="temp.isHead" :ref="temp.el.name"   :config="temp.el" :dictData="dictData"  @doAction="doAction" >
                 </Formcard>
-             </div>
-            <div v-for="(temp2,index) in detailConfig.items" :key="temp2.divId" :id="temp2.divId" v-show="detailVisible[index].visible" >
-                <EditGridCardS  v-if="temp2.type === 'EditGridCard'" :ref="temp2.name" :config="temp2" :dictData="dictData" @doAction="doAction"/>
-                <DetailsBoxs  v-if="temp2.type === 'DetailsBox'" :ref="temp2.name"      :config="temp2" :dictData="dictData" @doAction="doAction"/>
-                <FormCardBox  v-if="temp2.type === 'FormCardBox'" :ref="temp2.name"     :config="temp2" :dictData="dictData"/>
-                <AppendixBoxs  v-if="temp2.type === 'AppendixBox'" :ref="temp2.name"   :config="temp2" :modulecode="modulecode" @doAction="doAction"/>
-                <FormCardBox2  v-if="temp2.type === 'FormCardBox2'" :ref="temp2.name"     :config="temp2" :dictData="dictData"/>
-                <AppendixBoxs2 v-if="temp2.type === 'AppendixBox2'" :ref="temp2.name"   :config="temp2" :dictData="dictData" :modulecode="modulecode" @handleSuccessAfter="handleSuccessAfter" @doAction="doAction"/>
+                <EditGridCardS  v-if="!temp.isHead && temp.el.type === 'EditGridCard'" :ref="temp.el.name" :config="temp.el" :dictData="dictData" @doAction="doAction"/>
+                <DetailsBoxs  v-if="!temp.isHead && temp.el.type === 'DetailsBox'" :ref="temp.el.name"      :config="temp.el" :dictData="dictData" @doAction="doAction"/>
+                <FormCardBox  v-if="!temp.isHead && temp.el.type === 'FormCardBox'" :ref="temp.el.name"     :config="temp.el" :dictData="dictData"/>
+                <AppendixBoxs  v-if="!temp.isHead && temp.el.type === 'AppendixBox'" :ref="temp.el.name"   :config="temp.el" :modulecode="modulecode" @doAction="doAction"/>
+                <FormCardBox2  v-if="!temp.isHead && temp.el.type === 'FormCardBox2'" :ref="temp.el.name"     :config="temp.el" :dictData="dictData"/>
+                <AppendixBoxs2 v-if="!temp.isHead && temp.el.type === 'AppendixBox2'" :ref="temp.el.name"   :config="temp.el" :dictData="dictData" :modulecode="modulecode" @handleSuccessAfter="handleSuccessAfter" @doAction="doAction"/>
+                <EditGridBoxs v-if="temp2.type === 'EditGridBox'" :ref="temp2.name"   :config="temp2" :dictData="dictData" @doAction="doAction"/>
             </div>
         </div>
     </Card>
@@ -35,9 +34,10 @@ import AppendixBoxs2 from './contractappendix.vue';
 import FormCardBox2 from '../form/formcardbox2.vue';
 import random from '../../utils/random_str';
 import Formcard from './formcard.vue';
+import EditGridBoxs from './editgridcard.vue';
 export default {
     name:'mbilldetailform',
-    components:{AppendixBoxs2, Formcard,EditGridCardS,DetailsBoxs,AppendixBoxs,FormCardBox2},
+    components:{AppendixBoxs2, Formcard,EditGridCardS,DetailsBoxs,AppendixBoxs,FormCardBox2,EditGridBoxs},
     data () {
         return {
             curlEditObject:'',
@@ -123,7 +123,7 @@ export default {
                 el.modetype = modetype;
                 el.divId = 'headForm_' + this.getRandom() + '_' +  index;
                 this.headVisible.push({refname:el.name,visible:true});
-                this.anchorData.push({id:'#'+el.divId ,name:el.title ? this.$t(el.title) : el.title,visible:true,refname:el.name,isHead:true});
+                this.anchorData.push({id:'#'+el.divId ,name:el.title ? this.$t(el.title) : el.title,visible:true,refname:el.name,isHead:true,sort:el.sort === undefined ? 0 : el.sort});
             });
         }
 
@@ -164,7 +164,7 @@ export default {
                     }
                     el.divId = 'detail_'+ this.getRandom() + '_'+ index;
                     this.detailVisible.push({refname:el.name,visible:true});
-                    this.anchorData.push({id:'#'+ el.divId, name:el.title ? this.$t(el.title) : el.title,refname:el.name,visible:true,isHead:false});
+                    this.anchorData.push({id:'#'+ el.divId, name:el.title ? this.$t(el.title) : el.title,refname:el.name,visible:true,isHead:false,sort:el.sort === undefined ? Number.MAX_SAFE_INTEGER : el.sort});
                 });
             }
         }
@@ -185,7 +185,7 @@ export default {
             tmp.divId = 'detail_'+ this.getRandom() + '_'+ this.detailConfig.items.length;
             this.detailConfig.items.push(tmp);
             this.detailVisible.push({refname:tmp.name,visible:true});
-            this.anchorData.push({id:'#'+ tmp.divId, name:tmp.title ? this.$t(tmp.title) : tmp.title,refname:tmp.name,visible:true});
+            this.anchorData.push({id:'#'+ tmp.divId, name:tmp.title ? this.$t(tmp.title) : tmp.title,refname:tmp.name,visible:true,sort:Number.MAX_SAFE_INTEGER});
         } else if (this.billAppendixConfig.showAppendix2) {
             let tmp = Object.assign({}, {}, this.billAppendixConfig);
             tmp.type = 'AppendixBox2';
@@ -195,14 +195,34 @@ export default {
             tmp.divId = 'detail_'+ this.getRandom() + '_'+ this.detailConfig.items.length;
             this.detailConfig.items.push(tmp);
             this.detailVisible.push({refname:tmp.name,visible:true});
-            this.anchorData.push({id:'#'+ tmp.divId, name:tmp.title ? this.$t(tmp.title) : tmp.title,refname:tmp.name,visible:true});
+            this.anchorData.push({id:'#'+ tmp.divId, name:tmp.title ? this.$t(tmp.title) : tmp.title,refname:tmp.name,visible:true,sort:Number.MAX_SAFE_INTEGER});
         }
 
         if (this.myConfig.showAnchorLink !== undefined) {
             this.showAnchorLink = this.myConfig.showAnchorLink;
         }
+
+        // 锚点导航顺序与混排后的渲染顺序保持一致
+        this.anchorData.sort((a, b) => a.sort - b.sort);
     },
     computed:{
+        renderItems () {
+            // formsConfig.items 与 detailConfig.items 按 sort 升序混排；
+            // 未配置 sort 时 formsConfig 项视为 0、detailConfig 项视为最大值，保持 forms 在前 details 在后的现状
+            let heads = [];
+            let details = [];
+            if (this.myConfig.formsConfig && this.myConfig.formsConfig.items) {
+                heads = this.myConfig.formsConfig.items.map((el, index) => {
+                    return { el: el, index: index, isHead: true, sort: el.sort === undefined ? 0 : el.sort };
+                });
+            }
+            if (this.detailConfig.items) {
+                details = this.detailConfig.items.map((el, index) => {
+                    return { el: el, index: index, isHead: false, sort: el.sort === undefined ? Number.MAX_SAFE_INTEGER : el.sort };
+                });
+            }
+            return heads.concat(details).sort((a, b) => a.sort - b.sort);
+        },
         style2 () {
             let height = this.$Store.state.app.clientHeight;
             if (this.extraHeight) {

package/src/components/masterplate/listbtntoolbar.vue

@@ -75,7 +75,7 @@ export default {
             showModuleCode:false,
             moreFlag:false,
             btnItems:[],
-            ignoreModule:['downTemplate'],
+            ignoreModule:['downTemplate','listExport'],
             notpowerFlag:true,
             billoperlog:false,
         };

package/src/components/masterplate/listdetails.vue

@@ -25,6 +25,7 @@ import BillDetailForm from './billdetailform.vue';
 import ApprovalBox from './approval.vue';
 import BillOperLog from './operlog.vue';
 import load from '@/components/base/load';
+import { LIST_EXPORT_ACTION } from '@/method/listexport';
 export default {
     name:'mlistdetails',
     mixins: [load],
@@ -111,6 +112,7 @@ export default {
                 this.myConfig.billQueryConfig.addDataflag = 'Y';
             }
         });
+        this.injectListExportBtn();
 
 
 
@@ -226,7 +228,38 @@ export default {
                     }
             });
         },
+        /**
+         * 通用注入「列表导出」按钮。
+         * ListDetails / ListDetailsV2 / ListDetailsV3 均 extends 本组件，故一处注入三处生效。
+         * 页面已在 menuToolbar.items 自行声明同名按钮时不重复注入；
+         * exportConfig.enabled === false 时不注入。
+         */
+        injectListExportBtn() {
+            const gridConfig = this.myConfig.billQueryConfig.gridConfig;
+            const exportConfig = gridConfig.exportConfig || {};
+            if (exportConfig.enabled === false) {
+                return;
+            }
+            const exists = this.myConfig.billQueryConfig.btnData.some(el => el.name === LIST_EXPORT_ACTION);
+            if (exists) {
+                return;
+            }
+            this.myConfig.billQueryConfig.btnData.push({
+                name: LIST_EXPORT_ACTION,
+                text: this.$t('列表导出'),
+                btntype: 'batch'
+            });
+        },
         doAction (obj) {
+            if (obj.name === LIST_EXPORT_ACTION) {
+                // 页面覆盖优先：沿用框架既有钩子约定（同 setBillData / initFormAfter）
+                if (this.$parent && typeof this.$parent[LIST_EXPORT_ACTION] === 'function') {
+                    this.$parent[LIST_EXPORT_ACTION](obj);
+                } else {
+                    this.$refs.billqureygrid.getGrid().listExport();
+                }
+                return true;
+            }
             if (obj.name === 'gridSelectionChange' ) {
                 if (this.$parent[obj.name]) {
                     this.$parent[obj.name](obj);

package/src/localePlus/en-US.js

@@ -66,6 +66,7 @@ export default {
   '加签': 'Add Signer',
   '加粗': 'Bold',
   '加载': 'Loading',
+  '合计': 'Total',
   '动态合计': 'Dynamic Sum',
   '包含': 'Contains',
   '单据主健信息为空,不允许上传': 'Bill primary key is empty, upload not allowed',
@@ -111,6 +112,8 @@ export default {
   '导出失败': 'Export Failed',
   '导出失败：{status} {statusText}': 'Export failed: {status} {statusText}',
   '导出中...，请勿关闭！': 'Exporting..., do not close!',
+  '列表导出': 'Export List',
+  '共{total}条，已导出前{count}条': 'Total {total} rows, exported the first {count}',
   '导出任务已生成，请稍后在任务列表下载文件': 'Export task generated, download from task list later',
   '导出选择': 'Export Selection',
   '小一': '24pt',

package/src/localePlus/zh-CN.js

@@ -66,6 +66,7 @@ export default {
   '加签': '加签',
   '加粗': '加粗',
   '加载': '加载',
+  '合计': '合计',
   '动态合计': '动态合计',
   '包含': '包含',
   '单据主健信息为空,不允许上传': '单据主健信息为空,不允许上传',
@@ -111,6 +112,8 @@ export default {
   '导出失败': '导出失败',
   '导出失败：{status} {statusText}': '导出失败：{status} {statusText}',
   '导出中...，请勿关闭！': '导出中...，请勿关闭！',
+  '列表导出': '列表导出',
+  '共{total}条，已导出前{count}条': '共{total}条，已导出前{count}条',
   '导出任务已生成，请稍后在任务列表下载文件': '导出任务已生成，请稍后在任务列表下载文件',
   '导出选择': '导出选择',
   '小一': '小一',

package/src/localePlus/zh-TW.js

@@ -66,6 +66,7 @@ export default {
   '加签': '加簽',
   '加粗': '加粗',
   '加载': '加載',
+  '合计': '合計',
   '动态合计': '動態合計',
   '包含': '包含',
   '单据主健信息为空,不允许上传': '單據主鍵信息為空,不允許上傳',
@@ -111,6 +112,8 @@ export default {
   '导出失败': '導出失敗',
   '导出失败：{status} {statusText}': '導出失敗：{status} {statusText}',
   '导出中...，请勿关闭！': '導出中...，請勿關閉！',
+  '列表导出': '列表匯出',
+  '共{total}条，已导出前{count}条': '共{total}條，已匯出前{count}條',
   '导出任务已生成，请稍后在任务列表下载文件': '導出任務已生成，請稍後在任務列表下載文件',
   '导出选择': '導出選擇',
   '小一': '小一',

package/src/method/listexport.js

@@ -0,0 +1,163 @@
+/**
+ * 单据列表导出 —— 纯逻辑层
+ *
+ * 本文件不依赖 Vue、不使用 "@/..." 别名导入，以便直接被 `node --test` 运行。
+ *
+ * 【重要 · 见设计文档 3.1】
+ * 后端 StorageUtils.isSpecialParamKey 的豁免名单只有：
+ *   fields / page_no / page_size / order_field / order_direction / 含 ":" 的子表键
+ * 其余任何 key 都会被 buildCriteria 当成 WHERE 条件拼进 SQL。
+ * 所以 summary_fld / sumgroups 这类"前端自用"的参数一旦进入查询参数，
+ * 就会变成 SQL 条件导致"查不到列"而报错 —— 必须彻底剔除。
+ * 合计因此一律在前端本地计算。
+ */
+
+/** 导出取数默认分页大小，对齐后端 StorageUtils.java:480 的硬上限 */
+export const DEFAULT_EXPORT_PAGE_SIZE = 99999;
+
+/** 列表导出动作名 */
+export const LIST_EXPORT_ACTION = 'listExport';
+
+/** 单据明细导出动作名（本期仅占位，不实现，避免与列表导出混用命名） */
+export const DETAIL_EXPORT_ACTION = 'detailExport';
+
+/** 后端不豁免、必须从查询参数中剔除的键 */
+const NON_QUERY_KEYS = ['summary_fld', 'sumgroups'];
+
+/**
+ * 构造导出用的查询参数。
+ * @param {object} baseParam 通常来自 grid.getSearchParam()
+ * @param {number} pageSize 导出分页大小
+ * @returns {object} 新的参数对象（不修改入参）
+ */
+export function buildExportSearchParam(baseParam, pageSize) {
+    const param = Object.assign({}, baseParam || {});
+    NON_QUERY_KEYS.forEach(key => {
+        delete param[key];
+    });
+    const size = Number(pageSize);
+    param.page_no = 1;
+    param.page_size = Number.isFinite(size) && size > 0 ? size : DEFAULT_EXPORT_PAGE_SIZE;
+    return param;
+}
+
+/**
+ * 把任意值安全转成数字，非数值一律按 0 处理（不抛错）。
+ */
+export function toNumber(value) {
+    const n = Number(value);
+    return Number.isFinite(n) ? n : 0;
+}
+
+/**
+ * 收集列配置上标记 sum: true 的字段名（前端合计字段）。
+ *
+ * 支持多级表头的 children；跳过 visible: false 的列，避免"表头设计里隐藏的列"
+ * 出现在合计行。与后端合计标记 summary: true 无关（后者会下发 summary_fld）。
+ *
+ * @param {object[]} items 列配置（gridConfig.items）
+ * @returns {string[]} 参与合计的字段名
+ */
+export function collectSummaryFields(items) {
+    const fields = [];
+    const collect = (list) => {
+        // 组件库场景：items / children 可能来自后端或用户配置，非数组一律安全跳过
+        if (!Array.isArray(list)) {
+            return;
+        }
+        list.forEach(el => {
+            if (!el || typeof el !== 'object' || el.visible === false) {
+                return;
+            }
+            if (Array.isArray(el.children) && el.children.length > 0) {
+                collect(el.children);
+            } else if (el.sum === true && el.name) {
+                fields.push(el.name);
+            }
+        });
+    };
+    collect(items);
+    return fields;
+}
+
+/**
+ * 构造合计行。返回的普通对象可直接 push 进导出数据末尾 ——
+ * exportExcelStyle 会按列顺序从对象上取值，因此无需改动导出器本身。
+ * @param {object[]} rows 参与合计的数据行
+ * @param {string[]} summaryFields 参与合计的字段名
+ * @returns {object}
+ */
+export function buildSummaryMap(rows, summaryFields) {
+    const map = {};
+    (summaryFields || []).forEach(field => {
+        const total = (rows || []).reduce((acc, r) => acc + toNumber(r[field]), 0);
+        // toFixed(10) 消除 IEEE754 累加噪声（0.1+0.2 -> 0.3）
+        map[field] = Number(total.toFixed(10));
+    });
+    return map;
+}
+
+/**
+ * 构造合计行。返回的普通对象可直接 push 进导出数据末尾 ——
+ * exportExcelStyle 会按列顺序从对象上取值，因此无需改动导出器本身。
+ * @param {object[]} rows 参与合计的数据行
+ * @param {string[]} summaryFields 参与合计的字段名
+ * @param {string} firstColumnName 第一列字段名，用于写"合计"文案
+ * @param {string} sumText 合计文案
+ * @returns {object}
+ */
+export function buildSummaryRow(rows, summaryFields, firstColumnName, sumText) {
+    const row = {};
+    if (firstColumnName) {
+        row[firstColumnName] = sumText;
+    }
+    Object.assign(row, buildSummaryMap(rows, summaryFields));
+    return row;
+}
+
+/**
+ * 把 ComboBox 列的 code 翻译成显示文本，与列表所见保持一致。
+ *
+ * 注意：不要照抄 viewgridbase.vue dynamicExportExcel 里的同功能实现 ——
+ * 那里 `if (el.valueField) { valueField = column.valueField; }` 引用了未定义的
+ * `column`，会抛 ReferenceError。
+ *
+ * @param {object[]} rows 数据行
+ * @param {object[]} columns 导出列配置（需带 name / type / data）
+ * @returns {object[]} 新数组（不修改入参）
+ */
+export function translateDictValues(rows, columns, dictData) {
+    const result = (rows || []).map(row => Object.assign({}, row));
+    (columns || []).forEach(column => {
+        if (column.type !== 'ComboBox' || !column.name) {
+            return;
+        }
+        // 真实业务里 ComboBox 绝大多数用 dictkey 从外部字典取数，列上没有内联 data
+        // （basegrid.setColumn 是在 $Method.copy 出来的副本上写 column.data 的，
+        //  见 basegrid.vue:475 与 :600-604，所以 myConfig.items 上永远拿不到 data）。
+        // 因此这里必须回退到 grid 的 dictData，否则导出的是裸 code。
+        const dictList = column.data
+            || (dictData || {})[column.customDictkey || column.dictkey];
+        if (!dictList) {
+            return;
+        }
+        const valueField = column.valueField || 'code';
+        const textField = column.textField || 'name';
+        const dict = new Map();
+        dictList.forEach(item => dict.set(item[valueField], item));
+        result.forEach(row => {
+            const raw = row[column.name];
+            if (raw === undefined || raw === null || raw === '') {
+                return;
+            }
+            const hit = dict.get(raw);
+            if (!hit) {
+                return;
+            }
+            row[column.name] = column.codeWithName === false
+                ? hit[textField]
+                : '[' + hit[valueField] + ']' + hit[textField];
+        });
+    });
+    return result;
+}

package/src/static/excel/exportexcel.js

@@ -508,7 +508,13 @@ export function exportExcelStyle(config, data, headNum, filename) {
     let temp = [];
     names.forEach(el2 => {
       if (el2.excelPro.t === 'n') {
-        temp.push(Number(el[el2.name]));
+        // 数值列取不到有效数字时必须落成"空格子"，不能落成 NaN。
+        // Number(undefined) === NaN，而 aoa_to_sheet 只跳过 undefined、不跳过 NaN，
+        // 于是会在文件里写出 <v>NaN</v> 这种非法数值格，Excel 打开会要求修复。
+        // 典型触发点：列表导出的合计行只填了参与合计的数值列，其余 NumberBox 列缺键。
+        // 注意 Number('') === 0、Number(null) === 0，这些既有语义保持不变。
+        const numValue = Number(el[el2.name]);
+        temp.push(Number.isFinite(numValue) ? numValue : undefined);
       } else if (el2.excelPro.t === 'd') {
         let value = datenum(new Date(el[el2.name]));
         temp.push(value);