StyleReport报表服务管理手册50页文档资料Word文件下载.docx

1、编程指南（Programming Guide）本文档包含了Style Report所有的特性描述，如果用户使用到java API的方式，或者需要理解报表的特性就需要阅读着这个文档。Data Model数据模型指南（Data Modeler Guide）Style Report包含的分析模块（用户可选择购买），可以进行高级的数据分析，本文档详细介绍了开发者如何来建立和增加这些功能模块。Data Worksheet指南（Data Worksheet Guide）Style Report包含的分析模块（用户可选择购买），本文档描述了如何使用Data Worksheet的简化方式来完成复杂的数据分析功

2、能。用户指南（User Guide）Style Report企业版中有许多可供用户对报表进行操作和数据处理的功能，本文档详细描述了最终用户如何使用这些功能在Web界面上。III 白皮书Style Report白皮书本文档是Style Report的高度特性概括，包括了同其他报表解决方案的比较。IV API文档API参考文档API文档是java语言类的一个集合。包括了所有定义的类和方法。2 可选择组件Style Report企业版可以加入一些分析的功能组件，用户可以在企业版的基础上自选购买，包括ad-hoc（即席报表），预警功能，OLAP分析，和Jetspeed Portal集成接口等。可选组件

3、描述即席报表在Web界面上最终用户可以用拖拽方式来新建报表，用户可以控制报表元素增加，数据绑定，格式以及样式风格，在有设定权限准许的情况下，用户还可以修改已经存在的报表。在线预警用户可以给设定一些条件，可以在确定的时间间隔告警，并通过设定的格式以e-mail发送用户来达到监控数据或绝对级的目的。OLAP 分析Style Report可模拟分析服务器来进行数据的向上钻取和向下钻取的功能，可以达到OLAP服务器的标准筛选有用数据。他也可以直接访问OLAP服务器，来完成所有OLAP服务器所能完成的功能。与Jetspeed Portal集成用户可以集成到Apache Jetspeed Portal服务

4、器中，这样最终用户可以将多个报表在一个页面中显示，也就是常说的仪表盘。Data Worksheet 通过这个功能模块可以使用户很便利的对生成复杂的数据分析和汲取重要信息，用户在没有数据库和查询语句的知识条件下可以建立复杂的查询语句。3关于帮助文档3.1先决条件在正确安装好 Style Report 软件后可以查看本帮助文档。3.2文档规定一些关键字体都是以斜体形式来表现的。 一些重要的概念和或者例子都是以下列固定的方式和字体显示的 还会有备注重要的信息，如： 一些例子会有详细的步骤来说明，和图片显示。1. 建立新的报表，点Blank Tabular Report，然后点OK.源代码和操作系统命

5、令用以下固定的 格式出现，比如：java inetsoft.report.design.Designer完整代码例子会以列表标题的方式展现，并以如下固定的字体宽度被打印。Listing 1. Report TemplateReport Top= Left= Bottom= Right=3.3 目的此文档的编写目的是为介绍Style Report EE 服务器的工作平台和Enterprise Manager的使用者怎样来管理这个平台的说明手册。Replet 工作平台的管理一个服务器端报表被称为i replet.逻辑上的replets的收集后将被保存在一个报表储存库中。这个储存库有几种实现方式，包

6、括一个基于web的报表浏览器程序、基于java的报表浏览器RMI、CORBA。服务器端的报表工作平台的设计及框架构建都将在此章中说明。Style Report Enterprise Manager的使用Enterprise Manager是一个基于web的服务程序，它是作为Style Report报表储存库的一个管理工具来提供的。在此章文字中，描述了怎样利用Enterprise Manager来进行报表储存库的管理。如何配置Replets当replets发展增多时，可以用Enterprise Manage来创建一个replets储存库。也可以利用它来配置一个已经存在的储存库，并为这个储存库配置

7、一个WAR文件。此节文章描述了如何一步步来进行这些配置的步骤。疑难解答通常会出现的问题及它们的解决办法。4 管理Replet平台4.1 简介一个replet可以在广义上被定义为发布到服务器（web应用服务器, RMI server 或者 CORBA server）上的报表。Style Report的报表可以使用设计器或纯JAVA编码两种方式来设计，它们都可以被发布到报表服务器上，也就是说，他们都可以被称为replet。Style Report提供一个基于servlet的被称为Enterprise Manager的管理界面，这个工具提供一个WEB界面来管理replet环境。它使得报表发布、安全管

8、理、展现管理以及报表引擎的性能调优都变的极其方便。插图1. RepletEnvironment4.2 入门我们从发布一个报表模板文件（.srt）为一个replet开始。在此，我们首先通过在EnterpriseManager界面发布一个简单的模板文件来介绍这个过程。你可以在你的安装路径下找到模板例子installation_folderTomcatwebappssreeWEB-INFclassesinetsoft demo templates。拷贝toolbars.srt（或任何一个模板文件）到classes目录。首先从Style Report菜单中启动enterprise manager，En

9、terprise Manager（AdmServlet）中提供支持的Tomcat server已经被展开。现在，打开一个web浏览器并且将其连接到下列URL：http:/localhost:8080/sree/EnterpriseManager。在左边的导航树上依次点开节点“Repository-Replete Registry”，点击“Folders & Replets”旁边的编辑按钮，将出现如下界面：插图2. 文件夹与Replet的管理注册一个replet，点击Add Replet.，将打开下面所示窗口。插图3. 增加一个 Replet按下面表格的说明填写这个对话框：字段值说明文件夹Gui

10、de允许选择一个被创建的文件夹。登录到此页的replet将被添加到文件夹中。NameToolbars - 2这个字段包括着被用来指向报表的名称。AliasToolbars - 2 - Alias是在你如果需要时，可设置的别名。TypeTemplate如果发布的replet是一个用java编写的类，则选择class，如果是模板（.srt），则选择Template。也可以选择Upload来上载模板。HTML布局Default默认的表格转换方式是转变为html格式。类/模版/toolbars.srt如果replet是一个模版，则填写包含在相对路径下的模板文件名；如果是class，则填写包含类的包在内

11、的全来名，如com.deom.Demo。点击Save。系统将把这些信息储存到repository.xml中。打开一个浏览器，键入下面URL8080/sree/Examples我们可以通过报表浏览截面来查看刚才发布好的报表。插图4. Toolbar -2报表4.3 The sree.home目录sree.home是一个目录，包含着重要的报表库配置配置文件。两个最重要的配置文件是： sree.properties 包含着最关键的报表服务器的配置信息。在sree.properties中的路径可以利用一个完全的路径来指定，或在相关的sree.home路径上，可以利用可变的环境e.g.$（sree.ho

12、me）repository.xml来指定。 repository.xml 存储报表库的逻辑结构。其他的配置文件包括： schedule.xml 包含着计划任务的配置的xml规范。 datasource.xml 包含报表应用程序的数据源的配置的xml规范。 query.xml. 包含特别数据源相关的query的xml规范。 sree.log 无格式文本文件包含SREE服务器的日志事件。 schedule.log 无格式文本文件包含着服务器的计划任务组成的日志。sree.home通常作为Report储存服务程序 （inetsoft.sree.web.ServletRepository）和Enter

13、prise Manager servlet 的初始化参数被指定。然而，如果配置文件放置在类路径的根部，那么sree.home初始化参数并不是必需的（i.e. in WEB-INF/classes）。4.4 并发定义相关的报表引擎中的并发数 .我们需要定义报表引擎， 并发数作为可以在同一时间用报表引擎sessions的用户来定义。用户在他登陆后session开始。在用户退出或者当所有的报表同用户的session超时时，session停止。4.5 报表库对象的执行在StyleReport中，有一系列的ready-to-use报表库服务器组成构件。 基于servlet的嵌入报表引擎服务程序。基于报表

14、的web replet存储执行程序。 服务器集群的服务程序。载入平衡储存库端的replet储存库的执行服务程序。用户必须为一个执行向导指定片断3.6。 RMI Replet存储库RMI服务器对象执行replet存储。 CORBA Replet存储库CORBA 服务器对象执行replet存储。我们点击相应的Edit图标和选择适当的服务器类型来更改服务器类型，然后点击Save。 插图5. 选择Server类如果我们选择基于servlet嵌入式报表引擎为服务程序，我们只需要从主服务器页面重起储存库。RMI和CORBA服务器类型可以从主服务器页面被启动，停止和重起。replet存储库是主服务器构件。它

15、可以从客户端可靠的处理所有的replet-related 请求。也可以管理已注册的replets和当前使用的replet程序。API是为储存库在RepletRepository界面定义的，然而，应用程序并不需要直接使用API储存库。4.5.1 基于servlet的嵌入式报表引擎服务程序这是最常用的报表引擎，在这个配置下，我们通过一个内嵌了报表引擎的的servlet来访问报表库。通过这个引擎，我们可以通过浏览器看到所有的报表。插图6. Enterprise Manager主要服务器页面注意：在这个界面中“restart”按钮不能重起应用服务器服务器程序。它仅仅是通过重新加载sree.proper

16、ties来刷新与报表服务器相关的配置。我们的报表库服务程序URL（Repository Servlet URL）指定了访问报表浏览引擎（Style Report EE report server）的URL。它必须通过服务器端应用程序与已有的URL相匹配。如果属性中包含一个不同的URL，它就不能正确地访问服务程序。在大部分的服务器应用程序中，属性可以设置为空白，所以服务程序建立它自己的url。然而，一些服务器应用程序不能向服务程序正确地返回url。既然如此，服务程序url属性就必须可以用来覆盖并提供正确的url。其他类型的引擎，我们将专门制作文档介绍！5 Style Report Enterpr

17、ise Manager的使用5.1 简介Enterprise Manager推动下列的典型管理任务： 管理XML配置文件和标准的属性文件。 无论他们是否为servlet，RMI或CORBA，启动和停止服务器组成。 管理计划任务和启动、停止计划任务服务器。 管理报表存档容量。 在Style Report上打包、配置和注册报表。 管理和配置安全机制，包括创建用户和角色 默认的安全提供者管理用户和角色定义。在下面，我们将说明Enterprise Manager的使用。贯穿Enterprise Manager始终，路径和文件名称不允许包括中文或其他unicode字符。5.1.1 浏览器设置的需求Ent

18、erprise Manager支持4.0或更高版本的浏览器。（Netscape 4.x或IE 4.x或更高版本）。唯一的要求就是浏览器必须同一个Java虚拟机器相链接并在网页上执行JavaScript。Netscape Navigator在Netscape中，选择Edit-Preferences.插图9. Netscape Advanced PreferencesMicrosoft Internet Explorer在IE上，选择Tools-Internet Options.插图10. Internet Explorer Advanced Internet Options5.2用SSL启动En

19、terprise Manager 假设SSL已经用Tomcat配置，因此，Enterprise Manager 可以在TOMCAT_HOME/conf/server.xml文件之后的无标注内容来启动：ConnectorclassName=”org.apache.tomcat.service.PoolTcpConnector”Parameter name=”handler”value=”org.apache.tomcat.service.http.HttpConnectionHandlerParameter name=”port”value=”8443”/Parameter name=”sock

20、etFactory”value=”org.apache.tomcat.SSLSocketFactory”/Connector现在Enterprise Manager通过下列URL来访问：8443/sree/EnterpriseManager，利用SSL来执行鉴定任务。.5.3 主服务器页面当Enterprise Manager启动后，它默认为Main Server 页面，可以在主服务器的导航树上发现Main Server 页面。从服务器主菜单中我们看出可以执行下列操作： 更改服务器类型 更改servlet URL （如果报表储存库是基于web的servlet，那么为这些文件拥有有效的写入值是非

21、常重要的） 更改server URL （如果报表存储库是一个非web的java客户端） 检查状态，Running 或者Stopped 配置License Keys. Start, Stop 或是Restart 报表储存库，注意：如果报表储存库是基于servlet的web，我们仅仅可以重启，这里并不支持开始、停止。5.3.1 更改服务器类型如果我们点击edit链接旁的Server Type，我们将调上来以下的让我们更改服务器类型的对话框。插图 11.更改服务器类型选择我们所使用的报表储存执行并点击Save。5.3.2 编辑URL这里有两种类型的URL：Repository Servlet URL

22、和Server URL。Repository Servlet URL是指报表库的web URL。如果我们在web浏览器上使用这个链接，我们将会看到我们的报表储存库（假定储存库程序运行在appserver里）。URL需要正确的格式化，否则我们连接不上储存库服务程序，例如：http:8100/servlet/SreeServlet如果你使用一个和EnterpriseManager相同的服务程序url，主机的ip地址和端口号就可以被忽略。所以相关的url格式就要与 /sree/Examples相类似。Server URL涉及到用来将其绑定报表储存库对象到RMI registry的绑定的名称，或者CO

23、RBA 名称服务程序（取决于我们是否使用RMI，集群或者CORBA）。URL有若干的格式，关于我们报表存储库的命名和绑定是灵活多变的。下列的为格式：/server-name:port-number/binding nameserver name的名称是必需的。port number是可选的，如果没有指定端口号，那么将使用默认的RMI端口号1099，COBBA端口号1050。binding name是可选的。如果没有指定，那么基于储存库的RMI默认为RepletRepository。基于COBBA的存储库也默认为RepletRepository。5.3.3 License文件在Enterpris

24、e Manager中，如果需要使用附加模块，那么确认srlicense.dat文件保存到sree home。如果文件被储存到其它的目录中，在Enterprise Manager的license文件中输入全部的路径。5.4 配置页面通过点击导航树上的配置链接，我们可以更改服务器的类型。展开配置节点，我们就可以设置下列服务器端报表工作环境的问题：表2. 配置节点下的链接链接集群允许为集群中的节点来配置选项。Java将显示服务器CLASSPATH的应用程序数据库/库可以为数据库、query和库文件指定位置。邮件如果报表需要发送给用户，那么可以用来设置邮件设定值服务器打印机服务器旁的打印机列表，通常用

25、来输出报表本地化配置报表内容的本地化最大Session页面注册惯用的显示页面来通知用户所有可以利用的sessions都被利用上了。5.4.1 集群如果我们选定了一个支持集群的服务器类型，此集群页面才为我们展示。插图12. 集群页面“Restart All”按钮被用来重新启动所有的群集节点。表3.集群管理选项选项检验框如果我们希望从菜单中删除一个节点，就从这里选择。编辑节点当我们编辑一个已有的URL节点时，会像创建一个RMI或者是服务器URL的时候一样，应用相同的格式规则。请注意上面的“Editing the URL” 。点击 Add 来添加一个新的节点，Delete 来选择移出一个节点。5.4

26、.2 Java此页简单的介绍了关于应用服务器的JVM和CLASSPATH.的一些信息。5.4.3 数据资源此页面允许定义指定的datasource.xml和query.xml registry注册文件。一个附加的boolean选项可以指出query的名称是否是唯一的。此页面也承认Style Report beans的Bean库的规格。你可以指定JDBC数据资源使用的连接池类型。如果选择应用服务程序连接池，在数据资源注册文件中的数据资源名称必须与应用服务程序中的JNDI数据资源名称相匹配。所支持的应用程序服务器有Tomcat, WebSphere, WebLogic。如果选择用户定义，就必须输入全部有效的所提供的文本文件连接池执行的类名称。5.4.4 邮件Mail配置控制着计划任务怎样邮寄一个报表给用户。这封E-mail总是从一个固定的e-mail地址来发送，这是指定的mail配置的一部分。为使e-mail的传送工作正常进行，mail的主机必须配置好并且选择一个有效的SMTP服务器。系统管理E