PanSchema报表设计器V10使用说明书.docx
《PanSchema报表设计器V10使用说明书.docx》由会员分享，可在线阅读，更多相关《PanSchema报表设计器V10使用说明书.docx（53页珍藏版）》请在冰豆网上搜索。
PanSchema报表设计器V10使用说明书
PanSchema报表设计器使用说明书
（V1.0）
2008年2月
一、功能概述
1.1报表解决方案结构
PanSchemaReport包括三个部分：
报表设计器、报表服务和报表展示构件。
PanSchema使用RDL（ReportDefinitionLanguage）描述报表。
报表的定义过程中，采用模型的卡片数据作为数据源，屏蔽了数据库细节，并继承了模型数据权限。
使用可视化的报表定义界面和具有实际意义的卡片数据，使得用户可以轻松快速的定制报表。
报表展示过程中，服务器端负责报表数据的采集及权限的控制，客户端负责报表的形成和展示，减小了应用服务器的压力，轻松的实现了报表打印和导出。
1.2PanSchemaReport各组成部分的特点
1.2.1PanSchema报表设计器特点
a）报表行数、列高任意调整，行高、列宽自由定义
b）字体、字号、颜色、前景、背景任意设定、报表格式美观简洁。
c）单元格合并和斜线处理给不规则报表的制作提供了极大的方便。
支持单元格的横向、竖向合并。
d）报表数据的收集、汇总和合并使数据汇总省时省力。
e）报表数据的图形分析直观明了。
f）采用可视化的设计界面，所见即所得。
g）以卡片数据作为数据源，屏蔽了复杂的数据库表结构。
h）提供SQL编辑器。
i）报表表达式支持各种常用函数。
j）支持子报表。
即将推出的：
k）支持统计图（饼图、柱状图、折线图等）。
l）预览功能。
1.2.2PanSchema报表服务特点
a）数据获取与显示分层实现。
服务器端只负责筛选报表的数据，报表的展示界面由客户端完成。
b）完备的权限控制方案。
c）支持SQLServer数据库。
即将推出的：
d）支持Oracle数据库。
e）支持报表订阅。
f）支持调用外部程序集。
1.2.3PanSchema报表展示控件
位于PanSchema目标系统智能客户端，具有以下特点：
a）支持客户端本地打印。
b）支持报表导出（PDF和Excel）。
c）参数查询。
即将推出的：
d）支持报表钻取。
e）支持HTML格式导出。
1.3PanSchemaReport报表设计器功能
PanSchema报表设计器是PanSchema报表的定制工具，内嵌于建模平台中。
而报表的形成和展示由PanSchema目标系统智能客户端负责。
功能包括：
报表模版的建立，创建和编辑PanSchema报表项目，定制具体报表，报表数据录入，子报表功能，图表功能，报表汇总以及生成客户端展示所需的报表文件。
可满足用户个性化的自定义报表定制，复杂单据定制等要求。
不仅仅可以使用一些共同的报表格式,也可以根据自己的需要建立适合自己的报表格式，生成有很强针对性的报表。
二、PanSchema报表产品示例
2.1统计类报表展示示例：
以“费用明细统计表”为例对比展示：
（具体创建可见本文档6.2部分）0
图1费用明细统计表展示图
图2费用明细统计表设计界面
2.2单据类报表展示示例：
以“现金借款单”为例对比展示：
（具体创建可见本文档6.3部分）
图3现金借款单展示
图4现金借款单设计界面
三、PanSchema设计报表基础知识介绍
3.1PanSchemaReport设计报表布局
使用PanSchema报表设计器设计的报表布局由三个主要区域组成：
页眉、页脚和主体。
主体中包含报表数据。
您可以向报表布局中添加数据区域（带有明细行的表）、文本框（Textbox类型的单元格）、子报表（SubReport类型的单元格）和线条（Line类型单元格）等报表项。
数据区域显示数据源中重复的数据行。
页眉和页脚分别在报表每一页的顶部和底部重复相同的内容。
可以在页眉和页脚中放置文本框（Textbox类型单元格）和线条（Line类型单元格）等报表项。
若要设计报表，请在报表设计器中新建或导入.PSR报表项目，在报表项目中双击选定要编辑的报表节点（或新建报表节点），在报表编辑窗口中定制报表，设计完成后，“生成”报表项目，得到客户端所需的报表文件。
报表的设计视图呈现的是报表的基础.XML文件定义。
如果希望保持设计视图和XML文件同步，应避免直接修改XML文件。
3.2PanSchemaReport设计报表基本元素介绍
PanSchema设计报表由页眉、主体、和页脚3部分组成,各部分所能够包含的报表元素是不同的。
具体参照下表：
表1PanSchemaReport报表元素与RDLC报表元素对照表
PanSchema设计报表元素
适用区域范围
生成后RDL描述元素
功能与使用
类型为Textbox的单元格
页眉、页脚、报表主体
文本框
（1）文本框是报表中包含单实例数据的报表项。
使用文本框的方法有很多种，例如向报表添加标题、在页眉或页脚中添加特定字段或者添加单实例数据（如订单详细信息报表中的客户联系信息）。
（2）概要行：
通常用来实现总计功能。
标题行
报表主体
文本框
概要行（摘要行）
报表主体
文本框
列头行
报表主体
Table的表头行
（1）表是逐行显示数据的数据区域。
表列是静态的。
可以向下扩展表行以容纳数据。
（2）列头行：
作为表数据显示区域中的表的标题信息。
（3）明细行：
属于重复数据行，一般用于扩展显示数据源中每条数据内容。
（4）列尾行：
基本功能同列头行，一般用户显示表数据区域的尾部信息。
明细行
报表主体
Table的明细行
列尾行（列脚行）
报表主体
Table的表尾行
Chart类型单元格（1.0版本尚未支持）
报表主体
图表
图表以图形方式显示数据。
例如，柱状图、饼图和折线图等。
SubReport类型单元格
报表主体
子报表
子报表是在父报表的表体内嵌入其他报表的项。
从概念上讲，子报表类似于为其他网页内容提供容器的网页中的框架。
子报表呈现在包含它的父报表内。
同时处理和显示这两个报表。
Line类型单元格
页眉、页脚、报表主体
线
在报表中创建画线功能的可视化效果。
四、软件安装
本报表系统是建模平台中的一部分，无需单独安装。
五、报表设计器的使用：
5.1打开PanSchema报表设计器
运行建模平台（AppModelDesigner.exe），新建或打开项目后，点击报表->报表设计器进入报表设计器界面，如下：
图5打开”报表”菜单，点击”报表设计器”进入设计器主界面
图6报表设计器主界面
5.2主要功能区域介绍
PanSchema报表设计器界面类似于VS.NET窗口样式，具体主要包括6大区域，包括菜单栏、工具栏、报表项目管理器、属性区、错误提示区和报表编辑区（可对照图6所示主界面）。
其中报表管理器、属性区和错误提示区具有停靠功能，方便查看和编辑。
5.2.1菜单栏
图7报表设计器主菜单
1，“文件”菜单
a）新建：
新建报表项目。
b）打开：
打开已经保存的报表项目。
c）保存：
保存当前编辑区域所编辑的报表。
d）全部保存：
保存整个报表项目。
e）关闭：
关闭当前报表项目。
f）退出：
退出报表设计器。
2，“编辑”菜单
a）重复：
恢复上次撤销的动作。
b）撤销：
撤销上次编辑动作。
3，“视图”菜单
a）报表管理器：
控制报表管理器窗口的显示与隐藏。
b）属性窗口：
控制属性窗口的显示与隐藏。
c）错误提示窗口：
控制错误提示窗口的显示与隐藏。
4，“项目”菜单
a）报表菜单：
编辑报表的客户端展示菜单结构。
用于报表在客户端报表菜单位置的展示。
（参考附录B）
5，“帮助”菜单
a）关于：
产品信息简介。
5.2.2工具栏
图8报表设计器工具栏
工具栏各项分别对应于菜单栏中常用功能菜单项，。
各按钮依次对应得菜单项如下所示：
（具体功能参见5.2.1菜单栏说明）
：
文件|新建
：
视图|属性窗口
：
文件|打开
：
视图|错误提示窗口
：
文件|保存
：
编辑|撤销
：
文件|全部保存
：
编辑|重复
：
视图|报表管理器
5.2.3报表管理器
报表管理器类似于VS.NET中的解决方案资源管理器，位于整个报表设计器的最左位置，具有自动隐藏、关闭、显示功能。
主要负责整个报表项目的结构设计和展现：
编辑文件夹节点、报表节点等功能，具体通过不同类型节点的右键关联功能实现。
图9报表管理器
整个项目管理器的树形结构中共有3种类型节点：
项目节点、报表文件夹节点和报表节点。
不同节点的右键功能如下表：
节点类别
右键菜单截图
具体功能说明
报表项目节点
a）生成：
将整个报表项目中的所有报表转换成客户端用的RDLC报表文件和服务器端所需的报表描述文件ReportDescription.xml。
b）新建文件夹：
在报表项目目录下新建文件夹。
c）新建报表：
在报表项目目录下新建报表。
d）重名命：
重名命报表项目名称。
报表文件夹节点
a）新建文件夹：
在当前文件夹下新建文件夹。
b）新建报表：
在当前文件夹下新建报表。
c）重名命：
重名命当前文件夹。
d）排除：
将当前文件夹排除在当前项目外，但不删除其物理存储。
e）删除：
将当前文件夹排除在当前项目外，并且永久删除其物理存储。
报表节点
a）显示：
在设计器的编辑窗口中显示当前报表。
b）验证：
对当前报表的合法性进行验证。
c）重命名：
重名命当前报表。
d）排除：
将当前报表排除在当前项目外，但不删除其物理存储。
e）删除：
将当前报表排除在当前项目外，并且永久删除其物理存储。
5.2.4错误信息提示窗口
错误信息提示窗口，位于整个主窗口的最下位置，用于验证和生成过程中的错误信息提示。
类似VS.NET的错误列表窗口，具有自动隐藏、关闭、显示功能。
图10错误提示窗口
5.2.5报表编辑窗口
PanSchema报表设计器中设计时报表—PanSchemaReport与客户端展示所用的报表RDLC报表是不同的，设计器负责报表的定制，并且负责将定制好的报表项目转化为客户端展示所用的使用RDL（ReportDefinitionLanguage）描述的报表文件。
PanSchemaReport由页眉、主体、和页脚3部分组成：
页眉和页脚分别位于报表编辑窗口的上方和下方，中间是主体部分，3者通过横线在编辑窗口中分隔。
报表编辑窗口位于整个报表管理器主界面的这中间位置，负责报表的具体编辑。
报表的编辑主要是通过编辑窗口中的不同右键菜单功能，配合属性窗口的具体设置来完成的。
报表编辑窗口可包含多个报表，通过选择具体的报表标签确定当前编辑报表。
另外编辑窗口中还具有标尺功能。
表2报表编辑窗口常用操作
操作目的
相关截图
具体说明
添加表或者编辑区域属性
右击页眉、页脚空白部分，出现右键菜单：
a这是报表编辑最基本的编辑命令，报表中所有元素都是以“添加表”开始的。
b添加表：
在当前区域添加表。
c属性：
在属性窗口查看或编辑当前区域属性。
创建表
选择添加表命令：
aRDLC报表规定，数据区域元素，即RDLC中的Table、Chart等元素是不能够出现在页眉页脚中的。
所以相对应的主体中添加的表包括标题、列头、明细、列尾和概要5种类型的行元素。
而在页眉页脚中，分别只有一种类型行PageHeader和PageFooter。
（参照3.1部分表1理解）
b通过当前窗口可以初始化添加的表，添加完毕后，可通过右键菜单和属性窗口编辑表。
编辑表
当前表元素右键单击：
a编辑内容：
选定单个单元格时有效。
也可通过单元格的表达式属性编辑。
b锁定：
取消或锁定当前表，锁定后即不能再移动。
c合并单元格：
选定多个相邻单元格时有效。
同时支持横向、竖向合并。
d拆分单元格：
选定合并后单元格有效。
e选中行：
选定单元格时有效，选中当前单元格所在的行。
支持多选。
f选中列：
选定单元格时有效，选中当前单元格所在的列。
支持多选。
g选中表：
选中当前表格。
h添加列-左侧（右侧）：
选中单元格时有效，在当前单元格左侧（右侧）添加新列。
i添加行：
按类型添加行。
--仅对主体区域有效。
j添加行-上方（下方）：
选定单元格或者行时有效，在当前行的上方（下方）添加新行。
k删除—删除当前行集合、列集合或者当前表。
5.2.6属性窗口
属性窗口位于主界面的最左端，主要配合报表编辑窗口完成具体报表的定制，编辑PanSchemaReport当前元素的具体属性的设置。
图11属性窗口
本窗口主要分为以下3个部分：
1）元素选择区：
由一个下拉框构成，主要负责按照元素名称选定当前元素。
2）具体属性设置区：
不同类型的元素对应不同的属性集合，负责选定元素的具体属性设置。
3）提示信息区：
实时显示当前正在编辑的属性的提示信息。
5.3报表属性编辑
5.3.1报表基本元素属性
PanSchemaReport所有元素的属性编辑方式及相关属性介绍参见下表：
表3PanSchemaReport基本元素属性简介
报表元素
选择方式
属性截图
属性说明
1，
整个报表
鼠标单击左上角水平标尺和垂直标尺相交的小矩形框，即可选择整个报表
a）交互高度：
在交互式呈现器中呈现报表时的页面的默认高度。
（a-e可参考5.3.2部分）
b）交互宽度：
在交互式呈现器中呈现报表时的页面的默认高度。
c）宽度：
设置报表宽度。
d）页面高度：
报表中页面的默认高度。
e）页面宽度：
报表中页面的默认宽度。
f）参数：
设置报表参数。
（具体设置见5.3.3部分）
g）数据源：
设置报表数据源。
（具体设置见5.3.4部分）
h）所属窗口：
设置当前报表所属的具体卡片窗口。
i）所属角色：
设置当前报表所属的角色权限，即哪些角色用户可以查看操作报表。
j）边距：
设置整个报表的边距。
（参考5.3.2部分）
2，页眉页脚
在页眉或页脚的空白区域进行右键单击，出现右键菜单，
（1）单击属性选项，通过属性窗口可对页眉、页脚属性进行设置。
（2）单击添加表选项，可在页眉页脚中添加相应元素。
a）高度：
设置页眉/页脚高度。
b）背景色：
设置页眉页脚背景色。
c）边框--上、下、左、右边框：
宽度：
设置边框的宽度。
颜色：
设置边框颜色。
样式：
设置边框样式。
d）首页显示：
指定是否在报表首页包含页眉页脚。
e）尾页显示：
指定是否在报表尾页包含页眉页脚。
3，报表主体
略（具体属性说明可参见页眉页脚相同属性）
4，
表
在表区域内右键单击选择右键菜单中的“选中表”菜单项，通过属性窗口对其进行设置。
a）结尾分页符：
是否在该表的结尾添加一个分页符。
b）开头分页符：
是否在该表的开头处添加一个分页符。
c）是否隐藏：
可编辑该表的隐藏表达式。
（布尔类型）
d）重复表头：
e）重复表尾：
f）名称：
为该表命名。
注意：
同一区域内不能存在相同名称的表元素。
g）筛选器：
设置表的筛选器。
（具体设置见5.3.6部分）
h）数据集：
为该表关联数据集。
i）高度：
定义表的高度。
j）宽度：
定义表的宽度。
k）上距离：
该表与所处区域的顶部距离。
l）锁定：
是否将表锁定，锁定后无法移动该表。
m）左距离：
该表与所处区域的左边距。
5，
表行
右击选定的单元格选择“选中行”菜单项。
a）类型：
查看选定行的类型。
b）行高：
设置选定行的高度。
c）行号：
查看选定行在所属表中的行索引。
6，表列
右击选定的单元格选择“选中列”菜单项。
a）列号：
查看选定列在所属表中的列索引。
b）列宽：
设置选定列的宽度。
7，
单元格
单击目标单元格即可，可同时选择多个单元格
a）列宽：
单元格所属列宽度。
b）行高：
单元格所属行高度。
c）单元格类型：
选择单元格的类型，默认为Textbox。
注：
目前单元格共有4种类型：
Textbox（单元格）、Line（线）、SubReport（子报表）和Chart（图表）。
但当前图表功能尚不能使用。
d）表达式：
编辑单元格表达式。
（具体设置参考5.4.1）
e）图表：
如果单元格属性为Chart类型，则可编辑此图表属性。
（本版本尚未支持此功能）
f）背景色：
背景的颜色。
g）边距：
单元格
h）边框：
单元格边框设置。
i）对齐方式：
单元格文本的对齐方式。
j）排列方向：
单元格文本是竖直排列还是水平排列（默认）。
k）前景色：
单元格文本颜色
l）字体：
单元格文本字体设置。
m）线的方向：
选择线的方向。
n）线的宽度：
设置线条宽度。
o）线的样式：
选择线的样式。
p）子报表：
如果单元格属性为SubReport类型，则可编辑此子报表属性。
（参考5.3.8部分）
5.3.2报表大小与边距属性设置
由表２可知，报表的大小属性包含页面高度、页面宽度、交互高度、交互宽度和宽度5个属性:
1，页面高度和页面宽度规定了报表中页面的默认高度和宽度，决定着报表的实际打印效果。
2，交互高度和交互宽度决定了报表在交互式呈现器中呈现报表时的页面默认大小。
3，宽度即报表宽度。
（页眉宽度=主体宽度=页脚宽度=报表宽度）
4，为了保证报表内容不越出纸张范围：
（同时参考附录A）
（１）报表高度（页眉高度+主体高度+页脚高度）＋上边距＋下边距<=纸张高度；
（２）报表宽度（页眉宽度=主体宽度=页脚宽度）＋左边距＋右边距>=纸张宽度；
5.3.3报表参数属性设置
单击报表编辑窗口左上角水平标尺和垂直标尺相交的小矩形框选定整个报表，在属性窗口中选择“参数|设计参数”，打开报表参数编辑窗口：
图12报表参数编辑窗口
图12所示即为报表参数集的编辑窗口，左侧部分为参数集合列表，右侧属性区域对应选定参数的属性设置。
系统默认设置了3个系统参数：
CurrentUserName（当前用户名称）、CurrentUserRole（当前用户角色）和CurrentWindowRecordID（客户端当前窗口的当前记录的ID）。
用户可根据具体需求修改它们的某些属性。
报表参数的属性集合及其设置可参见下表：
表4报表参数属性设置
报表参数属性截图
属性说明
a）可为空：
参数是否可以为空。
即是否可以空出不填。
b）可为空值：
参数是否可以取空值。
c）类型：
选取设置参数值的数据类型。
d）名称：
参数的名称。
e）默认值：
参数默认值（尚未使用）。
f）内部使用：
内部使用，打开报表时不需要接收传递值，即作为子报表时，父报表看不到此参数。
（尚未使用，结合默认值。
相当于“局部变量”的作用）
g）提示信息：
参数提示信息。
h）系统参数：
是否为系统提供的参数。
i）用户输入：
是否需要用户输入参数值。
j）枚举值：
编辑参数的枚举值集合。
k）数据来源：
共有Enum、OnlyInput和List3种方式。
采用枚举值方式时，应选择Enum；采用下拉CardField数据时，应选择List；如果参数值由用户自己输入，应选择OnlyInput。
l）下拉：
数据关联Card中的某个CardField。
5.3.4报表数据源属性设置
单击报表编辑窗口左上角水平标尺和垂直标尺相交的小矩形框选定整个报表，在属性窗口中选择“数据源|设计数据源”，打开报表数据源编辑窗口：
图13报表数据源编辑窗口
图13所示即为报表数据源的编辑窗口，左侧部分为数据源集合列表，右侧属性区域对应选定数据源的属性设置。
报表参数的属性集合及其设置可参见下表：
报表参数属性截图
属性说明
备注与说明
数据源属性集合
a补齐行数：
数据源数据不满的话要补齐到多少行。
b名称：
编辑当前数据源名称。
c参数过滤：
编辑参数过滤表达式。
d分组：
编辑数据源分组表达式。
e来源表：
选择编辑数据源来源表集合。
f排序：
编辑数据源排序表达式。
g筛选表达式：
编辑数据源数据筛选表达式。
h字段：
选择编辑数据源的字段集合。
（1）报表参数属性设置步骤：
首先编辑来源表属性，再编辑其他属性。
数据源“参数过滤”属性编辑窗口
a左侧窗口为参数过滤条件列表，右侧为过滤条件属性编辑区。
b参数：
选择参数名称。
c过滤条件：
编辑过滤表达式。
（1）首先选择参数，然后编辑相应的过滤条件表达式。
数据源“分组”属性编辑窗口
a左侧为分组字段集合列表；右侧为字段属性编辑区。
b分组字段：
编辑选择分组字段表达式。
数据源“来源表”属性编辑窗口
a左侧为来源表集合列表；右侧为来源表属性集合编辑区。
b别名：
编辑当前来源表的别名。
c卡片数据：
下拉选择来源表关联的Card数据。
d连接：
来源表间的连接条件选择。
有None，Left，Right，Cross4种选择。
e连接表：
下拉选择连接当前表的来源表。
f连接条件：
编辑连接条件表达式。
（1）建议先选择卡片数据，再编辑别名。
（2）如果选择了连接表，则必须设置连接方式和连接条件。
数据源“排序”属性编辑窗口
a左侧为排序字段集合列表；右侧为排序字段属性编辑区。
b升序：
该字段升序排列还是降序排列。
c字段：
编辑排序依据的字段表达式。
数据源“字段”属性编辑窗口
a左侧为数据源的字段集合列表；右侧为字段属性编辑区。
b表达式：
编辑字段表达式。
c别名：
编辑当前字段的别名。
d提示信息：
当前字段的提示信息。
e从Card集合中选取字段：
弹出字段选择窗口，从当前数据源关联Card数据集中选择字段集合，别名默认为CardField名称。
选定后可再编辑。
（1）建议先选择或编辑表达式，再编辑别名及提示信息。
5.3.5报表所属角色和所属窗口属性设置
单击报表编辑窗口左上角水平标尺和垂直标尺相交的小矩形框选定整个报表，在属性窗口中选择“所属角色”，打开报表所属角色编辑窗口：
图14报表所属角色编辑窗口
如上图所示，从下拉列表中选取要添加的角色，通过添加、删除按钮编辑角色集合。
所属窗口属性的编辑窗口与此类似，不再详述。
5.3.6Table筛选器属性设置
单击目标表格单元格，右键菜单选取“选中表”，选择表元素，单击属性窗口的“筛选器”属性，弹出筛选器编辑窗口：
图15筛选器编辑窗口
筛选器编辑窗口主要有筛选器集合列表（DataGridView控件编辑展示）和5个功能按钮组合而成，每个筛选条件分为3个部分：
1，表达式：
运算符左侧表达式，可在文本框中输入编辑或双击通过表达式编辑窗口进行编辑。
2，运算符：
下拉选择运算符。
3，值：
运算符右侧表达式的值，可在文本框中输入编辑或双击单元格弹出表达式对应值编辑窗口：
图16筛选器表达式值的编辑窗口
上述窗口可根据具体需求编辑一个值或者多个值得集合，可在上面文本框中输入值或者双击文本框弹出表达式编辑对话框编辑值的表达式。
根据运算符不同，输入的值的个数和类型也有相应的规定和限制，比如In运算符便可编辑多个表达式值。
5.3.7图表Chart属性设置（本版本尚未支持图表功能）
5.3.8子报表SubReport属性设置0
选择类型为“SubReport”的单元格（默认为Textbox，可编辑选择其他类型）后，右侧的单元格属性“子报表”显示“有子报表”，单击展开，便可在属性
升级会员 