表单-数据表格的配置方法-流程设计-O2OA企业应用开发平台-人人都是协同系统开发专家

表单-数据表格的配置方法

时间：2022-08-03

本文主要介绍如何在O2OA中进行审批流程表单或者工作流表单设计，O2OA主要采用拖拽可视化开发的方式完成流程表单的设计和配置，不需要过多的代码编写，业务人员可以直接进行修改操作。

一、数据表格组件简介

O2OA V6.2之前，平台的表格式形式数据展现依赖的组件是数据网格。数据网格主要特性如下：

1. 以表格形式提供用户使用，每行一组数据；

2. 支持列的总计功能；

3. 支持多行同时编辑或每次编辑单行；

4. 支持使用Excel批量导入导出数据；

5. 提供各种事件接口以支持自定义功能。

从V6.2开始，O2OA开发平台的表单和页面中增加了数据表格组件。数据表格组件主要是优化了数据结构，增加了同时编辑多行的功，其使用的便捷性以及展示效果均优于原来的数据网络组件，所以在V6.2之后的版本数据网格组件逐渐废弃。

数据表格是多行字段编辑组件，设计人员可以在数据表格中添加列，并往列中拖动基础组件（如：文本组件、数字组件、下拉组件等）以提供给用户使用。

注：如果需要自定义界面实现多行字段编辑组件，而不是只限于表格形式，请使用“数据模板”组件来实现。

数据表格设计界面如下图所示：

最终用户界面展示效果如下图所示：

在移动端界面展示的效果如下图所示：

二、数据表格的设计与配置说明

1. 数据表格的数据结构

数据表格保存在后台以及脚本通过this.data.xxx或this.form.get("xxx").getData()获取的数据。系统响应的数据结构如下：

2. 数据表格的设置项

1）基本属性设置：

基本属性设置项详细说明：

配置项	内容	说明
标识	id	脚本中获取该字段的关键字，以及保存在数据库中的key。
名称	字段名称
描述	字段描述
编辑方式	每次编辑单行同时编辑多行
默认数据	脚本	可以返回数据表格默认值。可以通过return [] 或 return {"data":[] , "total": {} } 两种方式返回数据，返回数组表示条目，返回对象表示条目和总计。可以通过this.target;获取组件。
数量	默认显示	如果没有默认数据脚本的时候，默认显示的条目数。每次编辑单行时无效。
	最多添加	允许用户最多添加的条目数。
	最少保留	允许用户最少保留的条目数。
权限	允许编辑	填写脚本，最终return true; 或 return false; 表示是否允许编辑，默认为允许编辑。可以通过this.target;获取组件。
	允许添加	可选，当允许编辑的时候生效
	允许删除	可选，当允许编辑的时候生效
导入导出		允许用户使用EXCEL导出数据，导入数据。导入数据时会覆盖之前填写的数据。序号、图片、附件和隐藏列不能导入导出。当执行导入的时候，系统会根据组件的类型、人员组织的有效性、组件的校验设置进行导入数据的校验。
导入导出-启用	禁用	不允许导入导出
	导出导入	允许导入导出，导入仅在编辑状态下有效
	仅导出	允许导出数据
	仅导入	允许导入，但仅在编辑状态下有效
导入导出-按钮位置		导入导出按钮相对于数据表格的位置
导入导出-导入按钮样式		设置导入按钮显示的文本
导入导出-导入按钮样式		设置导入按钮的样式
导入导出-导出按钮样式		设置导出按钮显示的文本
导入导出-导出按钮样式		设置导出按钮的样式
导入导出-导出文件名称	脚本	返回导出的文件名称。如：return "报销申请表";

2）样式属性设置：

样式设置允许开发人员配置数据网格界面上各个部分样式。如下图所示：

各个配置项作用的位置如下图所示：

移动端界面样式定义项如下图所：

3）数据表格区段属性设置

区段：是流程多人处理或者拆分的时候，支持用户独立编辑数据的一种设计。区段依据为数据拆分存储的关键字。

区段属性设置项如下图所示：

配置项	内容	说明
区段依据	处理人	等于：this.workContext.getWork().creatorIdentityDn（前台脚本）或 this.workContext.getWork().creatorIdentity（后台脚本）
	处理人所在组织	等于：this.workContext.getWork().creatorUnitDn（前台脚本）或 this.workContext.getWork().creatorUnit（后台脚本）
	活动ID	等于：this.workContext.getWork().activity
	拆分值	等于：this.workContext.getWork().splitValue
	脚本	返回具体的文本，如: return this.data.fileld1