金蝶BOS企业版V632_开发指南_管理门户_Portlet开发

EAS门户Portlet制作指南说明本指南主要介绍EAS门户Portlet的制作过程。简要阐述了EAS门户的新特性，详细介绍了制作Portlet的过程和步骤，对制作Portlet过程遇到的常见问题进行了说明。本指南适用于EAS门户Portlet开发人员。目录说明.........................................................................................................................................2目录.........................................................................................................................................3第1章EAS门户简介............................................................................................................41.1EAS门户新特性..................................................................................................................4第2章Portlet制作...............................................................................................................52.1Portlet制作步骤.................................................................................................................52.2配置Portlet信息...............................................................................................................52.2.1配置Portlet定义信息............................................................................................52.2.2配置Portlet业务处理信息....................................................................................62.3向数据库插入相关数据....................................................................................................62.4Portlet配置信息与数据库数据的对应关系.....................................................................82.5制作Portlet内容页面，实现业务需求...........................................................................92.5.1Portlet内容页面JSP接口.....................................................................................102.5.2Portlet内容页面JS接口.......................................................................................132.5.3Portlet内容页面制作规范与约束........................................................................162.5.4Portlet内容页面制作常见问题............................................................................192.5.5Portlet内容页面HTC控件的替换.......................................................................232.5.6门户优化合并且删除了部分js...........................................................................25第3章Portlet业务设置.....................................................................................................273.1关联Portlet业务设置页面.............................................................................................283.2Portlet业务设置页面JSP接口........................................................................................293.3Portlet业务设置页面JS接口..........................................................................................30第4章Portlet的使用.........................................................................................................32第5章Portlet相关SQL脚本的导出和提交.....................................................................355.1示例SQL..........................................................................................................................355.2脚本提交位置..................................................................................................................36附录1Portal配置文件拆分说明.........................................................................................38附录2PortletUtilAPI............................................................................................................42附录3Ajax之Buffalo开发指南..........................................................................................54附录4门户Portlet之间通信...............................................................................................59第1章EAS门户简介1.1EAS门户新特性新的EAS门户在上一版本门户的基础上对整体框架进行了优化，实现了相关新特性，包含如下功能：（1）自定义布局：可自由布局，跨列布局；（2）页签配置完善：以拖拽方式把Portlet配置到页签上；（3）展现框架调整：可自由拖拽布局显示，运行期用户可个性化配置界面展示样式；（4）提供容器Portlet：将多个单一Portlet组合成一个Portlet；（5）Portlet增加属性设置：支持系统级和业务级属性设置，且同时支持定义期和运行期属性设置；（6）Portlet异步加载：页签中每个Portlet异步加载，并发运行；（7）通知和待办可分类设置和授权：分类可由管理员统一建立和分配，同时允许用户自定义分类和管理管理员设置的分类。第2章Portlet制作2.1Portlet制作步骤Portlet制作过程包含以下几个步骤：（1）配置Portlet信息（2）向数据库插入相关数据（3）制作Portlet内容页面，实现业务需求（4）制作Portlet业务设置页面（可选）最后一个步骤并不是必须的，在Portlet的业务需求需要业务设置时，才进行此步骤。下面将分小节详细介绍Portlet制作的各个步骤，关于Portlet业务设置的内容将单独在第3章中介绍。2.2配置Portlet信息2.2.1配置Portlet定义信息（1）配置文件路径EAS5.4版本：server/profiles/server1/config/portalConfig/portlets.xmlEAS6.0版本：server/deploy/eas.ear/cp_web.war/WEB-INF/portlets_xxx.xml其中，xxx表示具体的业务领域名称，如bos、eas等，详细信息请参考“附录1Portal配置文件拆分说明”（2）配置说明portletportletID1001/portletIDtitletestPortlet/titlemodesmodenameview/namevalueportlet.test/value/mode/modes/portlet各配置参数值说明如下：1001：Portlet定义ID，全局唯一，不能重复。取值范围具体约定如下：BOS为1-199，EAS为200-999，二次开发为1000以后；testPortlet：Portlet定义信息，无特别要求，一般使用英文字符标识。注意该标题信息仅用于在配置文件中区分不同的Portlet，与Portlet在运行时显示的标题无关，Portlet在运行时显示的标题信息由数据库中的内容决定，2.3小节有详细说明；portlet.test：对应于“Portlet业务处理信息”的配置信息，具体见下一小节。2.2.2配置Portlet业务处理信息（1）配置文件路径server/deploy/eas.ear/cp_web.war/WEB-INF/tiles-defs_xxx.xml其中，xxx表示具体的业务领域名称，如bos、eas等，详细信息请参考2.2.1节中的附件《Portal配置文件拆分说明.doc》。（2）配置说明definitionname=portlet.testextends=portlet_default_eas50controllerUrl=/PortletAssembleAction.doputname=portlet