BO与Web系统集成方案

四川移动财务综合查询系统

BO与Web系统基础方案

本文中的所有信息归远行科技有限公司所有，未经允许，不得外传 第 1 页

BO与Web系统集成方案工件版本变更记录：

版本号 拟制/修改日期 1.0 2008-09-22

修改记录 批准人 拟制/修改人 罗兵 新建 本文中的所有信息归远行科技有限公司所有，未经允许，不得外传 第 2 页

BO与Web系统集成方案

目 录

1 引言 ..................................................................................................................................................... 4 1.1 1.2

编写目的............................................................................................................................. 4 设计思路............................................................................................................................. 4

2 术语、定义和缩略语 ......................................................................................................................... 4 2.1 2.2 2.3

术语、定义......................................................................................................................... 4 缩略语 ................................................................................................................................ 4 参考文档............................................................................................................................. 5

3 具体方案设计 ..................................................................................................................................... 6 3.1 3.1.1 3.1.2 3.1.3 3.1.4 3.1.5 3.1.6 3.1.7

BO与JAVA集成的框架结构................................................................................................ 6 用户集成登录 ..................................................................................................................... 6 所要包含的jar包 .............................................................................................................. 6 登录BOE服务器获取用户token ..................................................................................... 6 Boe服务器端保存token参数部分 .................................................................................. 6 获取访问URL ...................................................................................................................... 8 Webi报表中，URL的写法 ................................................................................................. 8 Bo系统基础实例 ................................................................................................................ 8

本文中的所有信息归远行科技有限公司所有，未经允许，不得外传 第 3 页

BO与Web系统集成方案

1 引言

1.1 编写目的

本文档说明了怎样使用BO XI R2版本的开发接口，通过用户集成登录的方式，调用BO服务器上的web intelligence报表。

1.2 设计思路

webi报表用超链接方式调用显示，在webi报表服务器端是需要用户session或者token参数的。但是现在移动项目的架构是用户集成登录的web服务器与webi报表所在的boe服务器是分离的。服务器之间无法传递session，所以只能传递token参数。

因此，要在boe服务器的web端添加一个jsp页面，把web服务器传递过来的用户token参数保存在本地session里面。这样在显示webi报表以及在webi报表中，用URL方式弹出报表时，都可以拿到用户token参数。

2 术语、定义和缩略语

2.1 术语、定义

本文使用了表1所显示的面向用户的术语、定义，包括通用词语在本文档中的专用解释。

表1

术语/定义 说 明 只需用户输入一次用户名及密码，就可以同时获得登录业务系统以及BO报表系用户集成登录 统的双重权限。 BO XI R2版本 Business Ojbect公司出品的商务智能软件。XI Release 2为产品版本号。 web intelligence报表 为bo公司出品的商务智能报表工具，特点是及时查询、灵活分析、钻取切片。

2.2 缩略语

本文使用了表2所列为本文用到的缩略语。

表2

缩略语 Webi报表 原 文 中文含义 BO公司的报表工具 web intelligence报表 本文中的所有信息归远行科技有限公司所有，未经允许，不得外传 第 4 页

BO与Web系统集成方案

缩略语 BOE服务器 Cms服务器

原 文 Business Ojbect Enterprise 服务器 Center management server 服务器 中文含义 BO公司的商务智能软件报表平台 中央管理服务器

2.3 参考文档

本文引用了表3所列的文档为本文的参考文档。

表3

文档名称 无 作者

本文中的所有信息归远行科技有限公司所有，未经允许，不得外传 第 5 页

BO与Web系统集成方案

3 具体方案设计

3.1 BO与java集成的框架结构

3.1.1 用户集成登录

在fas系统用户登录时，同时登录BOE服务器，以获得访问webi报表的权限。

3.1.2 所要包含的jar包

import com.crystaldecisions.sdk.framework.CrystalEnterprise; import com.crystaldecisions.sdk.framework.IEnterpriseSession; import com.crystaldecisions.sdk.framework.ISessionMgr; import com.crystaldecisions.sdk.occa.infostore.*; import com.crystaldecisions.webapp.CEConstants; import com.businessobjects.rebean.wi.*;

3.1.3 登录BOE服务器获取用户token //登录到boe服务器􀁺

IEnterpriseSession enterpriseSession= CrystalEnterprise.getSessionMgr() .logon(用户名, 密码, cms机器名或IP, 登录方式（默认为\"secEnterprise\"） ); //获取用户token

String enterpriseToken = enterpriseSession.getLogonTokenMgr(). getDefaultToken();

3.1.4 Boe服务器端保存token参数部分

1、 bo公司有专门针对webi报表用URL方式调用的接口。 调用路径如下。 BO XI R2版本：

http://boe服务器名或者IP:端口/businessobjects/enterprise115/desktoplaunch/ opendoc/openDocument.jsp BO XI R3版本：

http:// boe服务器名或者IP:端口/OpenDocument/opendoc/openDocument.jsp

本文中的所有信息归远行科技有限公司所有，未经允许，不得外传 第 6 页

BO与Web系统集成方案

其中一些传递参数细节参加官方文档：

Acrobat 文档

(BO XI R3版本接口参数与BO XI R2版本相同)

2、 原有调用webi报表的接口文件没有保存用户token

当用户在fas系统的web服务器上登录的时候，可以通过集成用户登录的方式拿到对应bo用户的token，此后调用webi报表没有任何问题。

但是当webi报表的内容里，包含以URL调用另一张webi报表进行显示的时候，就无法传递token参数了，导致需要用户再次输入用户名、密码进行登录，这是不允许的。 所以在调用原有URL接口文件之前，要保持住用户token。这也是为什么要在boe服务器端添加一个jsp页面来保存token、中转url调用参数。

3、 服务器添加jsp页面名为:openMyDoc.jsp

与bo原有接口openDocument.jsp文件放在一个目录下。因为调用参数数量是不定的，所以openMyDoc.jsp页面只设定了两个参数。一个是用户token参数；另一个是原有接口openDocument.jsp所支持的一系列参数字符串。

4、 openMyDoc.jsp参数具体样式

token参数：在portal中调用webi报表时，直接传递已经获得的用户token；在webi报表中以url调用webi报表时，会到session中去取用户token。

Param参数：想要掉用的bo原开发接口参数，拼接成一个字符串，‘&’符号被替换为‘@’。

5、 openMyDoc.jsp文件把用户token保存到session里，并可重复调用。

用户登录系统第一次调用openMyDoc.jsp展现webi报表时，token就被记录到boe服务器session中。之后webi报表中再以URL方式调用webi报表，就要通过openMyDoc.jsp文件了，而且可以从session中获得用户token。

本文中的所有信息归远行科技有限公司所有，未经允许，不得外传

第 7 页

BO与Web系统集成方案

代码见附件：

3.1.5 获取访问URL String url=\"\"; String sToken=\"\";

String rParam=\"lang=zh_CN@iDocID=1700\";//测试使用

if(request.getSession().getAttribute(\"bo_EnterpriseToken\")!=null &&

{

sToken = request.getSession().getAttribute(\"bo_EnterpriseToken\").toString(); }

url=\"http://pc-200806220926:8081/OpenDocument/opendoc/openMyDoc.jsp?param=\"+rParam+\"&token=\"+sToken;//组合后的URL，通过URL进行访问

3.1.6 Webi报表中，URL的写法

BO XI R2版本：

http:// boe服务器名或者IP:端口/OpenDocument/opendoc/openMyDoc.jsp? param= lang=zh_CN@iDocID=1700@token=用户token字符串

3.1.7 Bo系统基础实例

请参考给出的工程目录：/BO集成实例/fas/

!request.getSession().getAttribute(\"bo_EnterpriseToken\").equals(\"\"))

本文中的所有信息归远行科技有限公司所有，未经允许，不得外传 第 8 页