PredefinedValues不仅可以用在布尔型中,也可以用在其它所有类型中(在数值及日期中也可以使用),同时它的优先级最高,定义了PredefinedValues后,则会忽略其自身的下拉选择,如果用在枚举中,要保证与枚举顺序保持一致
默认情况下,在Excel模板中必填列的标头文本会加粗,如感觉不明显或想着重强调,可以修改相应的样式,NumberFormat对应着单元格的数值格式,可以通过它设置格式中数值或日期的显示格式。
如果我们没有设置列的Caption属性,它将采用BO中定义的Caption,如果BO的Caption也为空,则采用BO类型的Name属性。同时可以用它来适配外来的Excel工作表,这样就可以不用修改Excel工作表原有标头文本,通过与其它参数配合,可以实现外来Excel工作表直接导入。
在Excel模板中我们一般不需要对列进行隐藏,但有时我们需要通过导入来更新时,有时需要Oid等字段,如果我们不想显示出来,可以对其进行隐藏,只是进行了隐藏,用户可以轻松的显示出来,无法通过它隐藏数据
本模块中引用类型默认不下拉选择,这主要基于安全考虑,由于引用类型下拉选择数据源中的数据并不是面向所有用户的,所以不能把不相关的都显示出来,这里需要单独的定义,可以通过PredefinedValues或DataSoruceCriteria,而DataSoruceCriteria可以通过表达式来限制数据源的显示。
一般验证错误是不需要忽略的,但有时我们提供了下拉选择,也允许用户输入下拉列表之外的内容时,就需要忽略验证错误,这样Excel不会阻止用户的输入
有时我们要保证数据的完整性,要求用户输入比较完整的信息,在Model中定义的列,如果是必填的,那么在导入时首先会检查Excel工作表对应的列是否存在,如果不存在则无法导入,而对于不是必填的列,由于Excel的灵活性,用户可以很轻松的删除,我们可以将MustIncludeColumn设为True,这样缺少当前列时将无法成功导入。
默认值一般用在当用户没有输入值时采用的值,格式为Criteria表达式。同时默认值还有一种使用场景,与VisibleInTemplate结合使用,当VisibleInTemplate为False,当前列不会显示在Excel模板中,可以通过设置默认值,用于它的初始值,例如:当我们希望用户导入的数据只在他自己所在的部门,但我们又不想用户自己选择部门,就可以通过这种方式。
这里的不显示就是不在Excel模板中创建列,Excel模板不会包含它,与ColumnVisible是不一样的,ColumnVisible会将列包含在Excel模板中,而VisibleInTemplate一般主要用于不想要用户自己输入,可以结合DefaultValue一起使用
模板中的列默认都是更新的,但有时我们是不需要更新的,比如在盘点时,我们只更新数量,但其它的列则是展示列没有必要更新,再比如,当用户表中部分用户手机号错误或不全时,需要比对确认,那么在导入时,我们希望只更新手机号
一般主要用在引用类型的查找,通过设置Criteria来查找引用类型,同时也可以通过它来实现数据的转换,如下面在导入时在用户名的前面加上USER。ValueCriteria扩展性很强,可以使用XAF中的表达式函数,也可以使用自定义表达式函数
导出Excel模板时包含视图数据,这里的视图数据是视图查询出来的可显现数据,主要用在数据更新,可以对导出的数据进行修改,然后再次导入
主键主要用于更新,主键不一定是BO的真实主键,也可以是其它的唯一字段,如果不是BO的主键,需要设置KeyCriteria
导入数据方式是导入数据时创建BO对象的方式,有4种导入方式
- 同步(Synchronize),它不仅创建不存在的数据,同时还会更新已存在的数据(默认行为)
- 仅创建(OnlyCreation),它只创建不存在的数据,已存在的数据不会更新
- 仅更新(OnlyUpdate),不存在的数据不会创建,更新已存在的数据
- 全创建(AllCreation),不管是否存在都会创建
由于Excel的灵活性,无法避免错误的产生,如果导入时对数据验证不通过时,则将其显示在相应的单元格中,如果验证错误没有对应的单元格,则将其错误信息放在对应行的第一个单元格中。错误单元的背景可以通过ErrorBackgroundColor来设置,为空时将采用默认背景颜色。
数据验证是导入数据的保障,本模块中会依次采用下面的方式进行数据验证
- 数据类型的验证
- 模板中定义的最大值,最小值
- BO中定义的规则
- 模板中自定义的规则
欢迎光临 ToB企服应用市场:ToB评测及商务社交产业平台 (https://dis.qidao123.com/) | Powered by Discuz! X3.4 |