概览

程序包
程序包	说明
smartbi.catalogtree
smartbi.sdk	SmartbiSDK基本包，包含跟服务器通讯的基础类。
smartbi.sdk.service.analysisreport	多维分析功能包
smartbi.sdk.service.businesstheme	业务主题功能包
smartbi.sdk.service.businessview	业务查询管理包
smartbi.sdk.service.catalog	资源目录树的访问功能包
smartbi.sdk.service.combinedquery	组合分析功能包
smartbi.sdk.service.datasource	数据源管理功能包
smartbi.sdk.service.graphicreport	图形分析类报表访问包
smartbi.sdk.service.insight	透视分析功能包
smartbi.sdk.service.metadata	元数据功能包
smartbi.sdk.service.officereport	Office分析功能包
smartbi.sdk.service.oltpmetadata	灵活分析元数据功能包
smartbi.sdk.service.parameter	参数相关功能包
smartbi.sdk.service.pool	缓存池功能包
smartbi.sdk.service.portal	仪表盘功能包
smartbi.sdk.service.simplereport	灵活分析功能包
smartbi.sdk.service.spreadsheetreport	电子表格功能包
smartbi.sdk.service.systemconfig	系统设置功能包
smartbi.sdk.service.user	用户管理功能包
smartbi.user

　　此文档说明如何使用Smartbi服务器端SDK.
　　Smartbi 服务器端SDK通过JAVA API提供:CatalogService、Systemconfig、OperateionLog、SimpleReportService、ManageReportService、AnalysisReportService以及UserManagerSerive七项服务接口。
　　1. CatalogService: 提供资源目录树的访问功能等。
　　2. Systemconfig: 系统设置相关操作功能。
　　3. OperateionLog: 提供操作日志相关操作功能
　　4. SimpleReportService: 提供灵活报表相关操作功能。
　　5. ManageReportService: 提供业务报表相关操作功能。
　　6. AnalysisReportService: 提供多维分析相关操作功能。
　　7. UserManagerSerivce：提供用户相关操作，包括：读取/维护用户信息、读取/维护组信息、读取/维护角色信息、为用户和组分配角色等。

　　布署步骤：
　　1. 假设Smartbi服务器已经部署到应用服务器中，访问地址为：http://server:8080/smartbi/vision。
　　2. 打开服务器部署文件smartbi.war，解压后将smartbi.war\WEB-INF\lib\目录下的smartbi-SDK.jar、smartbi-Common.jar、commons-logging-1.1.jar、ezmorph-0.8.1.jar、commons-beanutils.jar、commons-collections-3.2.2.jar 包加入到您的JAVA项目的classpath中去。
　　使用说明：
　　1. 创建应用连接器。在跟Smartbi服务器进行任何通信之前必须先创建一个ClientConnector对象，即应用链接器。客户代码仅需要创建一个ClientConnector实例。
　　　例如：
　　　 String connectorURL = "http://localhost:8080/smartbi";
　　　 ClientConnector conn = new ClientConnector(connectorURL);
　　　 conn.open("username", "password");
　　2. 创建服务对象。以ClientConnector为构造函数参数，创建是将之前的ClientConnector实例传入。
　　　例如：
　　　 CatalogService catalogService = new CatalogService(conn);
　　　 UserManagerService userService = new UserManagerService(conn);
　　3. 使用服务对象。在获得服务对象后就可以进行所需的操作了，具体的用法请参考示例。
　　4. 关闭应用连接器。操作完毕后必须关闭应用连接器，最好采用finally结构，例如：
　　　 try{
　　　　　//操作服务对象
　　　 }catch(RemoteException e){
　　　　　e.printStackTrace();
　　　 }finally{
　　　　　//关闭应用连接器
　　　　　conn.close();
　　　 }
　　5. 错误处理。SDK提供RemoteException对来自smartbi服务器的异常进行封装。需要注意的是，RemoteException是一个RuntimeException，因而不会显示要求进行处理，如果需要严格的错误处理可以使用try-catch结构。