BPS Workspace集成方案

PRIMETON TECHNOLOGIES，LTD.上海普元信息技术有限责任公司BPS Workspace集成方案文档修订记录序号版本号修订日期修订概述修订人1 1.0 2010-11-30 创建林光华234目录1 本文目标 (4)2 集成BPS Workspace (4)2.1 前提条件 (4)2.2 集成步骤 (5)1 本文目标本文档阐述在EOS 6.2开发版的环境下将BPS Workspace集成至Portal的流程和方法，对此过程中的成功经验和遗留问题进行总结，为以后工作提供指导和依据。

2 集成BPS Workspace2.1 前提条件1.BPS 环境已正确搭建：BPS表已初始化，BPS服务器能够正常启动，能够使用BPSWorkspace；2.Portal已部署且能够正常使用，能够进行单点登录集成。

注：若Portal中集成了ABFrame ，ABFrame可能会导致BPS Process Server 不能正常启动，BPS Process Server启动后用户也不能登录BPS Workspace进行业务定制与管控，解决方案如下：（1）将ABFrame所在应用下WEB-INF\lib中的bps-api.jar替换为%EOS_HOME%\apache-tomcat-5.5.20\webapps\workspace中WEB-INF\lib下的bps-api.jar。

重新启动EOS 服务器，BPS Process Server能够正常启动。

（2）打开eosserver 下ABFrame 所在应用的work\user\org.gocom.abframe.auth\META-INF 下的contribution.eosinf 文件，修改权限校验配置中不满足校验配置两个规则的构件包为不校验（黄色背景内容）：<configV alue key="admin_users">sysadmin</configV alue><configV alue key="checked_contributions">*</configV alue><configV alue key="unchecked_contributions">com.gocom.abframe.unittest.*,com.eos.workflow.*,com.primeton.workflow.*</configV alue><!-- 不满足上述两个构件包规则的构件包默认是否使用校验，true表示校验，false表示不校验，大小写不敏感，默认值为true，为空表示true --><configV alue key="unmatch_contributions_checked">false</configV alue> 2.2 集成步骤步骤1：将sso-client-2.1.1.jar拷贝到%EOS_HOME%\apache-tomcat-5.5.20\webapps\workspace （BPS Workspace所在目录）中WEB-INF\lib下。

步骤2：开发登录用户与BPS Workspace 的user映射以及session初始化实现类。

代码如下：package com.primeton.sso.workspace.adapter;import java.util.HashMap;import java.util.Map;import javax.servlet.FilterChain;import javax.servlet.ServletRequest;import javax.servlet.ServletResponse;import javax.servlet.http.HttpServletRequest;import javax.servlet.http.HttpServletResponse;import javax.servlet.http.HttpSession;import mons.logging.Log;import mons.logging.LogFactory;import com.eos.data.datacontext.DataContextManager;import com.eos.data.datacontext.IMUODataContext;import com.eos.data.datacontext.IUserObject;import erObject;import mon.muo.MUODataContextHelper;import com.eos.workflow.api.BPSServiceClientFactory;import com.eos.workflow.api.BPSLoginManager;import edu.yale.its.tp.cas.client.IContextInit;public class WorkspaceInitContextAdapter implements IContextInit {private static final Log log =LogFactory.getLog(""+WorkspaceInitContextAdapter.class);public String getTranslatorUser(String userId) {return userId;}public void initContext(ServletRequest request, ServletResponse response, FilterChain fc, String userId) {HttpServletRequest servletRequest = (HttpServletRequest)request;HttpSession sesson= servletRequest.getSession();String sessionId = "[sessionId:" + sesson.getId() + "]";try{("[BPS Workspace][start to Login][user:"+userId+"]"+sessionId);UserObject userObject=new UserObject();userObject.setUserId(userId);if(userId==null){userObject.setUserId("guest");}BPSServiceClientFactory.getLoginManager().login(servletRequest, userId, userId);BPSServiceClientFactory.getLoginManager().setCurrentUser(userId, userId);//登陆String clientID = "eos-default";userObject.put(BPSLoginManager.WORKSPACE_CLIENT_ID, clientID );userObject.put("userType",1);loginMUO(userObject, servletRequest, (HttpServletResponse)response); //登陆}catch(Throwable e){log.error("[BPS Workspace][user loginfailure!][user:"+userId+"]"+sessionId, e);}}/***登陆*@param userObject*@param request*@param response*/public void loginMUO(UserObject userObject,HttpServletRequest request, HttpServletResponse response){com.eos.data.datacontext.DataContextManager.current().setMapContextFactory( newcom.primeton.ext.access.http.HttpMapContextFactory(request,response));com.eos.access.http.OnlineUserManager.login(userObject);if (userObject != null) {Map<Object, Object> map = new HashMap<Object, Object>();map.put(IUserObject.KEY_IN_CONTEXT, userObject);IMUODataContext muo = MUODataContextHelper.create(map);DataContextManager.current().setMUODataContext(muo);}}}步骤3：编译开发的初始化实现类，将编译后的class文件按照包的路径存放在BPS Workspace所在目录中的WEB-INF\classes下。

步骤4：修改web.xml。

打开workspace应用中WEB-INF下的web.xml文件，增加<!-- sso client config--> 相关配置，包括：Portal 应用名(eos-default)、IP地址(192.168.0.175) 和应用端口号(8080)，初始化实现类，参见黄色背景内容；SSO 应用名(sso-server_1.3)、IP 地址(192.168.0.175)和应用端口号(8080)，参见蓝色背景内容，增加的内容如下（在<display-name>之后增加）：<!-- add by lingh --><!-- sso client config (begin) --><filter><filter-name>CAS Filter</filter-name><filter-class>edu.yale.its.tp.cas.client.filter.CASFilter</filter-class><init-param><param-name>edu.yale.its.tp.cas.client.filter.loginUrl</param-name><param-value>http://192.168.0.175:8080/eos-default/cas.login</param-value></init-param><init-param><param-name>edu.yale.its.tp.cas.client.filter.validateUrl</param-name><param-value>http://192.168.0.175:8080/sso-server_1.3/serviceV alidate</param-value></init-param><init-param><param-name>edu.yale.its.tp.cas.client.filter.serverName</param-name><param-value>192.168.0.175:8080</param-value></init-param><init-param><param-name>edu.yale.its.tp.cas.client.filter.initContextClass</param-name><param-value>com.primeton.sso.workspace.adapter.WorkspaceInitContextAdapter</param-value></init-param></filter><filter-mapping><filter-name>CAS Filter</filter-name><url-pattern>*.flow</url-pattern></filter-mapping><filter-mapping><filter-name>CAS Filter</filter-name><url-pattern>*.jsp</url-pattern></filter-mapping><!-- sso client config (end) -->步骤5：在Portal中添加BPS Workspace的应用入口。