报表/报告组件(二)-实例与实现解释
上篇《报表/报告组件(一)-指标/属性组件设计》介绍了组件核心指标/属性设计,本文以实例介绍各个特性的实现和效果,实例是多个报告融合,显示所有的特性。
设计
指标/属性组件是报告/报表关键部分,上篇已介绍过,本节回顾一下
指标模型 指标可有多个测量字段,满足专业和挑剔的显示样式,格式,数值精度和范围需要
> 格式(format) 支持多个字段合并显示的格式,例如,颜色指标RGB,录入3个字段,显示使用格式 R/G/B 或 R-G-B等,带上样式,R/G/B
> 单位
> 类型 TEXT/NUMBER/DATETIME, ... 可扩展
> 参考范围, 精度
参考范围 数值的合理值/正常值,分为基准参考和范围参考
精度 测量的有效值,通常超过精度适用>xxx, <yyy展示,不使用原本值
> 验证指标数值
> 样式规范,底色/图标资源/字体,设定与精度,范围相关
> 图片类型字段,图表类型字段
> list类型字段,支持多行表格
> 图表类型,生成图表,导出图片
本组件使用MVC模式,M 模型,数据和数据存储;C 指输出器,承上(模型)启下(视图),一个数据可以输出docx,pdf,xlsx。。。;V 视图,如本文的示例,docx文档模板
实现解释
本节以实例说明各特性,实例是真实客户设备检测报告,为了介绍所有特性融合了多个报告内容,因此实例数据内容可能不是很相关。
数据模型
本节以单元测试解释数据模型的实现
回顾一下设计图,数据模型分两部分,左侧红圈部分指标/属性数据,右侧篮圈是指标/属性定义,包括报告类型,报告类型关联zhib/属性,指标,指标属性,下面以时间属性介绍
1. 指标/属性定义
> 指标组
下图新建指标组
> 指标和指标字段
下图新建指标和指标字段
上图构建指标,groupCode是上面的指标组,该指标有两个字段,均为日期类型,用于合并显示,组合出报告需要的日期格式
2. 报告类型,关联指标/属性
报告分类
关联指标
3. 报告,指标/属性数据
数据选择需要属于报告,也即需先新建报告,再写入数据
下图新建报告
报告对象也是三板斧,编码,名称,描述
报告数据分两部分,记录,对应指标,下图新建记录(Record),其中的reportId是上面新建的报告id
IndicatorCode对应的指标,实现记录是指标负责构建
下图是数据,指标报告时间(REPORT-DATETIME)的数据
上面通过单元测试构建核心对象,解释了各类对象的结构,下面详细解释不同类型的指标
合并显示
合并显示是一个指标多个字段合成一个字段显示,例如上面的RGB,录入的时候3个数值,R/G/B,显示是合为一个字段,RGB这是颜色的常用的显示方式。
> 指标模板
上图是报告模板, {{REPORT-DATETIME.报告日期}} 是替代符,REPORT-DATETIME是属性/指标编码,全局唯一,"报告日期"是属性/指标下的item。
> 数据
该指标和数据在上面数据模型介绍过,这里不重复
> 导出效果
报告日期的格式通过合并显示的format定义
段落文本/表格文本
这两类是最简单的文本显示,区别只是识别是段落,还是表格的段落
> 指标模板
> 数据
下图对应的指标和数据
> 导出效果
样式
样式大致分两类,一是显示状态,支持状态文本域联动;二是直接指定颜色
> 指标模板
下图指标模板定义,看着都一样,其实有三类的字段,翼根前面的叶片123是显示状态,颜色联动,前缘粘接是指定颜色,备注是图片类型
> 数据
1. 文本,文本与背景色联动
下图首先创建背景色感应器实现,BgAware,目前有两个实现,TextValueBgAware,支持背景色与文本联动;ConstBgAware,指定背景色
下图构建指标和指标字段项,字段项使用TextValueBgAware实现文本与颜色联动
下图数值,数值也可以设置TextValueBgAware,数值设置的优先级高
2. 指定背景色
下图构建指定背景色的数值
> 导出效果
测量数据
指标是设备的检测数据,该数据是周期性的,如,一天一测,有着严谨的数值表示,样式要求,例如,超限,超精度,要所见即所得
> 指标模板
> 数据
下图是测量指标字段项,可设置上下限,是否包括边界;上精度,下精度
指标/属性定义4个样式,分别是超上限,超下限,超上精度,超下精度
> 导出示例
图片
图片样式那节已经展示过
上图定义图片类型字段项,PNG类型,还有宽和高
相应地,数据是PicValue类型,itemName对应的item名称,value是地址,当然也可以支持minio,ftp等
列表
列表数据支持用户输入不定行的表格行,实例的列表数据是设备检测发现的损伤问题,不定行数,多少项填报多少项
> 指标定义
其中,@@是特殊符号,生成序列号
> 数据
下图列表行指标,行的列是字段项,listType设为true,标识此指标是列表指标
> 导出效果
图表
图表也属于计算指标/属性,使用报告的其他指标/属性,生成图表,本节以柱状图为例
> 指标/属性模板定义
图表的指标/属性的模板定义
> 数据
下图构建图表指标/属性,本文的示例图表都在一个指标下,一个字段对应一个图表
下图 柱状图图表字段项,图表有两个序列,Fe,Cu,每个序列有两个数据,本次和上次
图表没有数据写入,使用的是报告内的数据,上面数据是引用"指标数据"