UREPORT 2 : 5.表达式

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

基本语法

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

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

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

三元表达式

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

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

if判断

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

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

case判断

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

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

单元格引用

       在报表当中，大多数的计算都是针对单元格或与单元格有关，因为报表中单元格多数都与数据绑定，而数据往往又是多条，所以计算后的报表一个单元格会产生多个，这样对于单元格的引用就变的比较复杂。在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的值，运行结果如下图所示：

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

       再看下面的报表示例：

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

单元格坐标

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

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

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

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

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

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

环比

       报表模版如下图所示：

       在上面的报表模版中，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单元格的值，条件就是他们俩要相等，实际上就是月份相等，这样就达到了我们要实现的同比的目的，运行后的效果如下：

       在上面的例子中，第一个分组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进行排序，可选值有两个desc和asc，既正序和倒序。

group(分组罗列数据)

       语法格式如下：

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

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

sum(累加数据)

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

       datasetName.sum(propertyName,filter)

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

count(统计数量)

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

       datasetName.count(filter)

       统计数量不需要指定propertyName及order。

max(取最大值)

       max语法格式如下：

       datasetName.sum(propertyName,filter)

       取最大值没有order。

min(取最小值)

       min的语法格式如下：

       datasetName.sum(propertyName,filter)

       取最小值没有order。

avg(取平均值)

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

       datasetName.sum(propertyName,filter)

       取平均值没有order。

取当前单元格值

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

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