Skip to end of metadata
Go to start of metadata

UReport2教学视频

UReport2 QQ群

UReport2的QQ群号:423339793

       在报表使用过程当中,不可避免的要使用函数及表达式实现一些数据的计算,在UReport2当中,很多地方都支持编写表达式,比如最典型的我们可以将单元格类型改为“表达式”,这样就可以在下面的表达式编辑器里输入相应的表达式与函数,除此之外,UReport2还允许我们在条件、图片来源、二维码数据来源等地方使用表达式,所以学习并掌握UReport2中提供的表达式,是制作复杂报表的前提。

基本语法

       与一般的编程语言类似,UReport2中的表达式也有一些基本的数据类型,比如数字、字符串等,如下表所示:

表达式类型描述示例
数字可以是一个整数,也可以是一个小数1、123、0.121331,这些都是合法的数字
字符串字符串需要用单引号或双引号包裹'ureport2'、"UReport2"、‘UReport2教程’,这些都是合法的字符串
布尔值布尔值表示是或否布尔就两个:true和false

       上述的有三种基本的数据类型,可以单独使用,也可以用“+”、"-"、"*"、"/"、"%"连接,进行组合运算,如下表所示:

操作符描述示例
+求两个数的和,或者是连接两个值21+31,这就表示求这两个数的和,结果就是52,“值:”+331则表示连接两个值,其结果就是“值:331”
-求两个数差21 - 31,这就表示求这两个数的差,结果就是-10
*求两个数的乘积3*6,结果就是18
/求两个数除的结果6/3,结果就是2,如果除不尽,则会保留8位小数
%求两个数除的余值5%3,结果是2;6%2结果是0

       UReport2中还提供了几种类型的条件判断运算符,我们首先来看一下三元表达式。

三元表达式

       基本所有的语言都支持三元表达式判断,它的特点是简洁明晰,可以用最少的代码进行条件判断,UReport2中的三元表达式语法结构如下图所示:

       可以看到,和普通的三元表达式一样,它的第一部分是条件部分,条件部分可以有多个条件(用and或or连接),“?”后面是条件满足后执行并返回的表达式部分,“:”后面则是条件不满足时执行返回的表达式部分。

三元表达式示例说明
A1>1000 ? "正常值" : "低值"表达式计算时,先取到A1单元格的值,判断值是否大于1000,如果是返回“正常值”字符串,否则返回“低值”字符串
A1>1000 and A1<20000 ? "正常值" : "修正值:"+(A1+100)条件部分,判断A1值是否大于1000且小于20000,如果是返回"正常值",否则返回字符串”修正值“与A1值加100后结果连接的值,如果A1是2000,那么就返回”修正值:2100“

if判断

       UReport2中if判断表达式语法结构如下图所示:

       从图中可以看到,if判断表达式则一个if条件判断部分加若干个可选的elseif条件判断部分,最后再加一个可选的else部分构成,语法结构类似java或javascript。

if判断表达式示例说明

if(A1>1000){

return "正常值"

}

判断A1单元格的值是不是大于1000,如果是返回”正常值“字符串,否则什么都不做

if(A1>1000){

return "正常值"

}else{

"低值";

}

判断A1单元格的值是不是大于1000,如果是返回”正常值“字符串,否则返回”低值“字符串。

这里需要注意的是,在if表达式中,return关键字是可选的,同是行尾添加';'也是可选的,这主要是为了照顾一些java及javascript程序的习惯

if(A1>1000 and A1<20000){

return "正常值:"+A1

}else if(A>20000 and A1<40000){

return "超高值"

}else{

"低值"

}

在这个例子当中,条件部分添加了多个组合条件,同时elseif多重判断

case判断

       case判断是UReport2中提供的另一种条件判断形式,与if判断有些类似,但case判断看起来更为简洁,其语法结构图如下所示:

       可以看到,case判断要由case{...}包裹,然后是若干条件加返回值。

case表达式示例说明

case{
A1==100
return "正常值",
A1>100 and A1<1000
return '偏高'
}

有两个条件,分别返回不同的值
case{
A1==100
return "正常值",
A1>100 and A1<1000
'偏高'
}
在case表达式中,return关键字同样是可选的

单元格引用

       在报表当中,大多数的计算都是针对单元格或与单元格有关,因为报表中单元格多数都与数据绑定,而数据往往又是多条,所以计算后的报表一个单元格会产生多个,这样对于单元格的引用就变的比较复杂。在UReport2中,引用的目标单元格是相对当前单元格来进行计算的,引用方法就是直接在表达式里书写单元格名称,比如引用A1单元格,就直接写A1即可,如下面的例子:

       在上图当中,我们在D1单元格中输入表达式A1,这就表示,在D1单元格里填入相对当前D1单元格的A1单元格的值,运行后的效果如下:

       可以看到,因为D1是A1的子格,A1单元格绑定的数据就是分组结构,根据当前D1单元格的位置,就产生的上图所示的结果。如果在D1单元格中输入B1,那么运行后的效果又是下图的样子:

       同样,如果在D1中输入表达式C1,那么运行后将会在每个D1单元格中填入与D1单元格位于同一行的C1单元格的值,运行结果这里就不再贴出来了。

       通过上面的例子我们可以看到,UReport2中某个单元格的表达式引用目标单元格,首先判断的是目标单元格与其所在单元格是否位于同一行或行,如果是则直接取对应行或列上目标单元格的值。如果当前单元格与目标单元格不在同一行或列,那情况又不一样了,我们来看下一个例子。

       在上面的例子中,我们在C2单元格的表达式中输入B1,表示取B1单元格的值,但B1单元格又和C2不在同一行或列上,同时B1单元格展开后会有多个值,但B1单元格和C2单元格都拥有一个共同的父格或间接父格A1(C2单元格的左父格是B2,而B2单元格的左父格又是A1,所以A1是C2单元格的间接左父格),所以它会取他们共同父格A1下所有B1的值,运行结果如下图所示:

多个值的输出

在UReport2中,如果取到值超过一个,输出时多个值间以“,”分隔,如上图所示

目标格获取原则

由上面的例子可以看出,UReport2中单元格表达式在取目标格值时,优先考虑的是目标格是否与其位于同一行或列,如果是则取与其位于同一行或列的目标单元格,如果不是,则取与当前单元格有共同父格的所有目标单元格,如果他们有共同的上父格或共同的左父格,那么就取共同上父格与共同左格交集部分的目标单元格;如果他们没有共同的父格,那么就取迭代后所有的目标单元格。

       针对上面的例子,如果我们在上面的单元格中输入C1,那结果又不一样;因为C1是C2的上父格,所以将直接取与其位于同一列的上父格单元格的值,运行效果如下图所示:

 

       再看下面的报表示例:

       在上面的例子中,B2单元格表达里输入C1,因为B2和C2既不在同一行或列,也没有共同的父格,所以B2中将取到所有的C1单元格的值,如下图所示:

更改父格实现单元格取值

在之前的视频教程中,在介绍报表计算模型时,我们多次利用更改当前单元格的上父格或左父格使得当前单元格与目标格处于某个特定的父格下,其原理就来自于此。

单元格坐标

       为了实现更为复杂的单元格引用,UReport2引用了单元格坐标的概念。单元格坐标,也是相对于当前单元格来进行计算的,同样遵循上面的介绍的优先取同行、同列或共同父格的原则,一个标准的单元格坐标格式如下:

单元格坐标格式

单元格名称[Li:li,Li-1:li-1,…;Ti:ti,Ti-1:ti-1…]{条件...}

       L表示左父格,l表示左父格展示后的序号,序号为负值,表示向上位移;T表示上父格,t表示上父格展开后的序号,序号为负值,表示相对于当前单元格向上位移,正值则表示向下位移,如果只有左父格,那么直接写L部分即可;如果只是上父格,那么前面需要加上“;”号,然后写T部分,后面的大括号中是条件部分,多个条件之间用and/or连接,表示对通过坐标取到的单元格进行条件过滤(如果取到多个单元格的话),条件部分是可选的,相关示例如下:

单元格坐标示例说明

C1[A1:2,B1:1]

在找C1时先找单元格A1展开后的第2格;再找第二个A1下的B1单元格展开后的第一个单元格,然后再找这个B1单元格对应的C1单元格

C2[A1:2,B1:2;C1:3]在找C2时,先找A1单元格展开后的第二格,再找第二个A1单元格下B2单元格展开后的第二格,再根据第二个展开的B2单元格找其下名为C2单元格的左子格;然后再找到C1单元格展开后的第三格,再看其下的C2单元格,取C2单元格的交集
C2[A1:2,B2:2]{C2>1000}表示取A2单元格展开后的第二格,再取其下B2单元格展开后第二格,再取B2下所有的C2单元格,最后再对取到的C2单元格进行条件过滤,只取出C2单元格值大于1000的所有C2单元格。
C2[A1:2,B2:2]{C2>1000 and C2<10000}表示取A2单元格展开后的第二格,再取其下B2单元格展开后第二格,再取B2下所有的C2单元格,最后再对取到的C2单元格进行条件过滤,只取出C2单元格值大于1000且小于10000的所有C2单元格的值。

       我们来看一个具体的示例,报表模版如下:

       在上面的报表模版中,在B2单元格表达式里,我们输入了C1[A1:2,B1:1],这就表示取A1单元格展开后第二格下B1单元格展开后第一格下对应的C1单元格的值,所以运行后我们可以看到如下图所示效果:

       当然,我们可以做一个交叉表,然后通过添加左父格和上父格约束坐标来定位某个特定单元格,这里就不再演示了。在实际应用当中,单元格坐标可以用在诸如同比,环比之类的统计报表当中,这时单元格坐标序号会用一些负值相对当前单元格进行位移,从而实现各种比值的计算。

引用所有单元格

如果我们需要引用所有单元格时,那么只需要在单元格名称后跟”[]“即可,如A1[],表达引用所有A1单元格,而不管当前引用格所在位置,同时在引用所有单元格时,还可以后跟条件,以对引用格做进一步条件限制,如A1[]{@>1000 and @<10000},表示要引用所有的A1单元格,但要求引用的A1单元格值要大于1000同时小于10000,这里的@符号是2.2.3及以后版本新增加的一个表达式符号,专门用于取条件循环中当前循环对象

       我们首先来看一个环比的例子。

环比

       报表模版如下图所示:

       在上面的报表模版中,D2单元格中的表达式为C2 - C2[A2:-1] ,这就表示在D2单元格中首先取到C2单元格的值, 因为C2单元格与D2位于同一行,所以可以直接取到,且只有一个;下一个C2采用了坐标A2:-1,那就表示取相对于当前单元格的A2单元格上一格(负值表示向上位移)的A2单元格所对应的C2单元格,运行后的效果如下图所示:

       从运行结果中可以看到,第一行环比的值为0,这是因为对于第一行的D2单元格来说,其上一行其实是不存在的,所以UReport2默认就取了第一个C2单元格的值,所以两个值减下来就是0。

       下一个例子我们来看看同比。

同比

       报表模版如下图所示:

       在上面的模版当中,D2单元格中首先取到与其同行的C2单元格的值,然后利用单元格坐格,先取到当前D2单元格所在行的A2单元格的上一条A2单元格记录(-1表示坐标上移),然后再取这个A2下对应的C2单元格,但由于其下C2单元格还是有多个,所以这里加了个条件B2==$B2,这里的第一个B2表示当前单元格所在行对应的B2的值,$B2表示坐标定位后C2单元格对应的B2单元格的值,条件就是他们俩要相等,实际上就是月份相等,这样就达到了我们要实现的同比的目的,运行后的效果如下:

关于$B2

在UReport2当中,在单元格名称前加$符号,表示取相对于目标单元格的单元格的值,多用在条件比较当中,比如上面的C2[A2:-1]{B2==$B2},这里的$B2就是指取到的C2单元格对应的B2单元格的值。

       在上面的例子中,第一个分组2000下,所有的同比值都为0,这是因为这个分组下不存在A2:-1这个坐标,没法上移,所以系统默认取了当前记录自身,所以计算后的值都是0。如果我们不希望显示0,那么可以加个if条件判断表达式,如果当前位于第一个分组,就输出空字符串,否则输出实际计算后的值,修改后的报表模版如下图所示:

       D2单元格对应的表达内容如下图所示:

       运行后的效果如下图所示:

       在上面的例子中,我们使用了if判断表达式,当然你也可以换成三元表达式判断或case判断,在这个if判断中,首先我们判断的是&A2==1是否成立,这里的&A2指的是相对于当前单元格A2单元格展开后的序号,在UReport2中,可以采用“&单元格名称”的方式标记某个单元格展开后的序号,需要注意的是,使用“&单元格名称”来标记目标单元格展开后的序号时,当前单元格必须是目标单元格的子格或间接子格;比如,在上面的例子中,使用&A2的单元格是D2,D2是A2单元格的间接子格,这样就可以正确取到A2展开后的序号值。

关于&标记的使用

在使用“&单元格名称”来标记目标单元格展开后的序号时,除上需要注意上面描述的内容外,还需要注意,取序号将以他们共同的父格为基准,如果他们有共同的父格,那么将以这个父格里目标单元格的数量来进行序号编排,这在之前视频教程介绍报表计算模型中,实现明细型主从报表,对从表数据进行编号时就有体现。

逐层累加

       报表模版如下图所示:

       D2单元格对应的表达式如下:

       在上面的表达式中,我们采用了if判断(同样你可以换成三元判断或case判断),当相对当前单元格A2展开后的序号为1时,那么直接取当前行的C2单元格值,否则就拿当前行的C2单元格值加上,上一行D2单元格值,这样就实现了逐层累加的需求,运行后的效果如下:

数据集表达式

       数据集是报表展示数据的来源,一般情况,定义好数据集后,在数据集对应的字段上双击即可在目标单元格上添加对应的数据绑定信息,然后在其属性面板设置聚合方式、迭代方向等。实际上,在UReport2中,还允许我们在单元格表达式里通过书写表达式来实现单元格与数据集字段的绑定,其语法结构如下:

数据集名称.聚合方式(字段名[,条件,排序方式])

       聚合方式与我们双击添加字段绑定后在属性面板上看到的聚合方式基本一致,具体有以下几种类型。

select(罗列数据)

       语法格式如下:

       datasetName.select(propertyName[,filter,order])

       filter为条件部分,条件可以有多个,多个条件之间用 and or连接,order为是否对当前的propertyName进行排序,可选值有两个descasc,既正序和倒序

示例说明
ds1.select(username)取数据集ds1中所有的username字段信息
ds1.select(username,age>18)取数据集ds1中所有的age属性大于18的username字段信息

ds1.select(username,age>18, desc)

取数据集ds1中所有的age属性大于18的username字段信息,同时对username字段做倒排序

ds1.select(username,age>18 and age<60, asc)

取数据集ds1中所有的age属性大于18且小于60的username字段信息,同时对username字段做正排序

group(分组罗列数据)

       语法格式如下:

       datasetName.group(propertyName[,filter,order])

       filter为条件部分,条件可以有多个,多个条件之间用 and or连接,order为是否对当前的propertyName进行排序,可选值有两个descasc,既正序和倒序

示例说明
ds1.group(degree)对数据集ds1中degree字段进行分组
ds1.group(degree,age>18)对数据集ds1中age属性大于18的所有的degree字段进行分组

ds1.group(degree,age>18, asc)

对数据集ds1中age属性大于18的所有的degree字段进行分组,同时对分组后的degree字段进行正排序

sum(累加数据)

       sum是对数据集目标字段进行累加,所以目标字段一定要是一个数字类型,否则就会产生错误,其语法格式如下:

       datasetName.sum(propertyName,filter)

      与之前函数不同之处在于,sum函数没有order,也就是说不需要排序,原因很简单,因为累加后的值只有一个,所以无需排序。

示例说明
ds1.sum(salary)对于数据集ds1中的salary字段进行累加
ds1.sum(salary, age>30)对数据集ds1中age属性大于30的所有对象的salary字段进行累加

count(统计数量)

       count是对数据集对象数量进行统计,其语法格式如下:

       datasetName.count(filter)

       统计数量不需要指定propertyNameorder。

示例说明
ds1.count()对ds1数据集中对象数量进行统计

ds1.count(age>30)

统计数据集ds1中对象属性age值大30的所有对象的数量

max(取最大值)

       max语法格式如下:

       datasetName.sum(propertyName,filter)

       取最大值没有order。

示例说明
ds1.max(salary)对于数据集ds1中的salary字段进行比较,取最大值
ds1.max(salary, age>30)对数据集ds1中age属性大于30的所有对象的salary字段进行比较,取最大值

min(取最小值)

       min的语法格式如下:

       datasetName.sum(propertyName,filter)

       取最小值没有order。

示例说明
ds1.min(salary)对于数据集ds1中的salary字段进行比较,取最小值
ds1.min(salary, age>30)对数据集ds1中age属性大于30的所有对象的salary字段进行比较,取最小值

avg(取平均值)

       avg在取平均值时,如除不尽,则保留8位小数,avg的语法格式如下:

       datasetName.sum(propertyName,filter)

       取平均值没有order。

示例说明
ds1.avg(salary)对于数据集ds1中的salary字段取平均值时,如除不尽,则保留8位小数
ds1.avg(salary, age>30)对数据集ds1中age属性大于30的所有对象的salary字段取平均值时,如除不尽,则保留8位小数

取当前单元格值

        在UReport2中提供了一种特殊的表达式,用来取当前单元格值,它就是“#”,比如在给某个单元格配置链接时,我们可能需要将当前单元格值作为参数传递给这个链接,那么就可以在链接表达式里输入#,这就将会将当前单元格值取出来,传递过去,如下图所示:

       除此之外,如果在#后面加上.后接具体的属性名,那么还可以取到与当前单元格绑定的数据对象的具体属性值,如:#.id,表示取与当前单元格绑定的对象的id属性值,当然如果当前单元格内容不是一个数据集类型的,那么就会返回null,同样如果当前单元格绑定的数据集属性运行时值有多个,那么它只会取第一个对象的对应的属性值。