EAS套打入门reportone.docx

EAS套打入门reportone.docx

《EAS套打入门reportone.docx》由会员分享，可在线阅读，更多相关《EAS套打入门reportone.docx（12页珍藏版）》请在冰豆网上搜索。

EAS套打入门reportone

EAS套打模板设计（ReportOne格式）快速入门

1、前言

　　本文希望通过简要的描述，使用户快速了解EAS套打中的ReportOne格式并能够按照实际需求自己动手设计模板。

　　ReportOne系列的Print格式（模板文件名为*.r1-print，以下简称为R1），应用于EAS套打，为EAS用户提供自定义格式的单据、报表打印。

　　R1格式集成到EAS中，始于版本5.4.0。

本文针对EAS6.0.0（5.9）而作，EAS5.4.0的用户也可参考，基本无异。

图1 套打管理中的新建R1模板操作

2、R1格式的组件及规则

　　R1格式包含了下列组件：

页、单元对象（文字、金额、图片）、数据表、网格。

2.1 页

　　一个模板，自动对应了一个页对象。

页不可创建、删除。

　　页是模板的可设计区域。

通常，页的大小为纸张大小减去四边距后的尺寸，此时页与纸张一一对应，套打模式和大部分报表模式就是这种情形。

但是当多数据源的报表模式（参考后文的“简历模式”），设计时内容就很多，此设计区域容纳不下的时候，允许修改页的高度。

见下图“页面设置”（注：

由于不存在横向自由扩展的功能，页宽度不可修改）。

图2-1页面设置

　　运行时，页自动与主数据源绑定。

如果不存在“能引起分页的对象（如数据表）”绑定主数据源，则主数据源自动移至其下一条记录使页重复输出，例如票据套打模式、简历模式等。

否则，由“能引起分页的对象”分页。

2.2 单元对象

　　单元对象包括：

文字对象、金额对象、图片对象，它提供了一块固定的区域，用于展现对应的内容。

此内容可以是绑定字段，或自定义的固定内容。

　　注意，“单元对象”是离散的矩形区域，不等同于表格的“单元格”。

图2-2 工具箱中的单元对象

　　单元对象本身不引起分页，也不会引起数据源移动至下一条记录。

　　当单元对象放置在可高度自适应的容器中，并“纵向充满”容器时，可实现高度自适应的效果。

什么是“可高度自适应的容器”？

网格的行、数据表的数据行，具有“行高自适应”的属性，它们的单元格为“可高度自适应的容器”。

其中的金额对象，提供了对动态币别的支持。

对象除了本身可绑定金额数值的字段外，还可以再绑定币别字段。

系统根据数据源提供的币别信息，实现“人民币壹佰元整”、“$123.45”等形式的展示。

2.3 数据表

　　数据表是一种表格，它由规整的行、列组成，行列的交汇处为单元格。

行、列、单元格是组成表格的基本元素。

（注意“单元格”不等同于“单元对象”）

　　数据表具有分组展现、统计功能，其数据行能根据数据源重复输出，它是一种可能引起分页的对象。

2.3.1 行

　　数据表的行分为三种不同类型：

普通行、分组行、数据行。

图2-3 数据表各种类型的行及分组描述

　　 数据行有且只有一行，数据表至少由这一行组成。

数据行顾名思义，用于将数据源逐行输出。

相对于分组行中的统计内容，数据行中的内容可称为明细数据。

数据行属性设置中有“套打型”和“报表型”供选择。

套打型用于指定每页打印固定行数；报表型则按照数据量重复输出，空间不够时自动分页。

　　 分组行与分组对应。

在数据表上设置一层分组，则数据行上下两侧各增加一个分组行，称为“分组头”、“分组尾”。

分组头、尾随分组重复输出。

每层分组的头、尾允许增删多个分组行，但至少必须各保留一行。

如果按照需求必须做分组，而分组头（或分组尾）不想输出，可将其行高设为0，或设置其属性“不打印”。

　　普通行位于最外层，对应一份报表的表头表尾，即“总计层”。

数据表允许在其头、尾插入多行普通行，也允许没有普通行。

　　普通行和分组行有属性“每页出现”，可规避其随分组起、止才出现的特性，分页时随页的重复而每页出现，通常与“套打型”配合使用。

2.3.2 单元格

　　数据表的单元格可以直接用于显示文字内容，也可以作为容器放置单元对象，它可以是下列类型之一：

　　文本——固定的文字内容，通常出现在表头或分组头；

　　字段——绑定数据表当前数据源的某个字段，通常出现在数据行中；

　　统计——可做分组统计（分组范围内）、区域统计（当前页范围内）、累计（从分组开始至当前页）等，通常出现在分组尾（该层分组的统计）或表尾的普通行（总计）；

　　运算——统计功能的扩展，支持横向的在同一行中对多个数值字段进行运算，再对运算结果进行纵向的统计，最终运算结果显示在该单元格中；

　　容器——可放置单元对象或网格，但数据表本身不允许嵌套。

　　多个单元格可以融合。

表头表尾某些列与整体不符的情况，通常可以将一行中的几个单元格进行“合并单元格”，再放入网格进行划分。

另一种常见情形是某一列从分组头，跨过数据行，合并到分组尾，并绑上分组字段。

注意某些情形可能是没有意义的，例如在二层分组头之间做单元格的融合。

2.3.3 数据源绑定

　　数据表必须绑定唯一的一个数据源。

如果要展现另一个数据源的数据，可以在单元格中放置单元对象，并通过单元对象绑定另一数据源的字段。

2.4 网格

　　网格也是一种表格，同样由行、列、单元格是组成。

　　网格本身不绑定数据，它的行没有类型；单元格也不能显示文字，只能作为容器使用。

　　网格的基本功能是作为一种布局的手段，放置一批单元对象，使模板的调整更简单。

此时，网格可放在页中、数据表的单元格中。

网格可以嵌套，但嵌套会使模板变得复杂，所以通常通过单元格的融合也可以达到相同的效果。

　　网格的另一高级功能是组合多个数据表，在多数据源的情况下完成报表的展现需求。

通常配合“一主多从”的数据源出现（参考“简历模式”），此时的网格作为分隔区域的大容器放置在页中，一般设置为1列多行。

可在第一行中放置另一网格做表头，可在后续各行中分别放置数据表。

放置数据表的行，设置属性“行高自适应”。

那么，这个做为大容器的网格，起到将各个数据表依次输出的目的。

所以，设置了行高自适应的网格，也是一个可能引起分页的对象。

3、模板设计经典模式

3.1 票据套打

　　以支票为代表的套打，其特征为：

　　＊单数据源；

　　＊数据源的每一行记录对应一张票据；

　　＊不带分录。

　　在页面上准确位置放置单元对象，绑定字段即可。

页随数据源的记录自动重复输出。

模板允许从磁盘中导入一张图片作为背景，用于辅助确定准确位置。

该图片随模板保存、预览（除非设计完成后将其删除），但不输出到打印机。

图3-1支票套打

 　　支票中金额的展现，可使用金额对象。

小写金额可按“样式”中的“填格”属性完成填格功能。

　　日期可按年、月、日，创建三个文字对象，都是绑定日期字段，分别做格式化：

yyyy、MM、dd。

如果是日期大写，可用脚本中提供的专门用于支票日期大写的formatChequeDate函数，例如在文字对象的“后处理脚本”中写上：

setValue（formatChequeDate（getValue（）,"yyyy"））

3.2 单据套打

　　单据的主要特征是带分录，逻辑上是“单据——分录”关系的数据源，但在EAS中，通常表现为单数据源。

数据源所提供的数据形式上如下：

单据A  分录A-1

单据A  分录A-2

单据B  分录B-1

单据B  分录B-2

单据B  分录B-3

单据C  分录C-1

　　由上例可见，三张单的分录合并在一起由一个数据源提供。

数据源总共6条记录，第一张单据A有2条分录、第二张单据B有3条分录、第三张单据C有1条分录。

对于此种情形，要做分组，分组字段为“单据ID”（或叫“单据号”之类能唯一标识单据的字段）。

图3-2 单据套打

　　该模式通常只需一个数据表，前后普通行融合后放网格做表头表尾；分组头做分录的标题，分组尾绑单据的汇总字段或利用套打系统做统计；数据行为套打型，每页重复固定次数。

所有普通行、分组行设置为“每页出现”。

　　常见的“凭证”等业务的套打，属于此模式。

3.3 多数据源的单据套打（带审批的单据）

　　该模式特针对下述情形：

　　＊在上述“单据套打”所描述的单数据源的基础上，增加了一个审批信息数据源；

　　＊审批记录行数可预知（最多不超过多少行）；

　　＊审批信息在单据每页中显示。

　　首先，模板开始设计之前，必须引入数据源并设置参数，使“从数据源”依赖“主数据源”。

此例中，输入参数名称为billId，为审批数据源的单据ID字段（可按数据库中“外键”的概念理解），绑定到单据数据源的单据ID字段。

图3-3 设置数据源依赖关系

　　和展现单据的数据表并列地，也放置一个数据表在页中，绑定审批数据源，位于单据下方。

由于审批记录行数可预知，设置数据行套打型、固定行数。

这样，审批信息将不会跨页，只出现在单据的第一页里。

　　如果有必要让审批信息在单据的每页中重复出现，在其数据表的“后处理脚本”中填上secondBirth（）函数即可。

　　注意，此例中的数据源提供方式，不能满足报表形式的展现，即不能满足单据跨页显示完了，单据后头接上审批信息（除非只打印一张单据）。

如果要达成此需求，数据源必须是“单据——[分录，审批]”这样“一主二从”的形式，请参考“简历模式”。

3.4 单数据源的报表

　　“报表型”区别于“套打型”的特点是：

不限定每页显示数据行数，行高可随内容自动调整（行高自适应），通常为第一页开头是表头，表体内容跨若干页，最后一页是表尾的形式。

　　和单据套打类似，用一个数据表就可以解决问题。

做必要的分组，分组行择需隐藏（“不打印”属性）；数据行设置为“报表型”；如果某些字段数据量不可预知，或各行数据多寡悬殊，可设置“行高自适应”；普通行、分组行的“每页出现”属性择需设置。

3.5 多数据源的报表（简历模式）

　　该模式的数据源为“一主多从”的结构。

以简历为例，对应的是“人员基本信息——[教育经历、工作经历……]”。

　　如同前面“多数据源的单据套打”中所述，对于多数据源的情况，同样需要设置依赖关系。

不赘述。

　　在“组件及规则”部分中已提及，利用页按主数据源的记录自动重复的功能，人员基本信息数据源中每一个人的记录都能自动得到输出。

我们只需要创建一个一列多行的网格作为基本容器，第一行嵌套另一个网格放置基本信息，第二行开始各放入一个数据表，显示教育经历等各从数据源的内容。

　　以上描述如下图所示。

为了清晰展示多层容器的关系，该图中各对象都向内部缩入，留出一圈边缘，实际设计模板时，对象应该是充满的，除非故意设计成这样。

　　从图中可以看到“分页提示线”，这是由于设计区域不足以容纳众多的内容，我们在页面设置中修改了页的高度。

此线只是提示，按照实际纸张输出，一页有那么大。

图3-4 简历模式

4、模板设计常见需求解决方案

4.1 盖章（电子签名）

　　需求一：

对于动态的内容，由数据源提供数据，用图片对象直接绑定字段即可。

　　需求二：

对于固定的内容，只是有条件地控制是否显示。

用图片对象，在其“后处理脚本”中写脚本进行控制。

　　假设存在一个叫“是否完成”的字段isFinished，布尔值，单据状态为“完成”则加盖图章。

图章的图片对象的脚本为：

if（getFieldValue（"数据源名称","isFinished"））

{

 setHide（false）;

}

else

{

 setHide（true）;

}

 　　脚本不是唯一的，只要符合语法，可以举一反三。

上例也可写成：

setHide（!

getFieldValue（"数据源名称","isFinished"））;

4.2 “是”/“否”（枚举值显示为汉字）

　　数据表单元格或单元对象绑定目标字段。

后处理脚本为：

setValue（getValue（）?

"是":

"否"）;

　　或：

setValue（toStr（getValue（））==“true”?

"是":

"否"）;

4.3 能否做到只显示统计，不显示明细数据

　　通过隐藏数据行，可以达到目的。

数据行属性--“不打印”。

　　虽然功能上能达到目的，但还是建议避免这种做法，尽量从数据源的角度考虑解决方案。

试想为了显示若干行统计数据而取回上万行明细数据，是多么笨拙的做法。

4.4 页眉页脚

　　R1格式中尚无明确的“页眉页脚”的概念。

但通过下列途径，可达到页眉页脚一致的效果：

　　＊放置在页中的单元对象，可随页重复输出。

　　＊在单数据表的情况下，数据表的前、后的普通行，设置“每页出现”。

4.5 节纸打印

　　简而言之就是例如在一张A4纸中打印三张凭证。

做法如下：

页面设置中纸张按实际打印的物理纸张设置为A4，勾上“节纸打印”选项。

模板中单据放置在页靠上三分之一的范围内。

4.6 连续走纸

　　针式打印机、两边带孔的连续纸。

打印机自动走纸，无需任何特殊设置。

4.7 超市小票模式

　　连续的纸张，每页长度由内容决定，可以打多长就撕下多少。

就像在超市买单时的购物小票。

　　页面设置，纸张选自定义（Custom）、纵向，勾上“动态走纸（超市小票模式）”选项。

4.8 关于纸张、横纵向与打印机进纸方向的问题

　　纸张有确定的大小，不管是标准纸还是自定义纸张，都是由宽度×高度来描述。

例如A4纸是210×297（单位：

毫米），如果尺寸为297×210，只是与A4物理纸张一样大，不能称为A4纸。

　　打印机的进纸方向是与纸张尺寸一致的，与横纵向的设置无关。

例如模板设置了纸张为A4纸，那么一张A4的物理纸张总是210的一端（宽）贴着进纸口，297的一端（高）垂直进纸口来装纸。

　　横纵向只是定义了内容在这张纸上的打印方向，和进纸方向无关。

　　以上是一般打印机与纸张的规则，由于容易混淆，特此说明。

　　另外，不管是设置了纵向还是横向，设计器和预览界面中看到的，总是文字正向的方向，不会像图片一样转换90度。

4.9 如何确定主数据源

　　当一个模板中定义了多个数据源时，要按照逻辑关系设置参数，定义依赖关系。

模板执行时，系统自动识别“不依赖于其它数据源的”为主数据源。

主数据源将影响到分页。

　　如果确实存在无依赖关系的、并列的数据源，则按照设计器中看到的顺序，第一个为主数据源。

此时，在设计器导航栏中的数据页签中，选中除第一个之外的任一数据源，鼠标右键，可看到“成为主数据源”的弹出菜单。

此菜单项可将选中目标置顶成为主数据源。

图4-1数据源

　　不建议在模板中定义多个无关的数据源，而实际只使用到其中的一个或几个。

5、设计器使用技巧

　　＊　对象属性设置、设计区中的拖拽操作，遵循“选中目标”原则，即选中谁、操作谁。

就像文字编辑时的光标，光标在哪里，录入的文字就插入在哪里。

所以，当选中一个文字对象的时候问“为什么不能拖动表格行高”是不聪明的问题。

　　＊　设计器左边导航栏的“报表”页签，是对设计区中对象的树状描述。

它的对象选中状态和设计区保持一致。

当设计区中出现重叠现象，比如对象覆盖到其容器，使选中不方便时，可通过此树来选中对象。

　　＊　[Ctrl]+鼠标单击，可多选对象；[Shift]+鼠标单击，可“块选”表格（包括数据表和网格）的单元格。

（注：

相同容器中的对象才允许多选。

）

　　＊　选中工具箱中的组件，在设计区中创建对象时，按住[Ctrl]，可连续创建多个对象。

　　＊　导航栏“数据”页签，可将一个字段拖到设计区目标对象上绑定。

特别地，对于数据表，拖放字段的时候按住[Shift]，可将字段别名作为文本内容填入单元格中；拖放字段的时候按住[Ctrl]，可将单元格的类型置为对该字段的分组统计。

　　＊　对象从一个容器“移动”到另一个容器，可剪切（[Ctrl]+[X]）、粘贴（[Ctrl]+[V]）。

　　＊　数据表单元格的内容可复制，而且可按照单元格的位置批量复制。

例如把整行标题文字从第一行移动到第二行，选中第一行第一个单元格，[Shift]+选中第一行最后一个单元格，[Ctrl]+[X]，选中第二行第一个单元格，[Ctrl]+[V]。

（注：

作者是R1套打设计器、执行引擎的开发人员，也是R1套打规则定义的主要设计人员）

48500

1.4

107000

1498