此文档说明如何使用Smartbi服务器端SDK.

请参见:
          描述

软件包
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.operationLog 操作日志管理功能包
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.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结构。