# 视图开发进阶


// 视图Api

this.Api.openCreate() // 打开新建窗口
this.Api.exportDataEvent() // 导出全部数据
this.Api.exportSelectEvent() // 导出选中项
this.Api.openEditRow() // 打开编辑窗口
this.Api.openExportEvent() // 打出导出窗口
this.Api.openViewRow() // 打开详情窗口
this.Api.removeRow() // 删除行数据
this.Api.doChoose() // 选中项回调
this.Api.doQuery() // 执行查询操作
this.Api.setCheckboxRow() // 选中一些数据
this.Api.setAllCheckboxRow() // 全部选中
this.Api.clearCheckboxRow() // 全部取消选中
this.Api.getQueryElement() // 获取查询条件组件
this.Api.openProcess() // 打开流程processDefName流程定义名称(必填),pkId表单主键值(非必填)
this.Api.updateRow() // 更新单行数据
this.Api.mergeCells() // 合并单元格, 参数 [{ row: 0, col: 0, rowspan: 2, colspan: 1 }]
this.selectedItems  // 被选中的记录
this.condition // 查询条件对象

# 通用

视图中table的格式可根据不同场景设置不同布局,本部分将以"建筑工程基本情况汇总表"为示例进行配置讲解

# 多层复合表头

当数据结构比较复杂的时候,可以使用多层复合表头来更加直观的显示数据

  1. 添加分组:在视图设置-显示字段-添加分组中点击添加分组
  2. 分组内添加数据:拖拽行数据至分组当前行或分组内部
  3. 分组操作:可通过点击列名进行组名修改和删除分组

  1. 调整布局:拖拽对应行数据进行调整
  2. 名称修改:点击列名可进行名称修改

  1. 添加显示列:点击添加显示列,添加内容可选默认项目字段和自定义字段,自定义字段设置后可修改显示名称和绑定列名

  1. 样式调整:可配置显示,宽度,超宽,对齐,格式,锁定,排序

  1. 整体效果展示

# 表尾计算

通过表尾来实现合计、平均值功能

  1. 设置表尾计算:在视图设置-显示字段-表格设置中配置合计和平均值

  1. 整体效果展示

# 多选单选

单选表格、多选表格,用户手动选中时可添加触发事件selectChangeEvent

  1. 可选配置:在视图设置-显示字段-表格设置中配置可选

  1. 通过js初始化选中:在视图设置-高级设置-事件中进行配置

示例:使用this.Api.setAllCheckboxRow()进行全部选中

  1. 通过操作设置选中:在视图设置-动作设置-工具栏-添加自定义按钮中配置

整体效果展示

  1. 根据条件设置记录是否能选中:在视图设置-表格设置-可选中配置可选逻辑控制

点击设置可选逻辑控制后,会提示已经生成方法

在对应方法中进行代码配置,当表格中不存在有效数据时列头复选框为禁用状态

# 通过js控制单元格合并

合并行或列,通过this.Api.mergeCells()自定义合并方法

  1. 在视图设置-高级设置-事件中添加事件

  1. 使用this.Api.mergeCells()配置合并单元格

  1. 整体效果展示

# 筛选条件

使用筛选高级用法、动态更改筛选条件、自定义更加复杂的模板事件,处理复杂场景的筛选逻辑。

本部分将以"建筑工程基本情况汇总表"为示例进行配置讲解

# 添加查询条件

在视图设置-快速筛选进行查询条件配置

# 添加查询字段

点击添加筛选条件,选择筛选字段

# 配置筛选条件

设置默认值

整体效果展示

# 显示设置

视图展示支持多种数据格式,本部分将以"图书在版编目"为示例进行配置讲解

# 显示为链接

  1. 打开记录编辑窗⼝

方法一:在视图设置--动作设置-行内操作添加系统按钮打开编辑弹框

方法二:在视图设置--动作设置-行内操作添加自定义按钮

使用this.Api.openEditRow()打开编辑窗口

  1. 自定动作

按钮编辑可以选择打开弹框还是执行代码

示例:弹框打开当前表单

# 自定义输入

  1. 显示为checkbox控件,点击后调用服务

在视图设置-显示字段中,选择要配置得字段,格式设置为自定义

展示效果

  1. 显示为输入框,直接输⼊

在视图设置-显示字段中,选择要配置得字段,格式设置为自定义

代码配置如下

# 显示图片

在视图设置-显示字段中,选择要配置得字段,格式设置为自定义

配置如下

# 显示颜色控制

行的样色、单元格样式,表头的样式、表尾的样式、全部都可以完全自定义

  1. 在视图设置-高级设置-全局样式添加样式代码

  1. 配置方法

示例代码如下

# 整体效果展示

# 操作

主要介绍视图中权限控制和使用流程配置的过程

# 操作的权限控制

本部分将以"图书在版编目(权限配置)"为示例进行配置讲解

  1. 支持设置功能码与角色绑定

系统按钮添加功能码

自定义按钮添加功能码

afc添加权限码

角色授权:授权后的角色将允许使用对应功能

  1. 通过js动态控制只读

如果已启动权限码控制,此操作需确认权限码添加完成,并且授权角色后配置

系统按钮和自定义按钮均可以设置只读控制

系统按钮设置如下

自定义按钮设置如下

行内操作按钮设置如下

未配置只读效果

配置只读效果

  1. 通过js动态控制显示/隐藏

如果已启动权限码控制,此操作需确认权限码添加完成,并且授权角色后配置

系统按钮和自定义按钮均可以设置显示/隐藏控制

系统按钮设置如下

自定义按钮设置如下

行内操作按钮设置如下

配置显示效果

配置隐藏效果

# 发起记录对应的流程

本部分将以"购票流程"为示例进行配置讲解

一、表单发起记录对应流程

  1. 创建一个流程,并绑定对应表单

  2. 在表单设置-按钮设置中添加自定义按钮,配置如下

  1. 整体效果展示

二、视图发起记录对应流程

  1. 创建一个流程,并绑定对应表单

  2. 在视图设置-按钮设置中添加行内自定义按钮,配置如下

3.自定义按钮选择代码助手-打开流程,添加打开流程代码并添加参数pkId

4.整体效果展示

# 编码

本部分将以"图书在版编目(生命周期事件)"和"图书在版编目(生命周期事件2)"为示例进行配置讲解

# 支持生命周期事件

在视图设置-高级设置-事件下可以设置不同生命周期的事件

设置保存后系统会自动运行代码进行校验

  1. 视图加载前

配置如下

设置后效果展示

  1. 视图查询前

示例:通过js自定义查询条件

未设置查询条件时如下

设置查询条件如下

运行效果如下

  1. 视图查询后:操作同视图加载前一致,仅事件实现阶段不用

  2. 视图加载后:可参考设置选中操作设置选中操作

  3. 视图全选记录后:设置多选后,全选触发事件

配置如下

效果展示如下

  1. 视图选中记录后:设置多选后,勾选触发事件

示例:控制记录是否能选中

配置如下

使用this.Api.setCheckboxRow()进行是否允许选中控制

效果展示如下

上次更新: 2023/7/20下午12:25:28