StyleReport报表服务管理手册50页文档资料Word文件下载.docx
《StyleReport报表服务管理手册50页文档资料Word文件下载.docx》由会员分享，可在线阅读，更多相关《StyleReport报表服务管理手册50页文档资料Word文件下载.docx（95页珍藏版）》请在冰点文库上搜索。
编程指南（ProgrammingGuide）
本文档包含了StyleReport所有的特性描述，如果用户使用到javaAPI的方式，或者需要理解报表的特性就需要阅读着这个文档。
DataModel数据模型指南（DataModelerGuide）
StyleReport包含的分析模块（用户可选择购买），可以进行高级的数据分析，本文档详细介绍了开发者如何来建立和增加这些功能模块。
DataWorksheet指南（DataWorksheetGuide）
StyleReport包含的分析模块（用户可选择购买），本文档描述了如何使用DataWorksheet的简化方式来完成复杂的数据分析功能。
用户指南（UserGuide）
StyleReport企业版中有许多可供用户对报表进行操作和数据处理的功能，本文档详细描述了最终用户如何使用这些功能在Web界面上。
III白皮书
StyleReport白皮书
本文档是StyleReport的高度特性概括，包括了同其他报表解决方案的比较。
IVAPI文档
API参考文档
API文档是java语言类的一个集合。
包括了所有定义的类和方法。
2可选择组件
StyleReport企业版可以加入一些分析的功能组件，用户可以在企业版的基础上自选购买，包括ad-hoc（即席报表），预警功能，OLAP分析，和JetspeedPortal集成接口等。
可选组件
描述
即席报表
在Web界面上最终用户可以用拖拽方式来新建报表，用户可以控制报表元素增加，数据绑定，格式以及样式风格，在有设定权限准许的情况下，用户还可以修改已经存在的报表。
在线预警
用户可以给设定一些条件，可以在确定的时间间隔告警，并通过设定的格式以e-mail发送用户来达到监控数据或绝对级的目的。
OLAP分析
StyleReport可模拟分析服务器来进行数据的向上钻取和向下钻取的功能，可以达到OLAP服务器的标准筛选有用数据。
他也可以直接访问OLAP服务器，来完成所有OLAP服务器所能完成的功能。
与JetspeedPortal集成
用户可以集成到ApacheJetspeedPortal服务器中，这样最终用户可以将多个报表在一个页面中显示，也就是常说的仪表盘。
DataWorksheet
通过这个功能模块可以使用户很便利的对生成复杂的数据分析和汲取重要信息，用户在没有数据库和查询语句的知识条件下可以建立复杂的查询语句。
3关于帮助文档
3.1先决条件
在正确安装好StyleReport软件后可以查看本帮助文档。
3.2文档规定
一些关键字体都是以斜体形式来表现的。
•一些重要的概念和或者例子都是以下列固定的方式和字体显示的
•还会有备注重要的信息，如：
•一些例子会有详细的步骤来说明，和图片显示。
1.建立新的报表，点‘BlankTabularReport’，然后点‘OK’.
•源代码和操作系统命令用以下固定的格式出现，比如：
javainetsoft.report.design.Designer
•完整代码例子会以列表标题的方式展现，并以如下固定的字体宽度被打印。
Listing1.ReportTemplate
<
?
xmlversion="
1.0"
encoding="
UTF-8"
>
ReportTop="
Left="
Bottom="
Right="
3.3目的
此文档的编写目的是为介绍StyleReportEE服务器的工作平台和EnterpriseManager的使用者怎样来管理这个平台的说明手册。
Replet工作平台的管理
一个服务器端报表被称为ireplet.逻辑上的replets的收集后将被保存在一个报表储存库中。
这个储存库有几种实现方式，包括一个基于web的报表浏览器程序、基于java的报表浏览器RMI、CORBA。
服务器端的报表工作平台的设计及框架构建都将在此章中说明。
StyleReportEnterpriseManager的使用
EnterpriseManager是一个基于web的服务程序，它是作为StyleReport报表储存库的一个管理工具来提供的。
在此章文字中，描述了怎样利用EnterpriseManager来进行报表储存库的管理。
如何配置Replets
当replets发展增多时，可以用EnterpriseManage来创建一个replets储存库。
也可以利用它来配置一个已经存在的储存库，并为这个储存库配置一个WAR文件。
此节文章描述了如何一步步来进行这些配置的步骤。
疑难解答
通常会出现的问题及它们的解决办法。
4管理Replet平台
4.1简介
一个replet可以在广义上被定义为发布到服务器（web应用服务器,RMIserver或者CORBAserver）上的报表。
StyleReport的报表可以使用设计器或纯JAVA编码两种方式来设计，它们都可以被发布到报表服务器上，也就是说，他们都可以被称为replet。
StyleReport提供一个基于servlet的被称为EnterpriseManager的管理界面，这个工具提供一个WEB界面来管理replet环境。
它使得报表发布、安全管理、展现管理以及报表引擎的性能调优都变的极其方便。
插图1.RepletEnvironment
4.2入门
我们从发布一个报表模板文件（.srt）为一个replet开始。
在此，我们首先通过在EnterpriseManager界面发布一个简单的模板文件来介绍这个过程。
你可以在你的安装路径下找到模板例子installation_folder\Tomcat\webapps\sree\WEB-INF\classes\inetsoft\demo\templates。
拷贝toolbars.srt（或任何一个模板文件）到classes目录。
首先从StyleReport菜单中启动enterprisemanager，EnterpriseManager（AdmServlet）中提供支持的Tomcatserver已经被展开。
现在，打开一个web浏览器并且将其连接到下列URL：
http:
//localhost:
8080/sree/EnterpriseManager。
在左边的导航树上依次点开节点“Repository->
RepleteRegistry”，点击“Folders&
Replets”旁边的编辑按钮，将出现如下界面：
插图2.文件夹与Replet的管理
注册一个replet，点击‘AddReplet’.，将打开下面所示窗口。
插图3.增加一个Replet
按下面表格的说明填写这个对话框：
字段
值
说明
文件夹
Guide
允许选择一个被创建的文件夹。
登录到此页的replet将被添加到文件夹中。
Name
Toolbars-2
这个字段包括着被用来指向报表的名称。
Alias
Toolbars-2-Alias
是在你如果需要时，可设置的别名。
Type
Template
如果发布的replet是一个用java编写的类，则选择class，如果是模板（.srt），则选择Template。
也可以选择Upload来上载模板。
HTML布局
Default
默认的表格转换方式是转变为html格式。
类/模版
/toolbars.srt
如果replet是一个模版，则填写包含在相对路径下的模板文件名；
如果是class，则填写包含类的包在内的全来名，如com.deom.Demo。
点击‘Save’。
系统将把这些信息储存到repository.xml中。
打开一个浏览器，键入下面URL
8080/sree/Examples
我们可以通过报表浏览截面来查看刚才发布好的报表。
插图4.Toolbar-2报表
4.3Thesree.home目录
‘sree.home’是一个目录，包含着重要的报表库配置配置文件。
两个最重要的配置文件是：
•sree.properties–包含着最关键的报表服务器的配置信息。
在sree.properties中的路径可以利用一个完全的路径来指定，或在相关的sree.home路径上，可以利用可变的环境e.g.$（sree.home）\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）和EnterpriseManagerservlet的初始化参数被指定。
然而，如果配置文件放置在类路径的根部，那么sree.home初始化参数并不是必需的（i.e.inWEB-INF/classes）。
4.4并发
定义相关的报表引擎中的并发数.我们需要定义报表引擎，并发数作为可以在同一时间用报表引擎sessions的用户来定义。
用户在他登陆后session开始。
在用户退出或者当所有的报表同用户的session超时时，session停止。
4.5报表库对象的执行
在StyleReport中，有一系列的ready-to-use报表库服务器组成构件。
•基于servlet的嵌入报表引擎服务程序。
基于报表的webreplet存储执行程序。
•服务器集群的服务程序。
载入平衡储存库端的replet储存库的执行服务程序。
用户必须为一个执行向导指定片断3.6。
•RMIReplet存储库
RMI服务器对象执行replet存储。
•CORBAReplet存储库
CORBA服务器对象执行replet存储。
我们点击相应的‘Edit’图标和选择适当的服务器类型来更改服务器类型，然后点击‘Save’。
插图5.选择Server类
如果我们选择基于servlet嵌入式报表引擎为服务程序，我们只需要从主服务器页面重起储存库。
RMI和CORBA服务器类型可以从主服务器页面被启动，停止和重起。
replet存储库是主服务器构件。
它可以从客户端可靠的处理所有的replet-related请求。
也可以管理已注册的replets和当前使用的replet程序。
API是为储存库在RepletRepository界面定义的，然而，应用程序并不需要直接使用API储存库。
4.5.1基于servlet的嵌入式报表引擎服务程序
这是最常用的报表引擎，在这个配置下，我们通过一个内嵌了报表引擎的的servlet来访问报表库。
通过这个引擎，我们可以通过浏览器看到所有的报表。
插图6.EnterpriseManager主要服务器页面
注意：
在这个界面中“restart”按钮不能重起应用服务器服务器程序。
它仅仅是通过重新加载sree.properties来刷新与报表服务器相关的配置。
我们的报表库服务程序URL（RepositoryServletURL）指定了访问报表浏览引擎（StyleReportEEreportserver）的URL。
它必须通过服务器端应用程序与已有的URL相匹配。
如果属性中包含一个不同的URL，它就不能正确地访问服务程序。
在大部分的服务器应用程序中，属性可以设置为空白，所以服务程序建立它自己的url。
然而，一些服务器应用程序不能向服务程序正确地返回url。
既然如此，服务程序url属性就必须可以用来覆盖并提供正确的url。
其他类型的引擎，我们将专门制作文档介绍！
5StyleReportEnterpriseManager的使用
5.1简介
EnterpriseManager推动下列的典型管理任务：
•管理XML配置文件和标准的属性文件。
•无论他们是否为servlet，RMI或CORBA，启动和停止服务器组成。
•管理计划任务和启动、停止计划任务服务器。
•管理报表存档容量。
•在StyleReport上打包、配置和注册报表。
•管理和配置安全机制，包括创建用户和角色
•默认的安全提供者管理用户和角色定义。
在下面，我们将说明EnterpriseManager的使用。
贯穿EnterpriseManager始终，路径和文件名称不允许包括中文或其他unicode字符。
5.1.1浏览器设置的需求
EnterpriseManager支持4.0或更高版本的浏览器。
（Netscape4.x
或IE4.x或更高版本）。
唯一的要求就是浏览器必须同一个Java虚拟机器相链接并在网页上执行JavaScript。
NetscapeNavigator
在Netscape中，选择‘Edit->
Preferences’.
插图9.NetscapeAdvancedPreferences
MicrosoftInternetExplorer
在IE上，选择‘Tools->
InternetOptions...’
插图10.InternetExplorerAdvancedInternetOptions
5.2用SSL启动EnterpriseManager
假设SSL已经用Tomcat配置，因此，EnterpriseManager可以在TOMCAT_HOME/conf/server.xml文件之后的无标注内容来启动：
Connector
className=”org.apache.tomcat.service.PoolTcpConnector”>
Parametername=”handler”
value=”org.apache.tomcat.service.http.HttpConnectionHandler
Parametername=”port”
value=”8443”/>
Parametername=”socketFactory”
value=”org.apache.tomcat.SSLSocketFactory”/>
/Connector>
现在EnterpriseManager通过下列URL来访问：
8443/sree/EnterpriseManager，
利用SSL来执行鉴定任务。
.
5.3主服务器页面
当EnterpriseManager启动后，它默认为‘MainServer’页面，可以在主服务器的导航树上发现‘MainServer’页面。
从服务器主菜单中我们看出可以执行下列操作：
•更改服务器类型
•更改servletURL（如果报表储存库是基于web的servlet，那么为这些文件拥有有效的写入值是非常重要的）
•更改serverURL（如果报表存储库是一个非web的java客户端）
•检查状态，‘Running’或者‘Stopped’
•配置LicenseKeys.
•‘Start’,‘Stop’或是‘Restart’报表储存库，注意：
如果报表储存库是基于servlet的web，我们仅仅可以重启，这里并不支持开始、停止。
5.3.1更改服务器类型
如果我们点击‘edit’链接旁的ServerType，我们将调上来以下的让我们更改服务器类型的对话框。
插图11.更改服务器类型
选择我们所使用的报表储存执行并点击‘Save’。
5.3.2编辑URL
这里有两种类型的URL：
RepositoryServletURL和ServerURL。
RepositoryServletURL是指报表库的webURL。
如果我们在web浏览器上使用这个链接，我们将会看到我们的报表储存库（假定储存库程序运行在appserver里）。
URL需要正确的格式化，否则我们连接不上储存库服务程序，例如：
‘http:
8100/servlet/SreeServlet’如果你使用一个和EnterpriseManager相同的服务程序url，主机的ip地址和端口号就可以被忽略。
所以相关的url格式就要与‘/sree/Examples’相类似。
ServerURL涉及到用来将其绑定报表储存库对象到RMIregistry的绑定的名称，或者CORBA名称服务程序（取决于我们是否使用RMI，集群或者CORBA）。
URL有若干的格式，关于我们报表存储库的命名和绑定是灵活多变的。
下列的为格式：
//[server-name]:
[port-number]/[bindingname]
servername的名称是必需的。
portnumber是可选的，如果没有指定端口号，那么将使用默认的RMI端口号1099，COBBA端口号1050。
bindingname是可选的。
如果没有指定，那么基于储存库的RMI默认为RepletRepository。
基于COBBA的存储库也默认为RepletRepository。
5.3.3License文件
在EnterpriseManager中，如果需要使用附加模块，那么确认‘srlicense.dat’文件保存到sreehome。
如果文件被储存到其它的目录中，在EnterpriseManager的license文件中输入全部的路径。
5.4配置页面
通过点击导航树上的配置链接，我们可以更改服务器的类型。
展开配置节点，我们就可以设置下列服务器端报表工作环境的问题：
表2.配置节点下的链接
链接
集群
允许为集群中的节点来配置选项。
Java
将显示服务器CLASSPATH的应用程序
数据库/库
可以为数据库、query和库文件指定位置。
邮件
如果报表需要发送给用户，那么可以用来设置邮件设定值
服务器打印机
服务器旁的打印机列表，通常用来输出报表
本地化
配置报表内容的本地化
最大Session页面
注册惯用的显示页面来通知用户所有可以利用的sessions都被利用上了。
5.4.1集群
如果我们选定了一个支持集群的服务器类型，此集群页面才为我们展示。
插图12.集群页面
“RestartAll”按钮被用来重新启动所有的群集节点。
表3.集群管理选项
选项
检验框
如果我们希望从菜单中删除一个节点，就从这里选择。
编辑节点
当我们编辑一个已有的URL节点时，会像创建一个RMI或者是服务器URL的时候一样，应用相同的格式规则。
请注意上面的“EditingtheURL”。
点击‘Add’来添加一个新的节点，‘Delete’来选择移出一个节点。
5.4.2Java
此页简单的介绍了关于应用服务器的JVM和CLASSPATH.的一些信息。
5.4.3数据资源
此页面允许定义指定的datasource.xml和query.xmlregistry注册文件。
一个附加的boolean选项可以指出query的名称是否是唯一的。
此页面也承认StyleReportbeans的Bean库的规格。
你可以指定JDBC数据资源使用的连接池类型。
如果选择应用服务程序连接池，在数据资源注册文件中的数据资源名称必须与应用服务程序中的JNDI数据资源名称相匹配。
所支持的应用程序服务器有Tomcat,WebSphere,WebLogic。
如果选择用户定义，就必须输入全部有效的所提供的文本文件连接池执行的类名称。
5.4.4邮件
Mail配置控制着计划任务怎样邮寄一个报表给用户。
这封E-mail总是从一个固定的e-mail地址来发送，这是指定的mail配置的一部分。
为使e-mail的传送工作正常进行，mail的主机必须配置好并且选择一个有效的SMTP服务器。
系统管理E
升级会员 