成果unieapreport工具手册

基础事业第1章概 第2章入 简 前 准备工 环境配 导入 配置服务 操作步 创建空白报 创建数据 设置报表元 修饰报 预览报 发布报 浏览报 第3章基本概 数据 数据 报表元 变 扩 依 第4章基本操 新建报 新建空白报 使用模板新建报 使用向导新建报 打开报 打开本地报 打开网络报 保存报 保存至本 保存至服务 定义报表元 文 .......................................................................................................................72图 ...................................................................................................................95子布 条形 依赖与扩 依 扩 行列控 4.6.1 4.6.2 删除 删除 追加 追加 剪切 剪切 粘贴 粘贴 样式管理与应 样式管 应用样 设置基 表头表 页面设 页眉页 预览报 发布报 报表管 数据源与数据 ReportV3.2数据 参数与系统变 参 系统变 参数与系统变量的区 变量说 属 单元格属 行列属 报表属 公 常 变 运算 函 附录报表设计器界面字 界面总 第1东软通用查询与报表系统——Report是一款功能强大的报表工具，它不仅功能全面， 表头复杂、且层次深；复杂格间运算、跨行组运算；对报表产品集要求高等等。利用传统报表工具往往很难解决上述问题，Report解决了上述问题！接设计各种复杂格式的报表，可以通过Web方式展现、打印、输出报表。ReportBI产品的前端工具，及常见的其他国内报表ReportV3.2基于第2简 前学习 环境配CPU：500MHz或更高操作系统 或更高版本操作系Eclipse：Eclipse3.2或更高版本请在ReportV3.2首选项设置中导入License文件；也可以直接将License文件到ReportV3.2插件 配置服务请在“首选项”中选择“UniEAPWorkshop”>图1请在“URL”输入框中输入报表服务的路径，并输入正确的用户名 图2ReportV3.2的系统环境,下面您可以使用报表设计器快速构建一创建空白>图3图4点击<Next>如下图所示图5图6创建数据图7图8ty*(1-wherecustomer.customer_id=orders.customeridandandproducttype.typeid=product.type图9点击<Finish>图10报表资源面板（含数据集设置报表 选中A1单元格，切换至“语义”TAB页。确认A1的类型为文本类型（若非文本类图11A3A3为文本类型。在“值”属性中输入“=group(ds1','TYPENAME',null,'TYPENAMEasc'))”，如下图所示：图12图13选中B2单元格，确认B2为“文本”类型。在“值”属性中输入“=group('ds1',图14图15 'AMOUNT',null,'AMOUNTasc'))”；在“行依赖”属性中输入“A3”；在“图17图16B3图17修饰报合并单元A1B1图18 中<合并单元格>按钮，将A1单元格与B1单元格合并。如下图所图19调整行A4A10单元格，以选中多余的空白行。如下图所示图20图21图22图23图24图25图26图27图28点击<背景颜色>按钮，在弹出的颜 框中选择蓝色。如下图所示图29颜 图30图31图32图33图34图35预览报 发布报 图图36点击<Finish>按钮，弹 框，提示发布成功。如下图所示图37浏览报打开IE窗口，输入http://服务器的IP:服务器的 在登录页面中输入用户名、，数据库中初始用户名为图38第3概 您可以同时定义多个数据源 Report支持的数据源类型包括：DRM数据源、XML数参见“ReportV3.2数据源”章节。数据集的类型与数据源的类型相同。在ReportV3.2中，支持多数据源、多数据集，即ReportV3.2数据集”章节。 变扩Report特有的功能特性之一，将值属性为集合的文本类型单元格，可以进行依照设依个单元格，来进行绑定功能，依赖格进行扩展时，附属格将按同样扩展方向进行扩展复第4操点击菜单栏中“File”>“New”>“Report”菜单项 图39 <New>按钮的下拉菜单中选择“Report”菜单项，如下图所示图40 图41您填写报表文件名称之后，点击<Next>按钮，进入报表创建模式向导页。如下图所图42新建空白图43点击<Finish>按钮，报表设计器会新建一张空白报表并自动在编辑器中打开。如下图44行图45点击<Next>按钮，弹出“依据模板创建”向导页，如下图所示图4647使用报表文件模板图48Excel如果您之前的报表是使用Excel定义的，或者您想先使用Excel定义报表的样式，然后49使用Excel文件作为模板导入的Excel如下图所示：50Excel文件图51Excel【注意】使用Excel作为报表模板 图52使用报表向导图53图54点击<Next>按钮，在数据集节点点击“新建”菜单项。图55请新建一个DRM数据集，具体的步骤请参考“DRM数据集”章节。使用的SQL语句为SelectSelectCustomer.CUSTOMER_NAME, ty*(1-order_detail.discount))amountCustomer,Product,Producttype,order_detail,orderswhereCustomer,Product,Producttype,order_detail,orderswhereorder_ductid=duct_idandproducttype.typeid=product.typeandProducttype.Typeidin(4,6)图56点击按钮可以向列表中添加字段点击按钮可以将字段从列表中删除右侧图57图58图59图60图61图62图63图64图65图66打开本地缀名为rdx），点击打开，即可打开选择的本地报表文件。如下图所示：图67打开网络点击菜单栏中“File”“Import”菜单项，或者在工程资源管理器中点击右键，在菜图68图69点击<下一步>按钮，系统弹出“打开报表文件向导”窗口，选择需要导入本地的报图70保存至本 上的<保存保存至服报表单元格里的内容可以是文本、、图表、子布局、、条形码，定义报表元 文图71设置值属图72【注意】公式体前必须加等号“图73将值填写在“语义 页中的值属性中，或通过双击直接在单元格中填写，如下图图74图75图76图77图78设置单元格的行/赖属图79图80Report所支持的格式化类型包括如：对于数字333.3333333333333如：对于数字日元欧元yyyy显示2001，yy则显示01。如下表所示：GEray年1996;MJuly;Jul;wW2DdF2EaAm/pmH0kKam/pm中的小时数（0-0ham/pm中的小时数（1-msS2007.02.2809:54:20yyM月d日HHmm072月28日0954EEE,MMMd,星,二月28,h:mm9:54hh'o''clock'a,9o'clock上午,yyyyy.MMMMM.ddGGGhh:mm02007.二月.28公元09:54如：对于数字23.1112 斜线表图81在单元格“值”属性处填写单元格内容，用“|”分割，分割顺序为左下角文字|中间文|右上角文字，如下图82图83通过设置“保护”TAB页中的“可见”属性来定义当前单元格在报表展现端是否可见，图84 ，Report支持三种 图85设 图 来源于本地文 点击<导入>按钮，在弹出的窗口中选择需要导入 文件，如下图所示图87点击<确定>，完 导入来源于服务器端可的文 。Report支持有效的URL，包括HTTP、HTTPS、服务器端绝对路径、服务器端相对于Web应用的相对路径。 在该窗口中填 函数是Unix，以”//”开头。 图 来源于数据 函数DBPicture(repository_name,field_name,keys,key_values[,repository_name：DRM或JDBC数据源名keys：定位的键名称列表northwind数据源的pictures表中取pic列的 的key是id列，定位的图 点击<确定>按钮，完 设置图定义方图90图91图92图表类系01234图93图94图95XY轴及从Y轴三个坐标轴，Y轴通常为垂直坐标轴并包含数据点，x轴通常为水平轴并包含分类。标题后面的复选框，即相当于没有定义从Y轴。图96图97y轴及从y【注意】对于FlashY轴刻度最大值、最小值group，cell等等。据少的部分以0补全，多的部分将不显示。图表中每个系列均可关联到上面提到的两个Y轴上，即系列数据基于哪个Y轴显示。Y轴上绘制图98图99趋势线主要应用于某些特殊领域的图表分析中，表明业务发展趋势，y图100图101图102X【注意】对于Flashx图103Y 点击<完成>图表样Report支持的图表样式包括Web展现使用Flash，导出 ；JFreeChart生成； 可以通过修改Report引擎应用unireport\WEB-INF\conf\unieap\report perties文件中graph_type的值来控制选择图表样式。例如：1：web展现使用flash，导出JFreeChart2：全部使用JfreeChart生 图表类JFreeChart组织图；图 股价图；Flash图表标图104设置图表标题104设置图表标题复合图以下为Report支持的复合图表：主子图类主子图类说柱、线、面 柱、 flash图表第一2D柱图并且与主Y轴关联，与从Y轴关联的系列数据将以2D线图flash图表第一3D轴关联的系列数据将以2D线图FLASH图表，在定义复合图表时，如果想使某一种图形放在最下面，请这样面积图才不会掩盖柱形图，此外如果定义了从Y轴，则系列中子图为柱形图的只能从属于一个Y轴。图表特性XY散点图：散点图图:数据 图图表数据特殊说系列数据中的x值为时间点，y值为趋势值，其它是 在一时间点的最高价，，图105设置类型图106类 图 度量值在中采用的字体，点击<字体>按钮，在弹出的字 框中设置字体图例所使用的字体，点击<字体>按钮，在弹出的字体框中设置字体整个图例所采用的背景颜色，点击<颜色>按钮，在弹出的颜 框中设置中指针的颜色，点击<颜色>按钮，在弹出的颜色框中设置您可以将划分成若干区域，点击<增加>按钮，可以在列表中增加一个区域。点<删除>按钮，您可以删除已有的区域。点击<上移>、<下移>按钮，您可以设置区域 图 子布概定每个报表在数据集面板的布局下都有一个Main节点，这个布局节点即是这个报表的总体布局，可以以它为父节点定义子布局，在布局下的布局树上所有节点支持双击打开数据集面板的布局，按取Main图109点<新建>菜单项，可以打开子布局定义信息图110点<确定>行图111使 条形能，主要表现在条形码输出如(JPG,PNG,JPEG)，条形码打印等两方面。报表主要支持户可以基于条码标准，实现API生成条形码。图112依理解依赖能更进一步理解扩展。在单元格扩展时，会在报表中行、列，在的行列中与扩展格对应的单元格可以为可扩展单元格计算的结果，其他单元格需根据依赖关B1依赖于A1，则B1称为附属格，A1依赖方赖 依赖规图113如上图，因为B2行依赖于A2，C2行依赖于B2，所以结果中会 114附属格D3C1D3C1D2D2如果是一个可扩展单元格，则可以定义为D3依赖于D2。如下图所示：设置方

图115 扩 扩展方扩展特一个单元格扩展，除了他本身被出多个格，还会导致其它单元格的和拉伸。以制；其他与被扩展格在相的格被拉伸。扩展规 图117 赖于 赖于 赖于 赖于C3根据上面的单元格扩展影响，B1扩展是B2，B3，C3，C4都被 赖格B1被拉伸，兄弟格B2被拉伸，B3没有影响，C4被 设置方图118行图119图120行时，如果的新行的某个单元格横向某个合并单元格，那么这个单元格也会成为合并格的一部分，同时，如果所行下面的所有行内单元格的行赖会自动列图121图122列时，如果所的列中某个单元格纵向某个合并单元格，那么过程中这个单元格将成为合并单元格的一部分。同时，所列后面的所有列内单元格的行赖项删除图123图124 删除图125图126 追加追加剪切剪切行 列 粘贴 粘贴 样式管 图127点击<新建>按钮，系统弹出“样式 框，您可以 框中设置您需要的样式图128点击<编辑>图129 点击<删除>点击<导入>按钮可以导入已有的样式库文件 类型点击<上移>、<下移>按钮可以改变样式在列表中的顺序应用样图130设置基准 图131的如下图所示图132 图 图134135显示报表属性图136图136A4：210*297B5：176*250C5：162*229Letter：216*279Legal：216*355Executive：184*266#10：105*241【注意】<恢复缺省值>按钮可以将页面设置恢复至初始状图137定义报表后，您可以点 的<预览>按钮，来进行设计器预览报表，如下图所示图138图139在值字段下的记录中，选择或输入参数值后，点<确定>按钮进入到报表预 图140选择好路径后点击<Finish>按钮，提示发布成功。如下图所图141 图图142 图143报 图144不同的数据源，同样一个数据源也可以被多个报表。Report支持的数据源类型有DRM数据源、XML数据源、过程数据源、JDBC数据源以及API数据源，并且支持用户自定Report默认基于DRM组件数据库。系统通过执行用户构建的SQL查询语句获得报表数据的结果集，支持的数据库包括：Oracle、DB2、MSSQLServer、MySQL。DRMReport默认基于DRM组件数据库。系统通过执行用户构建的SQL查询语句获得报表数据的结果集，支持的数据库包括：Oracle、DB2、MSSQLServer、MySQL。进入报表支撑数据库report，打开表DRM_SYS_DATASOURCE，配置数据源时进行表格4-2字段名说字段数据源连接池来源(有三种UDOLINK、WEBLOGIC 数据源的URL见该表下方说 01【注意】上表中红色的“字段值”为固定值，不要进行更改。如果字段POOLPROVIDER的WEBLOGIC/WEBSPHEREWEBLOGIC/WEBSPHERE服务器中配置连接池，字段DBURL的值则等于配置后WEBLOGIC/WEBSPHEREJNDINAME的值。Oracle数据库中数据源URL格式如下：jdbc:oracle:thin：是oracle数据库的连接CHCC：是数据库的jdbc:db2：是DB2数据库的连接方式；SQLSERVER数据源URLCHCC：是数据库名当存放数据源的表DRM_SYS_DATASOURCE中的POOLPROVIDER字段等于字段名说字段 DRM_SYS_DATASOURCE填入登录的用户名（大写登录的用户名（大写表格4-2增加新的数据源后，需修改报表引擎端应用下WEB-INF\conf\unieap\report 数据源配置文件report-datasource.xml，在其中添加DRM数据源信息。<CategoryName="drm"Caption="UniEAPdrm数据源"<DataSourceName="northwind" <Category<CategoryName="drm"Caption="UniEAPdrm数据源"<DataSourceName="northwind"XMLReport支持以XML文件形式组织的数据源请将XML数据源文件放置在引擎应用下的 中，作为报表系统XML数据源。对XML文件格式的要求如下所示 <Data>三川实 <Data>销售代表 <Data>华北<Data>中国<Data>东南实业·搜索 <Data>物主 <Data>华北<Data>中国<Data>坦森行贸易 <Data>物主<Data>石家庄<Data>华北<Data>中国<COL<Data>国 <Data>方先生<Data>销售代表 <Data>华南<Data>中国<Data>东帝望<Data>成先生DataSet，第一个元素 <Data>市场经理 921号<Data>青岛<Data>华东<Data>中国<Data>赐 <Data>市场经理<Data>厦门<Data>华南<Data>中国RowData表示行数据。这里Names、Types、Row下的子元素个数应该相同，应为这个数据集的列数。增加新的数据源后，需修改报表引擎端应用下WEB-INF\conf\unieap\report 数据源配置文件report-datasource.xml，在其中添加XML数据源信息。<CategoryName="xml"Caption="<CategoryName="xml"Caption="简单xml数据源"<DataSourceName="xml"Caption="xml测试<ParamName="location"过程数据<?xml<?xmlversion="1.0"encoding="UTF-<CategoryName="sp"Caption="UniEAPsp数据源"<DataSourceName="northwind"Caption="Report30样例库 JDBC数据的结果集。增加JDBC数据源的方法如下：在引擎应用下的\WEB-INF\conf\unieap\report\PoolConfig.xml文件中添加数据库<?xmlversion="1.0"encoding="UTF-<tns:pool-configxmlns:tns="http /report/PoolConfig.xsd<tns:c3p0-connection<tns:min-pool-size>4</tns:min-pool-<tns:max-pool-size>15</tns:max-pool-<tns:checkout-timeout>2000</tns:checkout-<tns:max-idle-time>60</tns:max-idle-<tns:idle-connection-test-period>30</tns:idle-connection-test-<tns:test-connection-on-checkin>false</tns:test-connection-on-<tns:test-connection-on-checkout>false</tns:test-connection-on-</tns:c3p0-<tns:c3p0-connection</tns:c3p0-</tns:pool-在引擎应用下的WEB-INF\conf\unieap\report\report- 文件中添JDBC数据源信<?xml<?xmlversion="1.0"encoding="UTF-<CategoryName="jdbc"Caption="JDBC数据源"<DataSourceName="northwind"Caption="Report30样例库在引擎应用下 WEB-INF\conf\unieap\report\report-engine-Drm修改为JDBCmSQLUtilAPI数据 数据源是数据源扩展方式之一，实现该数据源的方法如需要实现引擎中com.neusoft.report.engine.dataset.APIDataEntity法publicObject[]next();publicintsize();publicStringgetName();publicString publicString[]getFieldNames();publicFieldgetField(Stringname);publicField[]getFields();publicintpublicString<?xml<?xmlversion="1.0"encoding="UTF-<CategoryName="api"Caption="自定义数据源"<DataSourceName="sampleAPI"Caption="Report30样例库<ParamName="classname"除以上数据源类型外 Report还支持用户扩展实现自己的数据源类型，详细内容参《ReportSQL语句，或者使用一个过程，这个SQL执行获取的数据或者过程称之为数据集。在Report中，支持多数据源、多数据集的概念，即在同一张报表中，数据可以来源于多个DRMDRM类型数据集新建步骤如下在数据集面板中，单击右键数据集节点，选择菜单中的<新建>图145系统弹出新建数据集的向导，选择数据源类型drm，并选择需要的数据源名称，输图146点<下一步>,进入数据集定义向导页面，如下图图147输入实际应用所需的SQL语句，并根据实际需要进行数据范围控制（可以勾选限制 SQL的执行并取得数据，如下图：图148点击<完成>图149XMLXML类型的数据集新建步骤如下在数据集面板中，单击右键数据集节点，选择菜单中的<新建>图150图151点<下一步>,图152在 列表>里选择需要的实例字段列表中展现实例的字段信息如下图所示图153选择所需字段，点击<完成>APIAPI类型的数据集新建步骤如下图154图155在 列表>里选择需要的实例字段列表中展现实例的字段信息如下图所示图156选择所需字段，点击<完成>SP数据SP类型数据集新建步骤如下图157图158点<下一步>按钮，进 过程数据集的定义向导界面，如下图所示图159过程数据集的定义方式使用callprocedureName($name1,#name2...)call是调用命 (…)inin 图160 过程数据集”窗口的定义框中填写call语法函数，如下图所示图161新 加name字段，至此完成此 图162新 定义报表参数pa、pb等，在定义 过程数据集中指定in参数，名称为pa、pb（与图163新 Inline图164图165进入定义inline4-19xml数据录入和表格录Xml数据录 <Data>三川实 <Data>销售代表 <Data>华北<Data>中国<Data>东南实业·搜索 <Data>物主 <Data>华北<Data>中国<Data>坦森行贸易 <Data>物主<Data>石家庄<Data>华北<Data>中国<COL<Data>国 <Data>方先生<Data><Data>销售代表 <Data>华南<Data>中国<Data>东帝望<Data>成先生<Data>市场经理 921号<Data>青岛<Data>华东<Data>中国<Data>赐 <Data>市场经理<Data>厦门<Data>华南<Data>中国DataSet，第一个元素Names所有列的名字，每个名字在Name中定义；RowData表示行数据。这里Names、Types、选择字段页（默认为字段页），+点<增加>按钮逐个增加要内建的数据集的字段信息，输图166选择数据页，进入记录数据表格，可以看到此表的字段名称已经自动按步骤1所录入字图167图168图169JDBCJDBC类型数据集新建步骤如下图170系统弹出新建数据集的向导，选择数据源类型jdbc，并选择需要的数据源名称，输图171点击<下一步>图172以及图173点击<完成>导入数据点击数据集面板上数据集节点的右键菜单上的<导入>；如下图所示图174图175导出数据图176 图177删除数据 图178图179参参数定图180图181 COMBOBOX、LIST、RADIO、CHECKBOX控件时，参数值的SQL语句查询的数SQLSQL值和值值进行选择时，可能会影响其他参数的预设值。比两个参数：省和市，当选择不同的省果多选的时候关联关系可能就是in，多个省下的所有市。参数使用图182设值来源于数据库，添加预设值查询的数据源及SQL语句，设置标题对应的字段product_name和值对应的字段product_id 参数的采用$xx的方式，即参数名为name，则对变量的是列出该单元格中的product_id等于参数name的product_name。参数定义后，报表展现时自动生成的参数页面如下图所示图183参数联动图184参数定义 参数的名称是选择的控件类型为应的字段typename和值对应的字段typeid；图185图186图187参数排图188图189编写自定义参数页面的jsp文件。Report-ResultAction.do的介绍详见《ReportReport-ResultAction.do后，才能进行参数的替换。以下为自定义参数页面jsp文件的例子，以供参考：request.setCharacterEncoding("utf-<title>报表展现结果functionisOk(){.myForm.action="Report-ResultAction.do?reportId=d74df10e-}<inputtype="text"<inputtype="button”name="btn"value="提