1.名词定义

2.模板单元格

模板单元格代表了该单元格里面包含模板字段，模板属性，是可以根据配置的属性规则进行扩展的单元格；

而普通单元格只能承载静态数据，和excel单元格用法无差。

3.模版字段

模板布局可以包含各种数据绑定的字段，这些字段的数据绑定到视图。下图显示了不同的模板字段：函数字段。

数据字段是由数据源中的数据填充的绑定字段。可以按照以下示例中所示的不同方式定义这些字段：

数据字段数据绑定字段定义为：{{ds.FieldName}}，其中ds是数据源的别名。例如，{{ds.grade}}

函数字段用于在报告中执行计算。有两种形式

形式1：{{=函数()}}可以将函数应用于单元格或数据字段。支持的标准Excel函数为 Sum, Count, Average, Max, Min, Product, StdDev, StdDevp, Var and Varp. For example:

{{=SUM(F4)}}

{{=SUM(team.score)}}

{{=Count(student.name)}}

注意:{{=}}类函数字段仅支持一个参数，支持引用数据字段

函数字段也可以根据上下文进行计算。例如，在下面的图像单元格D14中包含函数字段以及上下文属性。将首先通过对单元格C14中的收入求和，然后对整个类别的值求和（因为A14是其上下文）来计算结果值

表达式字段可用于使用运算符'+'，'-'，'*'，'/'和'（）'执行计算。表达式可以应用于单元格。例如：

{{=A18*0.05}}

{{=A18+D18-G18}}

{{=(A18+ A20)*0.3}}

注意：表达式字段不支持模板属性。函数字段和表达式字段不能像{{= Sum（A5 + A6）}}或{{= Sum（A5）* 0.01}}那样一起使用，不支持。

推荐用法

工作表字段GcExcel支持在工作表名称中使用绑定字段，这意味着工作表名称的字段值由数据源中的数据填充，并创建了多个工作表。每个工作表都包含与其值相对应的数据。

例如，如果我们将{{dt.Region}}指定为工作表名称，并且数据源包含5个区域的数据，则最终报告将包含5个工作表，而单个工作表将包含特定区域的数据。

4.模版属性

模板属性与圆括号 () 中的模板字段一起定义，如下图所示：

当被识别为模板单元格时，支持双击模板单元格，打开模板属性配置窗口，进行可视化配置，也支持手写。

4.1 扩展E

垂直扩展

如果单元格的expansion属性设置为vertical，即“E=V”，则单元格值将垂直展开，如下所示。默认展开设置为垂直，这意味着如果未在单元格中指定任何展开属性，则单元格值将垂直展开。

水平扩展

如果单元格的expansion属性设置为horizontal，即“E=H”，则单元格值将水平展开，如下所示：

4.2 设置父格C

在模板布局中定义绑定到数据源的多个字段时，它们之间会建立一种关系，称为上下文关系（简称父子关系）。前一个单元称为后一个单元的上下文单元。根据此关系，在最终报告中展开时，将对数据进行筛选或分组。
有两种类型的上下文关系。

• 过滤关系: 使用上下文单元格的数据作为过滤条件来过滤单元格中的数据。例如，在下图中，name单元格中的数据将根据其上下文单元格中的数据进行过滤：

• 跟随关系: 单元格中的数据根据上下文单元格中数据的扩展方向进行分组。例如，在下图中，name单元格中的数据根据其上下文单元格进行分组和水平展开：

上下文单元格的使用“C”属性定义。单元格中的数据根据上下文垂直或水平扩展。可以通过以下方式设置单元格的上下文：

• 注意:无单元格上下文(C= None)



• 自定义：使用“C”属性显式指定单元格上下文

• 默认值：如果单元格中未定义上下文，则默认上下文单元格是左侧的相邻单元格，E=V（垂直展开），或顶部的相邻单元格，E=H（水平展开）例如，在下图中，A1是B1的上下文单元格，并垂直展开。

而且，A1是A2的上下文单元格，并水平展开。

最多支持配置两个父格来约束一个单元格扩展的跟随行为

上下文应适用于单元格的优先级顺序按以下顺序确定：

显式上下文 > 默认上下文 > 回退上下文

• 显式上下文:由单元格本身的C属性定义的上下文
  

• 默认上下文:如果单元格中未定义上下文，则默认上下文具有优先级
  

• 回退上下文:如果左侧或顶部没有相邻单元格值，则该单元格将查找具有覆盖其位置的R（Range）属性的单元格，并将其用作上下文。

如果未定义默认或显式上下文，则可以使用Range属性在单元格中定义回退上下文。定义范围的单元格将作为其他单元格展开的上下文。

例如，创建下面的模板布局是为了显示不同相机型号的销售详细信息，这意味着数据需要扩展到相机型号。然后，需要显示另一款相机的销售详情。我们可以为摄影机模型定义范围R=B11:F16，而不是为每个字段添加上下文-{{ds.Name（R=B11:F16）}，说明销售细节需要根据相机型号进行扩展和分组。

上述模板布局将生成以下Excel报表：

4.3 分组G（Group）

group属性允许您将模板中的数据分组。

值:枚举

G=Normal（归类不重复）: 对于列中的相应记录，不重复分组依据字段的值；而是每个数据组打印一次。

G=Merge（归类合并）(默认值): 行为与常规参数相同，不同之处在于它会合并每个组集的按字段分组的单元格。

G=Repeat（归类重复）: 对相应的记录重复分组依据字段的值。

G=List（原始分组）: 字段值针对相应的记录独立列出。

示例

{{ds.field(G=repeat)}}

{{ds.field(G=list)}}

下图显示了如何对重复数据应用“merge”分组：

4.4. 数据求和

根据不同场景智能推荐是否求和，并且支持一键取消，勾选数据求和后，代表对当前字段进行sum计算。

• 数值字段拖入编辑页，动态属性中数据求和默认勾选，公式默认套上sum()，手动取消后，公式中自动脱掉=sum()。

• 维度字段(包含日期字段, 计数字段)拖入编辑页，动态属性中不支持数据求和，公式表现为{{ds.字段}}。

注：数值字段拖入编辑页后，若此时该字段被其他单元格引用，同时手动取消求和/sum，引用的单元格也会相应变更。

4.5 排序S（Sort）

sort属性指定模板中的排序类型。

值:枚举

S=Asc升序

S=None(默认值):不排序

示例

{{ds.field(S=Desc)}}

4.6 范围R（Range）

range属性为指定范围内的字段指定回退上下文。范围中涵盖的所有字段（既没有默认值也没有明确的上下文）将定义该范围的当前单元格用作上下文。

值:Cell range

默认值: Null

示例

{{ds.field(R= B3:F10)}}

下图显示了为学生姓名定义的范围，并指定了有关学生姓名的详细信息并将其分组：

4.7 分页计数 CP

开启分页：

默认分页模式为按纸张大小分页，当前值A3纸张；开启分页功能后，可以在想要计数分页的单元格上，右击配置计数。

如CP=10,则根据该单元格扩展出的数据，每10个进行一次分页。

4.8 额外添加行列数 FM

默认值为带格式额外添加行列数（插入单元格，如需插入行需配置中国式报表全局参数）。

支持修改为覆盖写入或者保留格式覆盖写入。

5.自定义函数

函数1：&=

函数编辑框中输入&=可触发延时计算功能，补充{{==函数()}}不能引用数据字段的场景

例如：&=VLOOKUP({{视图.字段}},Sheet1!A1:B7,2)，可以在前面列扩展完之后后再进行计算，这样延后计算的字段也可以进行正常扩展

函数2：G_TEXT

在试用excel函数image()时，需要参数为string类型，=IMAGE("https://support.content.office.net/en-us/media/35aecc53-b3c1-4895-8a7d-554716941806.jpg","column")

该函数用于将其他类型的字段值转为字符串类型

例如：=IMAGE(G_TEXT(ds.url))

图片和超链接会自动生成对应函数，您只需在数据准备时将相关维度设置显示为图片/超链接