zbcx_ckyc 1.0.0

package/src/plugins/cxMixin/IDataMan.js

@@ -0,0 +1,1670 @@
+/**
+ * 修改记录:
+ * 20-07-18  张发勇               增加一个函数 setAttOper(operCol)，用于派生类自定义属性相关的操作按钮，简化派生类的代码
+ * 20-08-04  张发勇               增加一个函数 initAtt(att),用于输入属性之前，在派生类初始化属性（特殊情况下修改字段值）
+ * 21-02-19  张发勇               增加 onEditRow, 响应 event: edit-row
+ * 21-02-24  张发勇               增加 maxColWidth = 275, fontSize = 14, padding = 15 便于派生类修改
+ * 21-04-04  张发勇               增加函数 operView, operEdit, operDel 便于定制
+ * 21-06-09  张发勇               去掉前端直接传递表达式给后端，增加参数 sqlCfg, 支持 query, queryUnion
+ * 21-11-04  张发勇               去掉了 __update(), 增加了 getCur()
+ * 22-05-20  张发勇               升级到 element-plus
+ *                                删除 useOperCols
+ *                                删除 usePage
+ *                                selections -> selection
+ *                                page-change -> page-chang / pagesize-change
+ *                                onClickRow -> onRowClick
+ *                                onRowDblClick -> onRowDblClick
+ *                                onSelectionChange -> onSelectionChange
+ *                                onButtonClick -> onButtonClick
+ *                                onPageChange -> onPageChange
+ * 22-06-11       张发勇          js -> vue
+ * 23-05-31       张  清          放开init方法中operCols、cols空数组声明，解决多次调用init时保留上次的数据
+ * 23-07-16       张发勇          增加函数，exportData()-根据当前的查询条件去导出的数据,getDispCols()-，取当前显示的列名
+ * 23-07-31       张发勇          _upd()函数，增加数据修改标记，否则可输入的数据没有修改，保存按钮不可点击
+ * 23-08-12       张发勇          sqlexp.querPara()修改了参数，去掉major,minor
+ * 23-08-17       张清            更新注释，修改自动计算的默认参数，解决表头多行显示问题
+ * 24-04-23       张发勇          修改列排序方式，对于使用排序的列，同时点击排序进行数据请求的，必须把sortable = custom，否则使用显示文本排序
+ */
+
+/**
+ * cx.mixin.IDataMan
+ * 混淆类 - 数据管理（基于DataGrid）
+ *
+ * @module      cx.mixin.IDataMan
+ * @memberof    cx.mixin
+ *
+ * @property  {Number}          major                     实体主类型
+ * @property  {Number}          minor                     实体子类型
+ * @property  {String}          [tabName]                 表名，地图服务配置fld时构造字段对象，tabName 和 major,minor 至少要有一个
+ * @property  {Array}           [flds = null]             要创建的的字段对象序列，没传入该属性时，就是用major和minor对应表的字段数据
+ * @property  {Boolean}         [editable = false]        是否可编辑
+ * @property  {Boolean}         [useExp = true]           是否启用属性查询条件输入
+ * @property  {Boolean}         [useExpMore = true]       是否启用属性查询条件输入(More)
+ * @property  {Boolean}         [noExpDispAll = false]    没有查询条件显示所有数据
+ * @property  {Array.<String>}  [expRange]                条件输入里面用于输入范围的列列表
+ * @property  {Array.<String>}  [expExclude]              条件输入里面排除的列列表
+ * @property  {cx.SqlEx}        [fixedExp = null]         固定条件(任何时候都加上的条件)
+ * @property  {cx.SqlEx}        [defExp = null]           默认条件(有自定义条件之后即删除)
+ * @property  {Object}          [unionQuery = null]       联合查询参数
+ * @property  {String}          [unionQuery.mainAlias]    主表别名(例如: "a")
+ * @property  {Number}          [retAtt = 0]              插入/修改是否返回数据
+ *
+ * @property  {Boolean}         [sortable = true]         是否启用列排序(列名边上的排序箭头，会影响到宽度计算)
+ * @property  {Number}          [maxColWidth = 275]       最大列宽（dynaWidth=true时用于计算列宽）
+ * @property  {Number}          [fontSize = 14]           默认字体大小(dynaWidth=true时用于计算列宽)
+ * @property  {Number}          [padding = 20]            padding值(dynaWidth=true时用于计算列宽)
+ * @property  {Boolean}         [dynaWidth = true]        动态计算列宽，根据数据内容计算宽度，覆盖字段设置宽度
+ *
+ * @property  {Object}          entity                    实体对象
+ * @property  {cx.AttBase}      attObj                    属性对象
+ * @property  {Boolean}         ready                     是否初始化完成，尤其attObj是异步创建，必须ready后使用
+ * @property  {Array}           expFlds                   条件表达式字段列表
+ * @property  {Object}          attExp                    条件表达式对象
+ * @property  {String}          orderby                   排序，asc(升序) desc(降序)
+ * @property  {Object}          queryPara                 SQL查询参数
+ * @property  {Array}           list                      数据
+ * @property  {Array}           opers                     操作列表-便于计算各种操作的enable, show
+ * @property  {Object}          selected                  当前选中的行
+ * @property  {Array.<Object>}  selection                 复选框选中的全部行
+ * @property  {Object}          dg                        DataGrid对象
+ * @property  {Object}          sqlCfg                    SQL 配置
+ * @property  {String}          sqlCfg.key                sqlexp 表的 name
+ * @property  {String}          sqlCfg.vals               传递给 sqlexp 的值
+ * @property  {String}          sqlCfg.orderby            排序信息
+ */
+
+export default
+{
+  data()
+  {
+    return {
+      major: 0,
+      minor: 0,
+      tabName: '',
+      flds: null,
+      editable: false,
+      useExp: true,
+      useExpMore: true,
+      noExpDispAll: false,
+      expRange: null,
+      expExclude: null,
+      fixedExp: null,
+      defExp: null,
+      unionQuery: null,
+      retAtt: 0,
+      sortable: true,
+      maxColWidth: 275,
+      fontSize: 14,
+      padding: 20,
+      dynaWidth: true,
+      sqlCfg: { key: '', vals: '', orderby: '' },
+      entity: null,
+      attObj: null,
+      expFlds: [],
+      attExp: null,
+      orderby: '',
+      queryPara: {},
+      list: [],
+      opers: [],
+      selected: null,
+      selection: [],
+      dg:
+      {
+        pages: true,                        // 是否使用分页
+        table:
+        {
+          elAtts:
+          {
+            border: true,                   // 是否带有纵向边框
+            stripe: true,                   // 是否为斑马纹 table
+            showSummary: false,             // 是否在表尾显示合计行
+            'row-style': ({ row, rowIndex }) => this.onRowStyle({ row, rowIndex }),                     // 行的 style 的回调方法，也可以使用一个固定的 Object 为所有行设置一样的 Style。
+            'cell-style': ({ row, column, rowIndex, columnIndex }) => this.onCellStyle({ row, column, rowIndex, columnIndex })           // 单元格的 style 的回调方法，也可以使用一个固定的 Object 为所有单元格设置一样的 Style。
+          },
+          fitWidth: true,                   // 宽度自适应
+          multiple: false,                  // 是否支持多选
+          selectOnClick: true,              // 点击某一行时会触发select选择事件，如果multiple多选模式会更新复选框的状态
+          operFix: 'right',                 // 操作列固定右边
+          list: [],                         // 数据列表
+          cols: [],                         // 列信息
+          operCols: []                      // 操作列信息
+        },
+        page:
+        {
+          total: 0,                         // 数据量
+          pageSize: cx.consts.PAGE_SIZE,    // 每页记录数
+          pageSizes: cx.consts.PAGE_SIZES   // 分页标准
+        }
+      }
+    }
+  },
+
+  /** @member    {Boolean}      enable1        选中一行数据 */
+  /** @member    {Object}       dgAtts         DataGrid 属性 */
+  /** @member    {Object}       dgEvts         DataGrid 事件 */
+  /** @member    {Object}       expAtts        表达式输入 属性 */
+  /** @member    {Object}       expEvts        表达式输入 事件 */
+  computed:
+  {
+    // 选中一行数据
+    enable1()
+    {
+      return !!this.selected
+    },
+
+    // DataGrid 属性
+    dgAtts()
+    {
+      return {
+        size: this.size,
+        datagrid: this.dg
+      }
+    },
+
+    // DataGrid 事件
+    dgEvts()
+    {
+      return {
+        'sort-change': (name, sort) => this.onSortChange(name, sort),
+        'row-click': (att) => this.onRowClick(att),
+        'row-dblclick': (att) => this.onRowDblClick(att),
+        'selection-change': (selection) => this.onSelectionChange(selection),
+        'button-click': (btn, att) => this.onButtonClick(btn, att),
+        'edit-row': (oldRowIndex, newRowIndwx) => this.onEditRow(oldRowIndex, newRowIndwx),
+        'pagesize-change': (pagesize) => this.onPagesizeChage(pagesize),
+        'page-change': (pageno) => this.onPageChange(pageno)
+      }
+    },
+
+    // 表达式输入 属性
+    expAtts()
+    {
+      return {
+        size: this.size,
+        flds: this.expFlds,
+        'show-more': this.useExpMore
+      }
+    },
+
+    // 表达式输入 事件
+    expEvts()
+    {
+      return {
+        'exp-search': () => this.onExpSearch(),
+        'exp-clear': () => this.onExpClear(),
+        'exp-more': () => this.onExpMore()
+      }
+    }
+  },
+
+  /**
+   * mounted 钩子
+   * @method
+   */
+  mounted()
+  {
+    // 监听
+    cx.events.listen(this, 'AttInsert', (params) =>
+    {
+      // eslint-disable-next-line
+      if (params.major == this.major && params.minor == this.minor)
+      {
+        this.attObj.numberize(params.newAtt)
+        this.afterAdd(params.newAtt)
+        this.gridAdd(params.newAtt)
+      }
+    })
+
+    cx.events.listen(this, 'AttDelete', (params) =>
+    {
+      // eslint-disable-next-line
+      if (params.major == this.major && params.minor == this.minor)
+      {
+        this.afterDel(params.oldAtt)
+        this.gridDel(params.oldAtt)
+      }
+    })
+
+    cx.events.listen(this, 'AttUpdate', (params) =>
+    {
+      // eslint-disable-next-line
+      if (params.major == this.major && params.minor == this.minor)
+      {
+        this.attObj.numberize(params.newAtt)
+        this.afterUpd(params.newAtt)
+        this.gridUpd(params.newAtt, params.oldAtt)
+      }
+    })
+
+    this.ready = false
+    if (this.editable)
+      this.retAtt = 1
+    this.init().then(ret =>
+    {
+      this.ready = true
+    })
+  },
+
+  /**
+   * unmounted 钩子
+   * @method
+   */
+  unmounted()
+  {
+    cx.events.unlisten(this)
+    // cx.run.closePlug('ExpMoreInput')
+  },
+
+  /**
+   * 混合方法
+   * @class
+   */
+  methods:
+  {
+    /**
+     * 初始化
+     * @method
+     */
+    async init()
+    {
+      const self = this
+
+      // DataGrid赋值
+      self.dg.table.list = self.list
+
+      self.attExp = self.defExp               // 默认条件
+
+      if (!self.major && !self.minor && !self.tabName)
+        return
+        
+      // 实体信息
+      self.entity = $g.entity.byMajMin(self.major, self.minor) || $g.entity.byName(self.tabName)
+      if (!self.entity)
+      {
+        self.$showSvr('noPermision')
+        return
+      }
+
+      // 取表对象
+      this.attObj = await $g.attFactory.byMajMin(this.major, this.minor, { flds: this.flds, tabname: this.tabName })
+
+      // 条件表达式
+      if (self.useExp)
+      {
+        self.attObj.makeExp(self.expFlds, self.expRange, self.expExclude)
+        // 增加处理查询字段expFlds的钩子函数。
+        self.expFlds = self.filterExpFlds(self.expFlds)
+      }
+
+      // 构造操作列
+      // this.dg.table.operCols = []
+      const operCols = self.getOpers()
+      cx.array.appendArr(self.dg.table.operCols, operCols)
+      self.makeOpers(operCols)
+  
+      // 构造DataGrid列
+      let cols = self.getCols()
+      const colInfs = self.getColInfs()
+      cx.datagrid.makeCols(cols, colInfs, self.attObj.flds)
+
+      cols = self.filterCols(cols)
+      if (self.getEditCols)
+        self.attObj.makeEdit(cols, self.getEditCols())
+
+      // 修改组件排序方式，否则用内存字符串排序
+      for (let col of cols)
+      {
+        if (col.sortable)
+          col.sortable = 'custom'
+      }
+
+      self.cols = cols
+      self.dg.table.cols = cols
+  
+      // 发起默认查询
+      if (self.fixedExp || self.attExp || self.unionQuery || self.sqlCfg.key || (!self.attExp && self.noExpDispAll))
+      {
+        self.makeQueryPara()
+        self.refresh()
+      }
+    },
+
+    /**
+     * 构造好列头后的过滤钩子，可以对列头进行过滤处理。
+     * @method
+     * @param   {Array<Object>}   cols    构造好的列头集合
+     */
+    filterCols(cols)
+    {
+      return cols
+    },
+
+    /**
+     * 构造好expFlds后的过滤钩子，可以对expFlds进行过滤处理。
+     * @method
+     * @param   {Array<Object>}   flds    构造好的列头集合
+     */
+    filterExpFlds(flds)
+    {
+      return flds
+    },
+
+    /**
+     * 行样式
+     * @method
+     * @param   {Object}    opts             参数对象
+     * @param   {Object}    pts.aatt         行数据
+     * @param   {Number}    pts.arowIndex    行索引
+     * @returns {Object}                样式对象
+     */
+    onRowStyle({ att, rowIndex })
+    {
+    },
+
+    /**
+     * 单元格样式
+     * @method
+     * @param   {Object}    opts             参数对象
+     * @param   {Object}    opts.att         行数据
+     * @param   {Object}    opts.column      列数据
+     * @param   {Number}    opts.rowIndex    行索引
+     * @param   {Number}    opts.columnIndex 列索引
+     * @returns {Object}                     样式对象
+     */
+    onCellStyle({ row, column, rowIndex, columnIndex })
+    {
+    },
+
+    /**
+     * 按列头排序
+     * @method
+     * @param   {String}      name          排序字段
+     * @param   {String}      order         排序方式
+     */
+    onSortChange(name, order)
+    {
+      if (name)
+      {
+        // eslint-disable-next-line
+        if (name[0] == '_')
+          name = name.substring(1)
+      }
+      if (name && order)
+        this.orderby = (this.unionQuery && this.unionQuery.mainAlias ? this.unionQuery.mainAlias + '.' : '') + name + ' ' + order
+      else
+        this.orderby = ''
+      this.query()
+    },
+
+    /**
+     * 点击行
+     * @method
+     * @param   {Object}    att         行数据
+     */
+    onRowClick(att)
+    {
+      this.selected = att
+    },
+
+    /**
+     * 双击行
+     * @method
+     * @param   {Object}    att         行数据
+     */
+    onRowDblClick(att)
+    {
+      this.selected = att
+    },
+
+    /**
+     * 选择发生变化
+     * @method
+     * @param   {Array}     selection   选中的行数据
+     */
+    onSelectionChange(selection)
+    {
+      this.selection = selection
+    },
+
+    /**
+     * 点击按钮
+     * @method
+     * @param   {Object}    btn         点击的按钮
+     * @param   {Object}    att         行数据
+     */
+    onButtonClick(btn, att)
+    {
+      cx.base.call(btn.onClick, att)
+    },
+
+    /**
+     * 消息响应函数-每页数据量变化
+     * @method
+     * @param   {Number}    pagesize    选中的页码
+     */
+    onPagesizeChage(pagesize)
+    {
+      if (this.dg.page.pageSize !== pagesize)
+        this.dg.page.pageSize = pagesize
+      this.queryPara.pagesize = pagesize
+      this.queryPara.pageno = 1
+      this.query()
+    },
+
+    /**
+     * 消息响应函数-选中某页
+     * @method
+     * @param   {Number}    pageNo      选中的页码
+     */
+    onPageChange(pageNo)
+    {
+      if (this.queryPara.pageno !== pageNo)
+      {
+        this.queryPara.pageno = pageNo < 1 ? 1 : pageNo
+        this.query()
+      }
+    },
+
+    /**
+     * 消息响应函数-根据自定义表达式搜索
+     * @method
+     */
+    onExpSearch()
+    {
+      // 默认查询
+      if (!this.makeAttExp())
+        return
+
+      const defExp = cx.sqlexp.getDefExp()                   // 空表达式
+
+      cx.sqlexp.merge(defExp, this.fixedExp, this.attExp)
+      this.queryPara = cx.sqlexp.queryPara(defExp, this.dg.pages ? this.dg.page.pageSize : 0)
+      if (this.$refs.datagrid && this.$refs.datagrid.$refs.gridpage)
+        this.$refs.datagrid.$refs.gridpage.currentPage = 1
+      this.query()
+    },
+
+    /**
+     * 消息响应函数-根据自定义表达式搜索
+     * @method
+     */
+    onExpClear()
+    {
+      for (let fld of this.expFlds)
+      {
+        fld.value = ''
+        fld.value1 = ''
+        fld.value2 = ''
+      }
+    },
+
+    /**
+     * 消息响应函数-更多条件过滤
+     * @method
+     */
+    onExpMore()
+    {
+      const self = this
+      const params =
+      {
+        flds: self.expFlds,
+        unionQuery: self.unionQuery,
+        onOk: (attExp) =>
+        {
+          const defExp = cx.sqlexp.getDefExp()                // 空表达式
+
+          self.attExp = attExp
+          cx.sqlexp.merge(defExp, self.fixedExp, self.attExp)
+          self.queryPara = cx.sqlexp.queryPara(defExp, self.dg.pages ? self.dg.page.pageSize : 0)
+
+          self.query()
+        }
+      }
+      cx.run.runPlug('ExpMoreInput', params)
+    },
+
+    /**
+     * 消息响应函数-刷新
+     * @method
+     */
+    onRefresh()
+    {
+      this.selected = null
+      this.selection = []
+      this.$refs.datagrid.$refs.gridtable.$refs.table.clearSelection()
+      this.refresh()
+    },
+
+    /**
+     * 消息响应函数-刷新一条记录
+     * @method
+     */
+    onRefreshA()
+    {
+      this.refreshA()
+    },
+
+    /**
+     * 事件 edit-row 响应函数
+     * @param   {Number}    oldRowIndex     旧行
+     * @param   {Number}    newRowIndex     新行
+     */
+    onEditRow(oldRowIndex, newRowIndex)
+    {
+    },
+
+    /**
+     * 取当前选中的行
+     * @method
+     * @returns {Object}
+     */
+    getSelected()
+    {
+      return this.selected
+    },
+
+    /**
+     * 返回当前行
+     * @method
+     * @returns {Object}
+     */
+    getCur()
+    {
+      return this.selected
+    },
+
+    /**
+     * 获取缺省的datagrid列字段信息
+     * @method
+     * @returns {Array}                     返回datagrid列字段
+     */
+    getDefCols()
+    {
+      return cx.datagrid.getDefCols(this.attObj.flds, this.sortable)
+    },
+
+    /**
+     * 获取datagrid列字段信息
+     * @method
+     * @returns {Array}                     返回datagrid列字段
+     */
+    getCols()
+    {
+      return this.getDefCols()
+    },
+
+    /**
+     * 获取datagrid列信息
+     * @method
+     * @returns {Array}
+     * @example
+     *    [{colname: String, [title: String], width: Number, [align: Number = cx.consts.ALIGN_CENTER], [sortable: Boolean = true]}]
+     */
+    getColInfs()
+    {
+      return []
+    },
+
+    /**
+     * 重新计算opers
+     * @method
+     * @param   {Array}   operCols      操作列
+     * @returns {Object}                this
+     */
+    makeOpers(operCols)
+    {
+      this.opers = []
+      for (let operCol of operCols)
+      {
+        for (let btn of operCol.btns)
+        {
+          btn.keyAble = btn.name + 'able_'
+          btn.keyShow = btn.name + 'show_'
+          this.opers.push(btn)
+        }
+      }
+    },
+
+    /**
+     * 计算各种操作的状态
+     * @method
+     * @param   {Object}    att         属性
+     * @returns {Object}                this
+     */
+    calcOpers(att)
+    {
+      for (let oper of this.opers)
+      {
+        att[oper.keyAble] = oper.enable(att)
+        att[oper.keyShow] = oper.show(att)
+      }
+    },
+
+    /**
+     * 取操作按钮信息
+     * @method
+     * @returns {Array}
+     * @example
+     *     [{colname: String,
+     *       title: String,
+     *       width: Number,
+     *       [align: String = 'center']
+     *       btns: [{name: String, title: String, onClick: Function}]
+     *     }]
+     */
+    getOpers()
+    {
+      // 增/删/改/查操作
+      const operCol = this.getColOper()
+      this.addOperView(operCol)
+        .addOperEdit(operCol)
+        .addOperDel(operCol)
+        .setAttOper(operCol)
+
+      return [operCol]
+    },
+
+    /**
+     * 设置属性相关的按钮
+     * @method
+     * @abstract
+     * @param   {Object}  operCol     操作列
+     * @returns {Object}              this
+     */
+    setAttOper(operCol)
+    {
+      return this
+    },
+
+    /**
+     * 操作列
+     * @method
+     * @returns {Object}
+     */
+    getColOper()
+    {
+      return { colname: 'rud_', title: this.$locBase('oper'), width: this.editable ? 95 : 70, align: 'center', btns: [] }
+    },
+
+    /**
+     * 增加操作-浏览
+     * @method
+     * @param   {Object}  operCol     操作列
+     * @returns {Object}              this
+     */
+    addOperView(operCol)
+    {
+      const oper = cx.datagrid.getOper('view_', this.$locBase('view'), '')
+
+      oper.enable = (att) => true
+      oper.show = (att) => !this.editable || !!att.completed || (this.editable && !!att.procinstid)
+      oper.onClick = (att) =>
+      {
+        this._view(att)
+      }
+
+      this.operView(oper)
+      operCol.btns.push(oper)
+      return this
+    },
+
+    /**
+     * 增加操作-编辑
+     * @method
+     * @param   {Object}  operCol     操作列
+     * @returns {Object}              this
+     */
+    addOperEdit(operCol)
+    {
+      const oper = cx.datagrid.getOper('edit_', this.$locBase('edit'), '')
+
+      oper.type = 'warning'
+      oper.enable = (att) => true
+      oper.show = (att) => !!this.editable && !att.completed && !att.procinstid
+      oper.onClick = (att) =>
+      {
+        this._upd(att)
+      }
+
+      this.operEdit(oper)
+      operCol.btns.push(oper)
+      return this
+    },
+
+    /**
+     * 增加操作-删除
+     * @method
+     * @param   {Object}  operCol     操作列
+     * @returns {Object}              this
+     */
+    addOperDel(operCol)
+    {
+      const oper = cx.datagrid.getOper('del_', this.$locBase('del'), '')
+
+      oper.type = 'danger'
+      oper.enable = (att) => true
+      oper.show = (att) => !!this.editable && !att.completed && !att.bill
+      oper.onClick = (att) =>
+      {
+        this._del(att)
+      }
+
+      this.operDel(oper)
+      operCol.btns.push(oper)
+      return this
+    },
+
+    /**
+     * 增加操作-完成->未完成
+     * @method
+     * @param   {Object}  operCol     操作列
+     * @returns {Object}              this
+     */
+    addOperCompelete(operCol)
+    {
+      const oper = cx.datagrid.getOper('uncomp_', this.$loc('cx.btnUncompelete'), '')
+
+      oper.type = 'warning'
+      oper.enable = (att) => true
+      oper.show = (att) => !!this.editable && att.completed && !att.procinstid
+      oper.onClick = (att) =>
+      {
+        this._complete(att, 0)
+      }
+
+      operCol.btns.push(oper)
+      return this
+    },
+
+    /**
+     * 增加操作-详情
+     * @method
+     * @param   {Object}  operCol     操作列
+     * @returns {Object}              this
+     */
+    addOperDetail(operCol)
+    {
+      const oper = cx.datagrid.getOper('detail_', this.$locBase('detail'), '')
+
+      oper.enable = (att) => true
+      oper.show = (att) => att.procinstid
+      oper.onClick = (att) =>
+      {
+        this._detail(att)
+      }
+
+      operCol.btns.push(oper)
+      return this
+    },
+
+    /**
+     * 定制函数-操作/查看
+     * @method
+     * @param   {Object}    oper      操作对象
+     */
+    operView(oper)
+    {
+    },
+
+    /**
+     * 定制函数-操作/编辑
+     * @method
+     * @param   {Object}    oper      操作对象
+     */
+    operEdit(oper)
+    {
+    },
+
+    /**
+     * 定制函数-操作/删除
+     * @method
+     * @param   {Object}    oper      操作对象
+     */
+    operDel(oper)
+    {
+    },
+
+    /**
+     * 异常处理函数
+     * @method
+     * @param   {Object}   err     异常对象
+     */
+    onError(err)
+    {
+      // this.$processing.close()
+      this.$showRet(err)
+    },
+
+    /**
+     * 刷新
+     * @method
+     */
+    refresh()
+    {
+      if (this.dg.pages)
+      {
+        this.queryPara.init = 0                     // 重新查询
+        this.queryPara.pageno = 1
+        this.queryPara.pagesize = this.dg.page.pageSize
+      }
+      this.query()
+    },
+
+    /**
+     * 刷新一条记录
+     * @method
+     */
+    refreshA(att)
+    {
+      if (!att)
+        att = this.selected
+      if (!att)
+        return
+
+      cx.svr.data.queryId(this.major, this.minor, att.id)
+        .then(ret =>
+        {
+          this.gridUpd(ret, att)
+        })
+    },
+
+    /**
+     * 更新列的宽度
+     */
+    updColsWidth()
+    {
+      cx.datagrid.makeColsFitWidth(this.cols, this.list, this.maxColWidth, this.fontSize, this.padding)
+    },
+
+    /**
+     * 向数据库发查询请求
+     * @method
+     */
+    query()
+    {
+      // 回调函数
+      const onSuccess = ret =>
+      {
+        let data = [], total = 0
+        let att
+
+        this.$processing.close()
+        cx.array.clear(this.dg.table.list)
+
+        if (ret instanceof Array)
+        {
+          data = ret
+          total = 0
+        }
+        else
+        {
+          data = ret.data
+          total = ret.total
+        }
+        // if (ret.length > 0)
+        // {
+        //   // eslint-disable-next-line
+        //   if (ret.total != undefined)
+        //   {
+        //     data = ret.data
+        //     total = ret.total
+        //   }
+        //   else
+        //   {
+        //     data = ret
+        //     total = 0
+        //   }
+        // }
+        cx.array.appendArr(this.list, data)
+
+        // 当前选中行还在不在？
+        if (this.selected)
+        {
+          if (!cx.array.get1(data, { id: this.selected }))
+            this.selected = null
+        }
+
+        // 显示数据
+        for (att of data)
+          this.getDisp(att)
+
+        this.afterQuery()
+
+        // 根据数据和字段更新列宽度
+        if (this.dynaWidth)
+          this.updColsWidth()
+
+        if (this.dg.pages)
+        {
+          if (!this.queryPara.init)
+          {
+            this.queryPara.init = 1
+            this.dg.page.total = total
+          }
+        }
+      }
+
+      // 装配参数
+      if (this.sqlCfg.key)
+      {
+        this.queryPara._key = this.sqlCfg.key
+
+        // eslint-disable-next-line
+        if (this.sqlCfg.vals != undefined && this.sqlCfg.vals != null && this.sqlCfg.vals !== '')
+          this.queryPara.vals = this.sqlCfg.vals
+
+        if (this.sqlCfg.orderby)
+          this.queryPara.orderby = this.sqlCfg.orderby
+        if (this.sqlCfg.args)
+          this.queryPara.args = this.sqlCfg.args
+      }
+      if (this.orderby)
+        this.queryPara.orderby = this.orderby
+
+      if (this.queryPara.args.length < 1 && !this.sqlCfg.key)   // 如果没有条件表达式
+      {
+        if (this.noExpDispAll)                                  // 没有查询条件显示所有数据
+        {
+          this.queryPara.args = [['id', '>', 0]]
+          this.queryPara.orderby = 'id desc'
+        }
+        else
+          return
+      }
+      if (!this.queryPara.args)
+        delete this.queryPara.args
+
+      this.beforeQuery()
+      this.runSvr(onSuccess)
+    },
+
+    /**
+     * 调取服务进行查询
+     * @method
+     * @param  {Function}  onSuccess  查询成功后的回调函数
+     */
+    runSvr(onSuccess)
+    {
+      // 发起调用
+      this.$processing.show()
+      cx.svr.data.query(this.major, this.minor, this.queryPara)
+        .then(onSuccess)
+        .catch(err =>
+        {
+          this.$processing.close()
+          this.onError(err)
+        })
+    },
+
+    /**
+     * 产生查询参数
+     * @method
+     */
+    makeQueryPara()
+    {
+      const exp = cx.sqlexp.getDefExp()                   // 空表达式
+
+      cx.sqlexp.merge(exp, this.fixedExp, this.attExp)
+      this.queryPara = cx.sqlexp.queryPara(exp, this.dg.pages ? this.dg.page.pageSize : 0)
+    },
+
+    /**
+     * 根据当前的查询条件，返回数据，导出数据
+     * @returns {Promise}
+     */
+    exportData()
+    {
+      const self = this
+      const sqlCfg = self.sqlCfg
+      const exp = cx.sqlexp.getDefExp()                   // 空表达式
+      cx.sqlexp.merge(exp, self.fixedExp, self.attExp)
+
+      const params = cx.sqlexp.queryPara(exp, 0)
+
+      if (sqlCfg.key)
+      {
+        params._key = sqlCfg.key
+
+        // eslint-disable-next-line
+        if (sqlCfg.vals != undefined && sqlCfg.vals != null && sqlCfg.vals !== '')
+          params.vals = sqlCfg.vals
+
+        if (sqlCfg.orderby)
+          params.orderby = sqlCfg.orderby
+        if (sqlCfg.args)
+          params.args = sqlCfg.args
+      }
+      if (self.orderby)
+        params.orderby = self.orderby
+
+      if (params.args.length < 1 && !sqlCfg.key)   // 如果没有条件表达式
+      {
+        if (self.noExpDispAll)                     // 没有查询条件显示所有数据
+        {
+          params.args = [['id', '>', 0]]
+          params.orderby = 'id desc'
+        }
+      }
+      if (params.args.length < 1)
+        delete params.args
+
+      // 发起调用
+      return cx.svr.data.query(self.major, self.minor, params)
+        .then(ret =>
+        {
+          for (let att of ret)
+            self.getDisp(att)
+
+          return ret
+        })
+    },
+
+    /**
+     * 根据当前的getCols()，取当前显示的列名
+     * @returns { cols: Array.<String>, colInfs: {colname: {_label: ..., }} }
+     */
+    getDispCols()
+    {
+      const _cols = this.getCols()
+      const cols = [], colInfs = {}
+      let colname, title
+
+      _cols.forEach(item =>
+      {
+        colname = item.colname
+        title = item.title
+        // eslint-disable-next-line
+        if (colname[0] == '_')
+          colname = colname.substring(1)
+        cols.push(colname)
+        if (title)
+          colInfs[colname] = { _label: title }
+      })
+      return { cols, colInfs }
+    },
+
+    /**
+     * 取对象的显示信息
+     * @method
+     * @param   {Object}  att       属性对象
+     * @returns {Object}            this
+     */
+    getDisp(att)
+    {
+      this._getDisp(att)
+      return this
+    },
+
+    /**
+     * 取对象的显示信息
+     * @method
+     * @private
+     * @param   {Object}  att       属性对象
+     * @returns {Object}            this
+     */
+    _getDisp(att)
+    {
+      this.attObj.numberize(att)
+      this.attObj.decode(att)
+      this.attObj.getDisp(att)
+      if (att.completed !== undefined)
+      {
+        if (att.completed)
+          att._completed = cx.consts.TEXT_COMPLETED
+        else
+          att._completed = ''
+      }
+      this.calcOpers(att)
+      return this
+    },
+
+    /**
+     * 添加新项到datagrid列表
+     * @method
+     * @param  {Object}    attNew    新属性
+     */
+    gridAdd(attNew)
+    {
+      this.getDisp(attNew)
+      cx.array.insert(this.list, attNew)
+    },
+
+    /**
+     * 从datagrid删除项
+     * @method
+     * @param  {Object}    attOld    旧属性
+     */
+    gridDel(attOld)
+    {
+      cx.array.remove(this.list, { id: attOld.id })
+      // eslint-disable-next-line
+      if (this.selected && this.selected.id == attOld.id)
+        this.selected = null
+    },
+
+    /**
+     * 更新datagrid项
+     * @method
+     * @param  {Object}    attNew    新属性
+     * @param  {Object}    attOld    旧属性
+     */
+    gridUpd(attNew, attOld)
+    {
+      let item, i, j
+
+      for (i = this.list.length - 1; i >= 0; i--)
+      {
+        item = this.list[i]
+        // eslint-disable-next-line
+        if (item.id == attNew.id)
+        {
+          for (j in attNew)
+            item[j] = attNew[j]
+          this.getDisp(item)
+        }
+      }
+    },
+
+    /**
+     * 生成用户自定义的条件表达式,放在attExp对象里面
+     * @method
+     * @returns {Boolean}               是否正确生成表达式
+     */
+    makeAttExp()
+    {
+      const exp = cx.sqlexp.getDefExp()   // 空表达式
+      const attExp = this.getExp()
+
+      cx.sqlexp.merge(exp, attExp)
+      this.attExp = exp
+      return true
+    },
+
+    /**
+     * 提交-增加
+     * @method
+     * @param   {Object}    att         新属性
+     */
+    submitAdd(att)
+    {
+      if (!this.beforeAdd(att))
+      {
+        return new Promise((resolve) =>
+        {
+          resolve(false)
+        })
+      }
+      return cx.svr.attOper.insert(this.major, this.minor, att, this.retAtt)
+        .then(ret =>
+        {
+          return true
+          // 这里没有额外代码，是因为该类增加了数据增删改监听
+        })
+    },
+
+    /**
+     * 提交-删除
+     * @method
+     * @param  {Object}  att    属性
+     */
+    submitDel(att)
+    {
+      if (!att)
+        return
+      if (!this.beforeDel(att))
+        return
+
+      // cx.svr.doc.delEntity({ major: this.major, minor: this.minor, entityid: att.id })
+      //  .then(ret =>
+      //  {
+      cx.svr.attOper.del(this.major, this.minor, att)
+        .then(ret =>
+        {
+          // eslint-disable-next-line
+          if (att == this.selected)
+            this.selected = null
+
+          // 这里没有额外代码，是因为该类增加了数据增删改监听
+        })
+        .catch(this.onError)
+      //  })
+      //  .catch(this.onError)
+    },
+
+    /**
+     * 提交-修改
+     * @method
+     * @param   {Object}    attNew      新属性
+     * @param   {Object}    attOld      旧属性
+     */
+    submitUpd(attNew, attOld)
+    {
+      return new Promise((resolve) =>
+      {
+        resolve(true)
+      })
+      // 这里没有额外代码，是因为该类增加了数据增删改监听，并且很多地方是界面提供了修改数据功能
+    },
+
+    /**
+     * 提交-开启/关闭
+     * @method
+     * @param   {Object}  att           新属性
+     * @param   {Number}  state         状态值(0-未结束 1-结束)
+     */
+    submitComp(att, state)
+    {
+      const attNew =
+      {
+        id: att.id,
+        completed: state,
+        cols: 'completed'
+      }
+
+      if (state === 0)
+      {
+        attNew.procinstid = ''
+        attNew.bill = ''
+      }
+
+      cx.svr.attOper.update(this.major, this.minor, attNew, att)
+        .then(ret =>
+        {
+          // this.afterUpd(att)
+          // this.gridUpd(attNew, att)
+        })
+        .catch(this.onError)
+    },
+
+    /**
+     * 根据属性删除实体
+     * @private
+     * @method
+     * @param  {Object}  att    属性
+     */
+    _del(att)
+    {
+      if (!att)
+        return
+
+      this.$cfm('del')
+        .then(() =>
+        {
+          this.submitDel(att)
+        })
+        .catch(() =>
+        {
+        })
+    },
+
+    /**
+     * 根据属性查看实体
+     * @private
+     * @method
+     * @param  {Object}  att    属性
+     */
+    _view(att)
+    {
+      if (!att)
+        return
+
+      const params =
+      {
+        major: this.major,
+        minor: this.minor,
+        att,
+        editable: false,
+        title: this.getEntityName(),
+        closable: true
+      }
+      cx.run.runPlug(this.getPluginName(cx.consts.ATT_VIEW, att), params, { modal: 0 })
+    },
+
+    /**
+     * 根据属性编辑实体
+     * @private
+     * @method
+     * @param   {Object}  att                 属性
+     * @param   {Boolean} [changed = false]   数据改变标记
+     */
+    _upd(att, changed)
+    {
+      if (!att)
+        return
+
+      const params =
+      {
+        major: this.major,
+        minor: this.minor,
+        editable: true,
+        att,
+        title: this.getEntityName(),
+        retAtt: this.retAtt,
+        beforeUpd: (att) => this.beforeUpd(att),
+        onOk: (attNew, attOld) => this.submitUpd(attNew, attOld)
+      }
+      if (changed)
+        params.changed = !!changed
+
+      cx.run.runPlug(this.getPluginName(cx.consts.ATT_EDIT, att), params, { modal: 0 })
+    },
+
+    /**
+     * 根据属性开启/关闭
+     * @private
+     * @method
+     * @param  {Object}  att    属性
+     * @param  {Number}  state  状态值(0-未结束 1-结束)
+     */
+    _complete(att, state)
+    {
+      if (!att)
+        return
+
+      this.$cfmMsg(this.$loc('cx.cfmUncomplete'))
+        .then(() =>
+        {
+          this.submitComp(att, state)
+        })
+        .catch(() =>
+        {
+        })
+    },
+
+    /**
+     * 根据属性查看详情
+     * @private
+     * @method
+     * @param  {Object}  att    属性
+     */
+    _detail(att)
+    {
+      if (!att)
+        return
+      
+      // 查找表对应的流程
+      const proc = cx.array.get1($g.init.procs, { tabname: this.entity.name })
+
+      if (proc)
+      {
+        const plug = proc.plugins.detail
+
+        if (plug)
+        {
+          const params =
+          {
+            major: this.major,
+            minor: this.minor,
+            att,
+            editable: false,
+            task: null
+          }
+          // 上面没有传 comments 参数
+
+          cx.base.execute(plug, [params])
+        }
+      }
+    },
+
+    /**
+     * 根据ID删除实体
+     * @method
+     * @param  {Number}  id    ID
+     */
+    del(id)
+    {
+      this._del(cx.array.get1(this.list, { id: parseInt(id) }))
+    },
+
+    /**
+     * 根据ID删除实体
+     * @method
+     * @param  {Number}  id    ID
+     */
+    view(id)
+    {
+      this._view(cx.array.get1(this.list, { id: parseInt(id) }))
+    },
+
+    /**
+     * 根据ID修改实体
+     * @method
+     * @param  {Number}  id    ID
+     */
+    upd(id)
+    {
+      this._upd(cx.array.get1(this.list, { id: parseInt(id) }))
+    },
+
+    /**
+     * 根据ID开启
+     * @method
+     * @param  {Number}  id    ID
+     */
+    complete(id)
+    {
+      this._complete(cx.array.get1(this.list, { id: parseInt(id) }), 0)
+    },
+
+    /**
+     * 根据ID修改实体
+     * @method
+     * @param  {Number}  id    ID
+     */
+    detail(id)
+    {
+      this._detail(cx.array.get1(this.list, { id: parseInt(id) }))
+    },
+
+    /**
+     * 消息响应函数-添加
+     * @method
+     */
+    onAdd()
+    {
+      // 弹出输入界面
+      const params =
+      {
+        major: this.major,
+        minor: this.minor,
+        att: this.defVal(),
+        title: this.getEntityName(),
+        onOk: (att) => this.submitAdd(att)
+      }
+
+      cx.run.runPlug(this.getPluginName(cx.consts.ATT_ADD, null), params, {})
+    },
+
+    /**
+     * 带属性进行添加操作
+     * @param   {Object}      att           带进来的属性信息
+     * @param   {String}      [title]       带进来的标题
+     * @method
+     */
+    addWithAtt(att, title)
+    {
+      // 弹出输入界面
+      const params =
+       {
+         major: this.major,
+         minor: this.minor,
+         att: this.defVal(),
+         title: title ? title : this.getEntityName(),
+         onOk: (att) => this.submitAdd(att)
+       }
+
+      cx.base.extend(params.att, att)
+ 
+      cx.run.runPlug(this.getPluginName(cx.consts.ATT_ADD, null), params, {})
+    },
+ 
+    /**
+     * 消息响应函数-删除
+     * @method
+     */
+    onDel()
+    {
+      this._del(this.getCur())
+    },
+
+    /**
+     * 消息响应函数-修改
+     * @method
+     */
+    onUpd()
+    {
+      this._upd(this.getCur())
+    },
+
+    /**
+     * 消息响应函数-明细
+     * @method
+     */
+    onDetail()
+    {
+      const att = this.getCur()
+      if (att)
+        this.detail(att.id)
+    },
+
+    /**
+     * 取默认值
+     * @method
+     * @returns {Object}        默认属性(如果没有缓存数据，则返回NULL)
+     */
+    defVal()
+    {
+      const att = this.attObj.getDefVal()
+      cx.att.getCacheAtt(this.major, this.minor, att)
+      this.initAtt(att)
+      return att
+    },
+
+    /**
+     * 用于输入属性之前，在派生类初始化属性（特殊情况下修改字段值）
+     * @method
+     * @param  {Object}  att      属性对象
+     */
+    initAtt(att)
+    {
+    },
+
+    /**
+     * 添加属性之前的接口
+     * @method
+     * @param  {Object}  att      属性对象
+     */
+    beforeAdd(att)
+    {
+      this.attObj.encode(att)
+      return true
+    },
+
+    /**
+     * 添加属性之后的接口
+     * @method
+     * @param  {Object}  att      属性对象
+     */
+    afterAdd(att)
+    {
+    },
+
+    /**
+     * 删除属性之前的接口
+     * @method
+     * @param  {Object}  att      属性对象
+     */
+    beforeDel(att)
+    {
+      return true
+    },
+
+    /**
+     * 删除属性之后的接口
+     * @method
+     * @param  {Object}  att      属性对象
+     */
+    afterDel(att)
+    {
+    },
+
+    /**
+     * 修改属性之前的接口
+     * @method
+     * @param  {Object}  att      属性对象
+     */
+    beforeUpd(att)
+    {
+      this.attObj.encode(att)
+      return true
+    },
+
+    /**
+     * 修改属性之后的接口
+     * @method
+     * @param  {Object}  att      属性对象
+     */
+    afterUpd(att)
+    {
+    },
+
+    /**
+     * 查询之后的接口
+     * @method
+     */
+    afterQuery()
+    {
+    },
+
+    /**
+     * 查询之前的接口
+     * @method
+     */
+    beforeQuery()
+    {
+    },
+
+    /**
+     * 取实体信息
+     * @method
+     * @returns {Object}          返回实体信息
+     */
+    getEntity()
+    {
+      return this.entity
+    },
+
+    /**
+     * 取实体名称
+     * @method
+     * @returns {String}          返回实体信息
+     */
+    getEntityName()
+    {
+      return cx.i18n.locEntity(this.entity)
+    },
+
+    /**
+     * 取插件名
+     * @method
+     * @param   {Number}  type      类型
+     * @param   {Object}  [att]     属性(当前需要发起流程的属性)
+     * @returns {String}
+     */
+    getPluginName(type, att)
+    {
+      switch (type)
+      {
+      case cx.consts.PROC_START: return 'ProcStart'
+      case cx.consts.PROC_PROGRESS: return 'ProcProgress'
+      case cx.consts.PROC_TRACE: return 'ProcTrace'
+      case cx.consts.ATT_ADD:
+        return 'AttInput'
+      case cx.consts.ATT_EDIT:
+      case cx.consts.ATT_VIEW:
+        return 'AttEdit'
+      }
+      return ''
+    }
+  }
+}