NCV61Portal技术红皮书未整理待轻量化发版.docx

1、NCV61Portal技术红皮书未整理待轻量化发版目录第一章 Portal简介 4第二章 Portal架构图 5第三章 预制Portlet 6一、 框架Portlet 61、 if_height 62、 if_src 63、 if_width 7二、 TriggerIframePortlet与MonitorIframePortlet 9三、 FreeMarkerPortelt 91、 继承Portlet 102、 编辑Portlet 10四、 任务Portlet 121、 查询任务列表 122、 获取单据类型 133、 获取任务处理URL 134、 批量任务更新 135、 显示获取字段 136

2、、 执行命令 14五、 菜单Portelt 151、 我的功能Portlet 155.1.1 绑定菜单 155.1.2 动态集成菜单 152、 浮动菜单 163、 页签Portlet 164、 OutLook导航Portlet 16第四章 Portal界面 17一、 概念 17二、 创建Portal页面 17三、 布局设计 181、 布局排序 182、 布局Icon 193.2.1 设置布局Icon 193.2.2 获取图标 193、 布局禁用 204、 布局复制粘贴 20四、 布局分配 20五、 多级布局 21六、 绑定菜单 22第五章 Portlet开发 23一、 Portlet容器 23

3、1、 获得Portlet容器 232、 使用Portlet容器 23二、 Portlet分类 25三、 Portlet视图 26四、 Portlet 资源 26五、 Portlet 动作 27六、 Portlet事件 271、 创建Portlet事件 272、 触发Portlet事件 283、 响应Portlet事件 284、 Portlet事件输出 29七、 Portlet参数 29八、 Portlet参数编辑器 30九、 Portlet权限分配 32第六章 集成 33一、 概念介绍 33二、 整体介绍 34三、 API介绍 34四、 表单集成 351、 配置系统 352、 配置属性 363

4、、 实例 36五、 LFW集成 38六、 NC6集成 39七、 NC5.7 集成 39八、 E-hr 5系列产品集成 40九、 集成开发API 401、 获取最后进入web系统的实际URL 402、 进入第三方集成系统的凭证制作 413、 返回所有第三方系统需要验证的字段定义 414、 用户登录信息校验 425、 获取集成系统指定节点的登陆URL 43十、 Portal与功能节点集成 431、 获得用户功能节点 432、 获得所有节点 443、 获得所有功能节点分类 45十一、 Portal与三方系统集成 451、 IWebAppLoginService接口的方法介绍 4511.1.1 获取最

5、后进入web系统的实际URL 4511.1.2 进入第三方集成系统的凭证制作 4611.1.3 返回所有第三方系统需要验证的字段定义 4711.1.4 用户登录信息校验 4811.1.5 获取集成系统指定节点的登陆URL 492、 集成过程 4911.2.1 实现授权类 4911.2.2 配置单点登录系统 5011.2.3 配置显示集成系统的布局 5011.2.4 配置Portlet与系统的关联 51十二、 功能节点导入 51第七章 消息 53一、 集成消息 53二、 集成第三方消息 54三、 消息分类 54四、 消息命令 56第八章 任务 56一、 集成NC流程 56二、 集成第三方流程 5

6、7第九章 主题开发 58一、 概述 58二、 页面样式 58三、 布局样式 58四、 Portlet样式 59第十章 门户高级功能 61一、 登录前后处理，指定登录后页面 61二、 登录链 61三、 CA登录 63四、 域认证 64五、 第三方登录 64六、 门户扩展点 65七、 门户设置 66八、 门户FreeMarker扩展 68九、 门户模块配置 69十、 门户部署机制 70第十一章 引用的技术文档 71第一章 Portal简介UAP Portal是基于JSR286规范而实现的一套J2EE技术体系架构的Portal。它构建于UAP平台之上，提供了灵活而丰富的个性化和管理定制功能。UAP

7、Portal允许多种安全认证方式和自选第三方系统用户来源，采取了基于角色访问控制(RBAC)的权限模型。并提供了完善和通用的第三方系统集成框架和单点登录框架，UAPPortal发版默认集成NC、IUFO、BO、自定义查询报表应用，实施SSO比商业Portal简单易用。它提供的Portal管理功能，允许管理员在运行态对Portal进行定制，而无需重启甚至编码。同时，内建的换肤机制使得实现自定义皮肤非常简单。UAP Portal提供了引入了一套开发工具,，使得Portal开发非常简单。第二章 Portal架构图第三章 预制Portlet一、 框架Portlet框架Portlet是一通用简单集成Po

8、rtlet，可用于管理员为所有用户定制内容。管理员可定制此Portlet完成对一现存站点的引入，可以定义任意数量。比如：将常用站点 引入Portal的一个页签中，只需要做下面几步： 系统管理应用平台管理门户配置布局管理中选择新建系统布局，选择框架Portlet并拖入,点击保存。 在布局管理中刷新并展开刚创建的布局,找到刚刚加入的框架portlet，设置其链接地址属性，指明url地址。对于一个布局中只有一个框架portlet的情况，设置高度为0，这样IFramePortlet的高度会自动调整来适应页面的高度，设置完成后保存。允许浏览此布局的用户注销重新登陆，即可看到此布局。 该Portlet可以

9、配置的个性化信息如下:1、 if_height说明设置ifreame的高度可选值0: 适应页面大小，撑满页面-1： 适应内容高度其它：指定像素的高度举例if_height -1 false2、 if_src说明指定ifreame 内容的url取值方式方式1：从公共参数里取(如Url传参的形式)；方式2：从属性里取；注：公共参数优先级较高举例 if_src 链接地址 false使用Url传参的形式, 举例截图如下：3、 if_width说明指定iframe 的宽度可选值百分比：如100%举例 if_width 100% false开发过程：在Portlet上点击右键，从模板新建Portlet，选

10、择IframePortlet,输入id，名称及嵌入的URL即可。在编辑器右边属性栏中可修改portlet对应的类、描述等信息。在下方模型视图中配置此portlet的具体属性。二、 TriggerIframePortlet与MonitorIframePortletTriggerIframePortlet是可以触发switchIframeContentEvent事件的框架Portlet，它继承自框架Portlet。该portlet会触发switchIframeContentEvent事件，监听switchIframeContentEvent的portlet会响应该事件。常见的监听Portlet有M

11、onitorIFramePortlet及其子类。使用举例：通过该portlet可以设置响应switchIframeContentEvent事件的url。示例代码如下：document.getContainer().doAction(url)MonitorIframePortlet是监听switchIframeContentEvent事件的IframePortlet, 常与TriggerIframePortlet共同使用。当是自定义触发的Portlet时应将switchIframeContentEvent加入support-publish-event，不建议在一个Page中引用两个Monitor

12、IframePortlet。三、 FreeMarkerPortelt套用FreeMarker模板的Portlet，该portlet主要用于解析FTL文件路径并把ftl文件内容渲染成Html。开发过程:1、 继承Portlet创建一个类继承自FreeMarkerPortlet,代码示例如：package nc.test Public class MyFunctionPortlet extends FreeMarkerPortlet Overrideprotected void doView(RenderRequest request, RenderResponse response) throw

13、s PortletException, IOException Map root = new HashMap(); root.put(WINDOW_ID, request.getWindowID(); print(renderHtml(root), response);再在该类所在包(nc.test)下创建一个同名的ftl文件FreeMarkerPortlet.ftl窗口ID:$ WINDOW_ID 2、 编辑Portlet在Portlets节点上点击鼠标右键，可新建portlet分类或直接新建portlet。输入Portlet的id及name，点击OK按钮。新建并打开portlet编辑器。在

14、编辑器右边属性栏中可修改portlet对应的类设置为刚才新建的类nc.test. FreeMarkerPortlet即可。四、 任务Portlet任务portlet主要包括任务列表的查询、单据类型、任务处理的URL、显示字段的获取、和指令的执行。1、 查询任务列表查询任务列表/* * 查询任务列表. */ WfmTaskVO qryTaskList(TaskQryParam param, PaginationInfo pinfo);参数说明：param 任务查询参数，包括状态、系统、单据类型、关键字、当前用户等。Pinfo：分页信息返回：任务列表2、 获取单据类型获得单据类型/* 获得单据类型

15、*/WfmFlwTypeVO getBillTypes();3、 获取任务处理URL获得任务处理的URL/* 获得任务处理URL*/ TaskProcessUI getTaskProcessUrl(String pk_task);参数说明：pk_task 任务的主键返回：任务UI界面4、 批量任务更新批量任务更新/* 批量任务执行*/String doMutiTaskProcess(String pk_task);通过多个任务的id进行多个任务更新操作。5、 显示获取字段显示字段的获取/* 获取显示的字段*/Map getVisableColumn(String billtype);通过单据类

16、型查询需要显示的字段。6、 执行命令执行命令/* 执行命令*/void doCmd(String cmd, String pk);根据不同的指令走相应的url，如根据是“便签”或是“催办”，分别执行“/portal/pt/task/scratchpad”和“/portal/app/mockapp/urgencyView”的链接。示例代码如下：Overridepublic void doCmd(String cmd, String pk) if(scratchpad.equals(cmd) String url = /portal/pt/task/scratchpad?id= + pk; App

17、LifeCycleContext.current().getApplicationContext().showModalDialog(url, 便签, 480, 320, isurgency, ); if(isurgency.equals(cmd) String url = /portal/app/mockapp/urgencyView?pk= + pk; AppLifeCycleContext.current().getApplicationContext().showModalDialog(url, 催办, 480, 320, isurgency, ); 五、 菜单Portelt1、 我的

18、功能Portlet该portlet主要功能是显示菜单组 ，分为绑定菜单和动态集成菜单。5.1.1 绑定菜单绑定菜单即为布局绑定一个菜单，有“系统管理”权限的用户登录，在“门户配置”的“布局管理”模块，选择一个布局，点击“高级设置”即可打开布局菜单绑定页面，选择一个“绑定连接组”即可完成菜单绑定，示意图如下：5.1.2 动态集成菜单动态集成菜单主要是通过虚菜单接口在页面的绑定，具体实现类去完成菜单的动态的生成。如NC系统的消息通过虚菜单的实现进行动态抓取，并在我的功能区进行显示。虚菜单接口IVirtualMenuProvider说明如下：List getMenuItems();获取菜单项Inte

19、ger getStat();消息状态数目2、 浮动菜单浮动菜单Portlet主要是显示界面上Portal页面绑定的菜单.开发方式:1).系统管理 应用平台管理 门户配置布局管理中打开布局设计器.拖放一个浮动菜单Portlet.选中该Portlet.设置样式为浮动. 2).选中步骤1创建的布局.点高级设置.选择一个绑定菜单.3、 页签Portlet 页签Portlet是门户提供的一种菜单展现样式.以Tab页的形式来展示菜单的内容.开发方式:1).系统管理 应用平台管理 门户配置布局管理中打开布局设计器.拖放一个页签Portlet.2).展开步骤1创建的布局,选择页签Portlet.点高级设置.选

20、择一个菜单.页签Portlet可以设置高度宽度4、 OutLook导航PortletOutlook导航Portlet是门户提供的一种菜单展现样式.以OutLook导航的形式来展示菜单的内容。开发方式:1).系统管理 应用平台管理 门户配置布局管理中打开布局设计器.拖放一个OutLook导航Portlet.2)拖入一个布局, 选中,点击样式下拉框,选择”框架布局”并保存3).展开步骤1创建的布局,选择页签Portlet.点高级设置.选择一个菜单.也可以在此设置OutLook导航Portlet的高度与宽度注意:为了实现在页签内打开OutLook导航Portlet选中的菜单项,需要在当前页面中的一个

21、布局样式设置为框架布局.该布局与正常布局一样,可以容纳Portlet.但是在收到OutLook的请求时会将布局内容切换到菜单项界面.第四章 Portal界面一、 概念UAP Portal 使用Pml界面组件结构标记语言对页面进行描述。Pml 包括布局(Layout)对象及Portlet对象。布局可嵌套布局和Portlet，从而组成相对复杂的界面。一个页面中的portlet不能重复。二、 创建Portal页面在“Portal页面”节点上点击鼠标右键新建page页面。输入id 及 tilte，点击ok按钮，新建Page完成，并打开page编辑器。在page编辑器中进行page布局配置。三、 布局设

22、计1、 布局排序布局排序是指在布局列表中“是否主页”的那一列，是主页的分组会按照优先级排序，不是主页的分组也会按照优先级进行排序。示意图如下：2、 布局Icon3.2.1 设置布局Icon布局Icon是为已创建的布局设置绑定的图标，示意图如下：3.2.2 获取图标通过步骤1设定好布局的菜单和图标后，可以通过导航栏菜单项获取其图标。示意代码如下：示意代码如下：获取页签Page myPages = PortalPageDataWrap.getUserPages();PageMenu menu = PortalPageDataWrap.getUserMenu(myPages);Map root =

23、new HashMap();Root.put(“USER_MENU”,MENU);Ftl文件获取图标3、 布局禁用布局禁用是停止用户使用该布局，通过“布局管理”的“高级设置”，把“是否启用”开关关闭即可。示意图如下：4、 布局复制粘贴布局的复制和粘贴是方便布局快速高效的重用，通过选中要重用的布局点击“复制”按钮即可获得该布局的一份拷贝，选择要放入的组织后点击“粘贴”按钮即可把拷贝的布局复制到目标组织下。示意图如下：四、 布局分配布局分配是指为新建的布局或已分配的布局分配使用的对象，这些对象包括角色、用户、组织等。同时分配过的也可以取消分配，即停止上述对象使用该布局。示意图如下：五、 多级布局多

24、级布局包括：支持全局下的布局分配的对象为所有组织；布局分配时可以分配给当前组织下的子组织或子组织下的用户或角色。示意图如下：六、 绑定菜单绑定菜单是为布局设置菜单，设置菜单后可以直接通过菜单使用该布局，绑定示意图如下：第五章 Portlet开发一、 Portlet容器1、 获得Portlet容器场景1 ： JSP页面中getContainer(#);场景2 ： Iframe Portlet页面中document.getContainer();注意：1)在Iframe中获得容器，必须保证iframe页面与Portal 在同一个域下2)要判断Iframe中是否已经注入了此函数2、 使用Portle

25、t容器Portlet容器提供的函数方法参数名称是否必须参数作用返回值备注createPart*title是标题新创建的链接块在Portlet窗口上创建一个链接块href是链接createSep*segment否分隔符新创建的块在Portlet窗口上创建一个分割块createBlankPart*-新创建的块在Portlet窗口上创建一个空白块setTitle*title是标题标题对象设置标题setContent*content是内容内容对象设置内容setExposed*-当前容器隐藏外框setUnExposed*-当前容器恢复外框doMax*-窗口最大化doReSize*-窗口复原showTip

26、s*-显示提示框hideTips*隐藏提示框doView-切换到查看模式doEdit-切换到编辑模式doHelp-切换到帮助模式doRefreshtimesamp是时间间隔-设置刷Portlet新周期doAction-调用Portlet默认事件ProcessActiondoActionframeUrl是链接地址-调用Portlet默认的事件,并传递一个frameUrl参数doActionname是事件名称-调用指定的Portlet动作param是参数列表getOuter-最外层的布局获得最外层的布局getRow-所在列获得所在的列注:标有*号的方法可以重载二、 Portlet分类Portlet

27、分类是为了让Portlet更容易查找，在Portlets节点上点击鼠标右键选择“新建Portlet分类”，弹出新建Portlet分类对话框。输入ID、text、i18nName后点击OK按钮，Portlet分类创建成功。在建好的Portlet分类上点击鼠标右键。可以在分类中新建Portlet,或编辑、删除当前分类。三、 Portlet视图UAP Portal 6.0支持 “查看”、“编辑”、“帮助” 三种标准视图，有关视图的信息，请参考JSR286规范。UAP Portal 6.0 支持 “最大化”、“正常”、“最小化” 三种模式，有关模式的信息，请参考JSR286规范。四、 Portlet 资源UAP Portal 6.0 支持Portlet资源请求，详细信息请参考JSR286规范。示例代码:/使用Tag获取资源img src=五、 Portlet 动作Portlet动作是Portlet