《Portal技术红皮书.doc》由会员分享，可在线阅读，更多相关《Portal技术红皮书.doc（41页珍藏版）》请在金锄头文库上搜索。
1、Portal技术红皮书NC-UAP 5.0用友NC-UAP2007-12-041第 页目 录第一章前言11.什么是Portal1Portal从本质上来说就是一个内容聚集的平台。12.NC Portal的简介13本版新增特性14.本手册针对用户群2第二章NC Portal容器31.NC Portal框架图32.NC Portal的界面用语33.NC Portal页面展现序列图44.NC Portal结构45.Portal及Portlet的国际化5第三章 NC Portal的安装与配置6第三章现有Portlet的使用 及新Portlet开发81.Portlet的介绍82.NC Portal的内置P
2、ortlet82.1Portal管理Portlet82.2CMS管理Portlet82.3IFramePortlet83.Portlet的开发实例93.1基于JSP视图技术的 Portlet的开发103.2基于Spring MVC框架的Portlet开发123.3如何利用Ajax163.4如何利用IFramePortlet进行简单第三方系统集成16第四章选择合适的登录方式及用户来源181.整体概述182.用户来源183.用户认证方式及配置21第五章单点登录及系统集成251.概念介绍252.整体介绍273.API介绍284.开发流程294.1IWebAppLoginService接口的方法介绍3
3、04.2系统开发过程315.集成实例附录365.1与IUFO的集成365.2与BO的集成37第六章Portal主题开发38附录381.引用的技术文档38第 10 页第一章 前言1. 什么是Portal许多企业和组织需要为企业内部员工、外部客户群体量身定制有“价值”的企业信息，但是，一方面是好些有“价值”的企业信息获取并不是一件轻松的事情，信息部门需要整合来自不同的应用系统，不同数据源，不同平台的无数各种类型的数据和资源；另一方面，如何轻松实现一个为所有的用户群体量身定制的系统构架也不是一件容易的事情。传统技术整合这些资源的技术复杂度和成本都太高，许多企业无法负担如此的投入。Portal 技术的
4、出现，带给人们解决这类难题的曙光。Portal技术强调以用户为中心，提供个性化、单点登录、不同来源的内容整合功能，从而实现了信息的集中访问。Portal从本质上来说就是一个内容聚集的平台。2. NC Portal的简介NC Portal是基于JSR168规范而实现的一套J2EE技术体系架构的Portal。它构建于NC基础服务与NC Web Frame基础Web框架之上，完美融合ajax技术与Spring MVC技术，提供了灵活而丰富的个性化和管理定制功能。NC Portal允许多种安全认证方式和自选第三方系统用户来源，采取了基于角色访问控制(RBAC)的权限模型。并提供了完善和通用的第三方系统
5、集成框架和单点登录框架，NCPortal与NC ERP紧密集成，发版默认集成NC、IUFO、BO等应用，并支持C/S程序集成。实施SSO比商业Portal简单易用。它提供的Portal管理功能，允许管理员在运行态对Portal进行定制，而无需重启甚至编码。同时，内建的换肤机制使得实现自定义皮肤非常简单，只需完成相应图片的替换即可。NC Portal引入了一些通用的API，使得Portlet可轻松调用Ajax，以及使用NC RichClient组件。3本版新增特性3.1 与NC ERP更加紧密、稳定集成3.2 增加Portal中打开NC任意节点Portlet，并支持管理员定制和用户个性化定制3.
6、3 增加Portal对CS客户端程序集成Portlet。3.4 完善IUFO报表列表Portlet。3.5 完善对NC查询引擎报表的支持。3.6 增加NC代办事务Portlet。3.7 基于UAP LFW开发框架，将Portal管理部分完全重写。管理更直观、方便。3.8 提高了整个页面的渲染速度4.本手册针对用户群本手册主要面向二次开发和实施人员，内容涵盖基于NC Portal的二次开发，第三方应用集成，Portal的安装配置，及基于现有Portal内置功能进行快速定制等方面。如果需要更详细的使用信息，请参考相应用户使用手册。相关参考文档：第二章 NC Portal容器1. NC Portal
7、框架图2. NC Portal的界面用语在NC Portal中，每一个Tab控件页签对应着一个布局定义。布局即一个tab页内容的描述，它由多个列构成，每个列又由Portlets组成。布局可由管理员动态定制，并可在运行时修改。布局可嵌套布局，从而组成相对复杂的界面。一个布局中的portlet不能重复。布局和Portlet的访问控制，是由基于角色的权限控制模型定义的。因此，管理员可在运行时，通过Portal管理Portlet，对各种资源进行安全管理。3. NC Portal页面展现序列图在NC Portal中，Portlet的展现是一个异步的过程。因此一定要注意多个ajax异步请求操作潜在的对se
8、ssion的并发访问问题。同时，NC Portal也提供了对Portlet内容的缓存方案（兼容JSR168规范），可设置全局缓存（针对所有用户一致的内容），按用户缓存（不同用户看到不同的内容），及细粒度的按状态缓存（比如只缓存视图状态而不缓存编辑状态）。部署Portlet时可按照需要设置缓存，从而有效提高页面展现速度，减少对服务器端的压力。（本版已经默认进行了细粒度缓存，不推荐继续使用）4. NC Portal结构新版NC Portal构建于uapweb基础服务之上，安装portal需要已经安装lfw web应用。同时，新版NC Portal支持改变context名称。比如要将 http:/l
9、ocalhost/portal改变为http:/localhost/p 只需要重新命名hotwebs目录下的portal目录名称为p即可。新版NC Portal基础组件和服务来自于lfw应用，本身的代码进行了大面积的删减和优化。稳定性增强，二次开发难度相应降低。5. Portal及Portlet的国际化Portal容器及内置Portlet的多语化是基于NC的多语机制，并符合JSR168规范。二次开发的Portlet需参照规范的方式实现自定义ResourceBundle，或者直接使用NC Portal的通用多语言资源绑定类，SpringResourceBundle(推荐)。有关NC的国际化机制请
10、参考相应的文档。这里需要提出的是，NC Portal针对JSP页面，封装了简单的多语化EL表达式，可直接在页面中调用 $ml:trans(key to translate)即可，java类中可直接调用LanguageUtil工具类中的相应方法进行。第三章 NC Portal的安装与配置1NC Portal安装NC Portal是作为NC的一个模块安装。它使用NC中定义的数据源，并且通过NC帐套初始化方式初始化数据源。NC Portal本身是不需要帐套的，同时也建议为Portal单独定义一个数据源，数据源名称可任意，只需在配置Portal时指明使用此数据源即可。可在建立一个NC帐套并对对应Por
11、tal数据源初始化之后，将帐套删除。安装好NC Portal模块之后，使用NC_HOME/bin下的ncSysConfig.bat配置工具，和其它模块一样，配置数据源并部署之后，点击功能列表的Portal标签。 点击Portal功能点的Portal子页签，然后点击读取。内容如下：数据源：请选择配置给NC Portal用的实际数据源名称主题和配色方案：选择Portal内置主题和配色方案新加用户默认密码：此选项指明管理员新增用户时默认设置的密码。*存放位置：各部分附件和图片对应的上传位置。如果在配置并使用之后要更改存放目录，则需要在此工具中先指明新的位置，并将旧的文件移动到新目录中，并重启应用服务
12、器即可。新用户缺省角色名：如果一个用户没有任何角色，分配给他的默认角色，可以为空。注意：PORTAL_USER并不是默认实际存在的角色，需要在portal后台管理中的角色管理中添加此角色。是否启用随机码：如果启用，则在Portal登录页面中将出现随即验证数字。是否在用户除此登录时强制修改密码：选中此项，将强制用户在登陆portal后修改一次密码，即使不修改并关闭浏览器，下次登录仍然会强制修改。PortalSSO页签用来配置各个被集成系统信息，目前包含NC ERP，IUFO，BO，具体请参考Portal单点登录与系统集成章节相关配置。在各个选项配置完毕之后，启动应用服务器，配置帐套并初始化Por
13、tal数据源，如果帐套不再使用，可删除。重启应用服务器，以http:/ip地址:端口/portal访问portal。NC Portal默认提供了admin/admin用户进行初始管理。NC Portal各种管理选项，请参考NC Poral用户手册2从旧版本升级NC Portal502相比其它版本Portal的库表结构发生了一些变化，如果需要进行旧版本升级。只需要启动NC应用服务器（在此之前确认数据源等各项配置配置正确），并输入http:/localhost/portal/upgrade即可。按照提示点击“升级”，完成库结构和数据存储方式的升级，如果发生异常请查看nclog下的portal日志，
14、里面记录了详细的升级失败的原因。第三章 现有Portlet的使用及新Portlet开发1. Portlet的介绍一个Portlet就是一个独立的web应用。它通过Portlet容器与Portal服务打交道。从本质上来说，它是一个网页内容片段，众多portlet通过portal页面组织在一起而形成一个完整的页面。因此，只要符合JSR168规范，这个Portlet就可以享受到所有符合此规范的Portal容器所带来的服务与功能。对于一个Portlet，区分为多种状态(state)和多种模式(mode)。在NC Portal中，支持Portlet的最大化(Maximized)，最小化(Mininized)和正常(Normal)状态，以及支持视图(View),编辑(Edit)和帮助(Help)三种视图模式。一个Portlet所拥有的模式和状态是通过配置而从这里面选取的子集。完整的Portlet的定义请参阅JSR168规范的文档。2. NC Portal的内置Portlet2.1 Portal管理PortletPortal管理Portlet提供了Portal容器的管理功能。包括用户管理，角色管理，资源管理，Portlet管理，布局定义等功能节点。此Portlet在NC轻量级开发框架基础上开发，使NC Portal可在运
